feat: Initial LUMOS documentation site with Astro Starlight

- Set up Astro Starlight with LUMOS branding (purple/gold theme)
- Created custom logo with illuminated rays design
- Added custom CSS with LUMOS color palette and styling
- Built documentation structure:
  - Getting Started (Introduction, Installation, Quick Start)
  - Guides (Type Mapping, Anchor Integration, Enum Support)
  - API Reference (CLI, Parser, Generators)
  - Examples (Gaming, NFT, DeFi, DAO, Token Vesting)
- Homepage with hero section and feature cards
- Configured for deployment to docs.lumos-lang.com

Technology stack:
- Astro Starlight (documentation framework)
- Custom theme with purple (#9333EA) and gold (#FACC15)
- Responsive design with dark mode
- Zero vulnerabilities (367 packages audited)

Author: rz1989s

README.md

@@ -1,49 +1,100 @@
-# Starlight Starter Kit: Basics
+# LUMOS Documentation
 
-[![Built with Starlight](https://astro.badg.es/v2/built-with-starlight/tiny.svg)](https://starlight.astro.build)
+Official documentation website for [LUMOS](https://github.com/getlumos/lumos) - Type-safe schema language for Solana development.
 
-```
-npm create astro@latest -- --template starlight
-```
+**Live Site:** https://docs.lumos-lang.com
+
+Built with [Astro Starlight](https://starlight.astro.build)
 
-> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
+---
 
-## 🚀 Project Structure
+## 🚀 Quick Start
 
-Inside of your Astro + Starlight project, you'll see the following folders and files:
+```bash
+# Install dependencies
+npm install
 
+# Start dev server
+npm run dev
+# Opens http://localhost:4321
+
+# Build for production
+npm run build
+
+# Preview production build
+npm run preview
 ```
-.
-├── public/
+
+---
+
+## 📁 Structure
+
+```
+docs-lumos/
 ├── src/
-│   ├── assets/
 │   ├── content/
 │   │   └── docs/
-│   └── content.config.ts
-├── astro.config.mjs
-├── package.json
-└── tsconfig.json
+│   │       ├── getting-started/    # Installation, Quick Start
+│   │       ├── guides/             # Type Mapping, Anchor Integration
+│   │       ├── api/                # CLI, Parser, Generators
+│   │       └── examples/           # Real-world schemas
+│   ├── assets/                     # Logo, images
+│   └── styles/
+│       └── custom.css              # LUMOS branding (purple/gold)
+├── astro.config.mjs                # Starlight configuration
+└── package.json
 ```
 
-Starlight looks for `.md` or `.mdx` files in the `src/content/docs/` directory. Each file is exposed as a route based on its file name.
+---
+
+## 🎨 Branding
+
+LUMOS uses a **purple & gold** color theme:
+
+- **Primary:** `#9333EA` (Purple-600)
+- **Accent:** `#FACC15` (Gold-400)
+- **Background:** `#0F172A` (Dark slate)
+
+Custom styles in `src/styles/custom.css`.
+
+---
+
+## 🛠️ Technology Stack
+
+- **[Astro Starlight](https://starlight.astro.build/)** - Documentation framework
+- **[Astro](https://astro.build/)** - Static site generator
+- **Deployed on:** Vercel
+
+---
+
+## 📝 Contributing
+
+1. Fork the repo
+2. Create a feature branch
+3. Make your changes
+4. Test locally with `npm run dev`
+5. Submit a pull request
+
+**Documentation Guidelines:**
+- Use clear, concise language
+- Include code examples
+- Test all links
+- Follow existing structure
+
+---
 
-Images can be added to `src/assets/` and embedded in Markdown with a relative link.
+## 🔗 Related Repos
 
-Static assets, like favicons, can be placed in the `public/` directory.
+- [**lumos**](https://github.com/getlumos/lumos) - Main repository (core + CLI)
+- [**vscode-lumos**](https://github.com/getlumos/vscode-lumos) - VSCode extension
+- [**awesome-lumos**](https://github.com/getlumos/awesome-lumos) - Community examples
 
-## 🧞 Commands
+---
 
-All commands are run from the root of the project, from a terminal:
+## 📄 License
 
-| Command                   | Action                                           |
-| :------------------------ | :----------------------------------------------- |
-| `npm install`             | Installs dependencies                            |
-| `npm run dev`             | Starts local dev server at `localhost:4321`      |
-| `npm run build`           | Build your production site to `./dist/`          |
-| `npm run preview`         | Preview your build locally, before deploying     |
-| `npm run astro ...`       | Run CLI commands like `astro add`, `astro check` |
-| `npm run astro -- --help` | Get help using the Astro CLI                     |
+Dual-licensed under MIT OR Apache-2.0
 
-## 👀 Want to learn more?
+---
 
-Check out [Starlight’s docs](https://starlight.astro.build/), read [the Astro documentation](https://docs.astro.build), or jump into the [Astro Discord server](https://astro.build/chat).
+**Built with ❤️ for the Solana community**

astro.config.mjs

@@ -4,21 +4,64 @@ import starlight from '@astrojs/starlight';
 
 // https://astro.build/config
 export default defineConfig({
+	site: 'https://docs.lumos-lang.com',
 	integrations: [
 		starlight({
-			title: 'My Docs',
-			social: [{ icon: 'github', label: 'GitHub', href: 'https://github.com/withastro/starlight' }],
+			title: 'LUMOS',
+			description: 'Type-safe schema language for Solana development',
+			logo: {
+				src: './src/assets/logo.svg',
+			},
+			social: [
+				{
+					icon: 'github',
+					label: 'GitHub',
+					href: 'https://github.com/getlumos/lumos'
+				},
+				{
+					icon: 'twitter',
+					label: 'Twitter',
+					href: 'https://twitter.com/getlumos'
+				},
+			],
+			customCss: [
+				'./src/styles/custom.css',
+			],
 			sidebar: [
+				{
+					label: 'Getting Started',
+					items: [
+						{ label: 'Introduction', slug: 'getting-started/introduction' },
+						{ label: 'Installation', slug: 'getting-started/installation' },
+						{ label: 'Quick Start', slug: 'getting-started/quick-start' },
+					],
+				},
 				{
 					label: 'Guides',
 					items: [
-						// Each item here is one entry in the navigation menu.
-						{ label: 'Example Guide', slug: 'guides/example' },
+						{ label: 'Type Mapping', slug: 'guides/type-mapping' },
+						{ label: 'Anchor Integration', slug: 'guides/anchor-integration' },
+						{ label: 'Enum Support', slug: 'guides/enum-support' },
+						{ label: 'Migration Guide', slug: 'guides/migration-guide' },
+					],
+				},
+				{
+					label: 'API Reference',
+					items: [
+						{ label: 'CLI Commands', slug: 'api/cli-commands' },
+						{ label: 'Parser', slug: 'api/parser' },
+						{ label: 'Generators', slug: 'api/generators' },
 					],
 				},
 				{
-					label: 'Reference',
-					autogenerate: { directory: 'reference' },
+					label: 'Examples',
+					items: [
+						{ label: 'Gaming Platform', slug: 'examples/gaming' },
+						{ label: 'NFT Marketplace', slug: 'examples/nft-marketplace' },
+						{ label: 'DeFi Staking', slug: 'examples/defi-staking' },
+						{ label: 'DAO Governance', slug: 'examples/dao-governance' },
+						{ label: 'Token Vesting', slug: 'examples/token-vesting' },
+					],
 				},
 			],
 		}),