Starlight

Overview

Starlight is a documentation framework built on Astro. It's used when you choose a non-Next.js framework, or when you prefer Astro's approach.

What You Get

Starlight generates a separate docs site in a docs/ subdirectory of your project:

Development

The docs site runs separately from your main app:

cd docs
pnpm dev

Deployment

Deploy the docs site separately, or as a subdirectory of your main deploy. Many teams host docs on a subdomain like docs.my-ui.com.

When to Use Starlight

• You're using Vite, React Router, or TanStack Start
• You prefer Astro's static-first approach
• You want docs on a separate domain/subdomain
• You don't need tight integration with your main app