Documentation site for Music Assistant built with Astro Starlight.

🔗 Live Site: https://music-assistant.io

🔗 Beta Site: https://beta.music-assistant.io

Opening a pull request? See CONTRIBUTING.md first. Documentation pull requests go to the beta branch, and adding a music source or player provider takes a few steps beyond writing the page.

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview

• Framework: Astro with Starlight
• Node Version: 22+
• Dev Server: http://localhost:4321

/
├── src/
│   ├── content/docs/      # Markdown documentation files
│   ├── styles/            # Custom CSS (branding)
│   ├── components/        # Custom Astro components
│   └── assets/            # Logo files
├── public/
│   ├── assets/            # Static images
│   ├── videos/            # Video files
│   ├── callback/          # OAuth callback endpoint
│   └── cast-receiver/     # Google Cast receiver
├── astro.config.mjs       # Astro configuration
└── dist/                  # Build output

1. Edit markdown files in src/content/docs/
2. Add YAML frontmatter with a title field
3. Use Starlight syntax for special elements
4. Reference images with absolute paths: /assets/image.png
5. Internal links use extensionless format: /installation (not /installation.md)

Beta can be worked on from the beta branch of the repo and preview on beta.music-assistant.io.