docs: publish documentation site

Author: sirrobot01

docs/.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

docs/README.md

@@ -0,0 +1,224 @@
+# MCPulse Documentation
+
+This directory contains the source for the MCPulse documentation website, built with [Docusaurus](https://docusaurus.io/).
+
+## Development
+
+### Prerequisites
+
+- Node.js 18+
+- npm or yarn
+
+### Installation
+
+```bash
+cd docs
+npm install
+```
+
+### Local Development
+
+```bash
+npm start
+```
+
+This command starts a local development server and opens a browser window. Most changes are reflected live without having to restart the server.
+
+### Build
+
+```bash
+npm run build
+```
+
+This command generates static content into the `build` directory that can be served using any static hosting service.
+
+### Deployment
+
+The documentation is automatically deployed to GitHub Pages when changes are pushed to the `main` branch.
+
+Manual deployment:
+
+```bash
+npm run deploy
+```
+
+## Structure
+
+```
+docs/
+├── docs/                    # Documentation content
+│   ├── intro.md            # Introduction page
+│   ├── installation.md     # Installation guide
+│   ├── getting-started.md  # Getting started guide
+│   ├── configuration.md    # Configuration reference
+│   ├── architecture.md     # Architecture overview
+│   ├── api/                # API reference
+│   │   └── rest-api.md
+│   ├── sdks/               # SDK documentation
+│   │   ├── overview.md
+│   │   └── python.md
+│   └── deployment/         # Deployment guides
+│       └── overview.md
+├── src/                    # React components
+│   ├── css/               # Custom CSS
+│   │   └── custom.css
+│   └── pages/             # Custom pages
+│       ├── index.tsx      # Homepage
+│       └── index.module.css
+├── static/                # Static files
+│   ├── img/              # Images
+│   └── CNAME             # Custom domain config
+├── docusaurus.config.ts  # Site configuration
+├── sidebars.ts           # Sidebar navigation
+└── package.json          # Dependencies
+
+```
+
+## Adding Documentation
+
+### New Page
+
+1. Create a Markdown file in `docs/`:
+   ```bash
+   touch docs/my-new-page.md
+   ```
+
+2. Add frontmatter:
+   ```markdown
+   ---
+   sidebar_position: 5
+   ---
+
+   # My New Page
+
+   Content here...
+   ```
+
+3. The page will automatically appear in the sidebar.
+
+### New Section
+
+1. Create a directory:
+   ```bash
+   mkdir docs/my-section
+   ```
+
+2. Add an overview page:
+   ```bash
+   touch docs/my-section/overview.md
+   ```
+
+3. Update `sidebars.ts` to add the section.
+
+### Images
+
+Add images to `static/img/`:
+
+```markdown
+![Alt text](/img/my-image.png)
+```
+
+## Styling
+
+Custom styles are in `src/css/custom.css`. The theme uses:
+
+- **Primary Color**: Teal (#0d9488)
+- **Font**: Inter, system fonts
+- **Code Font**: JetBrains Mono, Fira Code
+
+## Components
+
+### Code Blocks
+
+```markdown
+\`\`\`python
+def hello():
+    print("Hello, world!")
+\`\`\`
+```
+
+### Admonitions
+
+```markdown
+:::note
+This is a note
+:::
+
+:::tip
+This is a tip
+:::
+
+:::info
+This is info
+:::
+
+:::warning
+This is a warning
+:::
+
+:::danger
+This is danger
+:::
+```
+
+### Tabs
+
+```markdown
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+<Tabs>
+  <TabItem value="python" label="Python">
+    Python code here
+  </TabItem>
+  <TabItem value="go" label="Go">
+    Go code here
+  </TabItem>
+</Tabs>
+```
+
+## Best Practices
+
+1. **Clear headings** - Use descriptive, hierarchical headings
+2. **Code examples** - Include working code examples
+3. **Screenshots** - Add screenshots for UI features
+4. **Links** - Use relative links for internal navigation
+5. **Versioning** - Update version numbers when APIs change
+
+## Deployment
+
+The site is deployed to GitHub Pages at `https://docs.mcpulse.io`.
+
+### GitHub Actions
+
+Deployment is automated via GitHub Actions. The workflow:
+
+1. Builds the documentation
+2. Deploys to `gh-pages` branch
+3. Available at the custom domain
+
+### Custom Domain
+
+Configure in `static/CNAME`:
+```
+docs.mcpulse.io
+```
+
+## Contributing
+
+Contributions are welcome! To contribute:
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Test locally with `npm start`
+5. Submit a pull request
+
+## Support
+
+- **Issues**: [GitHub Issues](https://github.com/sirrobot01/mcpulse/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/sirrobot01/mcpulse/discussions)
+
+## License
+
+Same as the main MCPulse project - see [LICENSE](../LICENSE).