Starlight is a full-featured documentation theme built on top of the Astro framework. This guide will help you get started with a new project. See the manual setup instructions to add Starlight to an existing Astro project.
Create a new project
Create a new Astro + Starlight project by running the following command in your terminal:
This will create a new project directory with all the necessary files and configurations for your site.
Start the development server
When working locally, Astro’s development server lets you preview your work and automatically refreshes your browser when you make changes.
Inside your project directory, run the following command to start the development server:
This will log a message to your terminal with the URL of your local preview. Open this URL to start browsing your site.
Starlight is ready for you to add new content, or bring your existing files!
Starlight supports authoring content in Markdown and MDX with no configuration required. You can add support for Markdoc by installing the experimental Astro Markdoc integration.
Add new pages to your site by creating
.mdx files in
Use sub-folders to organize your files and to create multiple path segments.
For example, the following file structure will generate pages at
All Starlight pages share a customizable common set of frontmatter properties to control how the page appears:
If you forget anything important, Starlight will let you know.
- Configure: Learn about common options in “Customizing Starlight”.
- Navigate: Set up your sidebar with the “Sidebar Navigation” guide.
- Components: Discover built-in cards, tabs, and more in the “Components” guide.
- Deploy: Publish your work with the “Deploy your site” guide in the Astro docs.
Starlight is an Astro integration, and is updated like any
See the Starlight changelog for a full list of the changes made in each release.
Use the project configuration and individual page frontmatter configuration reference pages to ensure that your Starlight site is configured and functioning properly. See the guides in the sidebar for help adding content and customizing your Starlight site.
If your answer cannot be found in these docs, please visit the full Astro Docs for complete Astro documentation. Your question may be answered by understanding how Astro works in general, underneath this Starlight theme.
You can also check for any known Starlight issues on GitHub, and get help in the Astro Discord from our active, friendly community! Post questions in our
#support forum with the “starlight” tag, or visit our dedicated
#starlight channel to discuss current development and more!