Initial commit: Barodoc documentation framework

- @barodoc/core: Astro integration and config loader
- @barodoc/theme-docs: Documentation theme with MDX components
- barodoc CLI: serve, build, preview, create commands
- Plugin system: sitemap, search, analytics plugins
- Full i18n support with multiple locales
- Skills documentation for AI assistance

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: easylogic

.changeset/config.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.0.0/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [
+    ["@barodoc/core", "@barodoc/theme-docs"]
+  ],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

.cursor/rules/components.mdc

@@ -0,0 +1,62 @@
+# Component Usage Rules
+
+## Astro Components (.astro)
+- Use for static content
+- Props defined in frontmatter script
+- No client-side JavaScript by default
+
+## React Components (.tsx)
+- Use for interactive content
+- Must use `client:load` directive in Astro files:
+
+```astro
+<MyComponent client:load />
+```
+
+## MDX Components
+
+### Callout
+```mdx
+<Callout type="info" title="Optional Title">
+Content here
+</Callout>
+```
+
+### Card & CardGroup
+```mdx
+<CardGroup cols={2}>
+  <Card title="Title" icon="🚀" href="/link">
+    Description
+  </Card>
+</CardGroup>
+```
+
+### Steps
+```mdx
+<Steps>
+  <Step title="Step 1">
+    Instructions
+  </Step>
+</Steps>
+```
+
+## API Components
+
+### ApiEndpoint
+```mdx
+<ApiEndpoint method="GET" path="/api/endpoint" description="Description">
+  <ApiParams>
+    <ApiParam name="param" type="string" required description="Param desc" />
+  </ApiParams>
+  <ApiResponse status={200} description="Success">
+    ```json
+    { "result": "value" }
+    ```
+  </ApiResponse>
+</ApiEndpoint>
+```
+
+## Styling
+- Use Tailwind classes
+- Custom component styling in global.css with @layer components
+- Use CSS custom properties for theme colors

.cursor/rules/config.mdc

@@ -0,0 +1,54 @@
+# Configuration Rules
+
+## barodoc.config.json
+
+### Required Fields
+- `name`: Site name displayed in header
+- `navigation`: Array of navigation groups
+
+### Optional Fields
+- `logo`: Path to logo SVG/PNG in public/
+- `favicon`: Path to favicon
+- `colors.primary`: Primary color hex code
+- `topbar.github`: GitHub repository URL
+
+### Navigation Structure
+```json
+{
+  "navigation": [
+    {
+      "group": "Group Name",
+      "pages": ["page1", "nested/page2"]
+    }
+  ]
+}
+```
+
+Page slugs map to `src/content/docs/{slug}.mdx`
+
+## astro.config.mjs
+
+### Key Settings
+- `site`: Production URL for sitemap/canonical URLs
+- `base`: Base path for subdirectory deployment
+
+### For GitHub Pages with Custom Domain
+```javascript
+export default defineConfig({
+  site: "https://docs.example.com",
+  base: "/",
+});
+```
+
+### For GitHub Pages (username.github.io/repo)
+```javascript
+export default defineConfig({
+  site: "https://username.github.io",
+  base: "/repo-name/",
+});
+```
+
+## Adding New Pages
+1. Create MDX file in `src/content/docs/`
+2. Add slug to `barodoc.config.json` navigation
+3. File path determines URL: `guides/setup.mdx` → `/docs/guides/setup`

.cursor/rules/docs.mdc

@@ -0,0 +1,65 @@
+# Documentation Writing Rules
+
+## File Location
+- All documentation files go in `src/content/docs/`
+- Use subdirectories for organization: `guides/`, `components/`, `api/`
+
+## MDX Frontmatter
+Every MDX file must have frontmatter:
+
+```mdx
+---
+title: "Page Title"
+description: "Brief page description"
+---
+```
+
+## Component Imports
+Import components at the top of the file, after frontmatter:
+
+```mdx
+---
+title: "Title"
+---
+
+import Callout from "@/components/mdx/Callout.astro";
+import Card from "@/components/mdx/Card.astro";
+```
+
+## Callout Types
+- `info` - General information
+- `tip` - Helpful tips
+- `warning` - Warnings, caveats
+- `danger` - Critical warnings, breaking changes
+
+## Code Blocks
+- Always specify the language
+- Use CodeGroup for multi-language examples:
+
+```mdx
+<CodeGroup titles={["JavaScript", "TypeScript"]}>
+```javascript
+const x = 1;
+```
+
+```typescript
+const x: number = 1;
+```
+</CodeGroup>
+```
+
+## Navigation
+After creating a page, add it to `barodoc.config.json`:
+
+```json
+{
+  "navigation": [
+    {
+      "group": "Group Name",
+      "pages": ["page-slug"]
+    }
+  ]
+}
+```
+
+Page slug = file path without `.mdx` extension, relative to `src/content/docs/`