Astro + Starlight Basic Tutorial
Beginner setup and first Starlight project.
Astro Starlight Tutorial Library
A grouped HTML tutorial collection for learning Astro, Starlight, Markdown, MDX, content collections, world bible sites, lesson libraries, deployment, accessibility, plugins, and troubleshooting.
Recommended Path
Start with the basic Astro/Starlight tutorial, then move through writing tools, project structure, content architecture, customization, capstone projects, and deployment.
Start Here
Astro Starlight Full Site Setup
Build a full Starlight tutorial site from scratch.
Intermediate and Advanced Astro + Starlight
More complete implementation patterns.
Core Writing Tools
YAML Tutorial Guide
Frontmatter and structured metadata basics.
Markdown and MDX Tutorial Guide
Writing content and using component-powered MDX.
Project Structure and Navigation
Starlight Project Structure and Sidebar Navigation
Folders, docs pages, sidebars, and navigation strategy.
Starlight Homepage and Landing Page
Splash homepage, hero actions, and landing-page cards.
Starlight Search and Metadata
Improve search, titles, descriptions, and previews.
Components and Customization
Custom Components in Markdown/MDX
Reusable components inside content pages.
Customizing and Overriding Starlight Components
Safe customization and advanced overrides.
Starlight Styling and Theme Customization
Custom CSS, theme variables, and readability.
Starlight Plugins
Plugin strategy, evaluation, and safe usage.
Content Architecture
Astro Content Collections and Schemas
Typed frontmatter, collections, and Zod schemas.
Tags, Categories, and Filtering
Metadata-driven browsing and filtering.
Dynamic Routes and Collection Indexes
Generate pages and indexes from collections.
Assets, Diagrams, and Special Features
Asset Management
Images, maps, diagrams, downloads, and paths.
Mermaid Diagrams
Flowcharts, timelines, and safe Mermaid syntax.
Accessibility Checklist
Make docs, diagrams, and components more usable.
i18n and Multilingual Sites
Language folders, translated navigation, and multilingual planning.
Capstone Projects
Lesson Library Site Capstone
Build a full Starlight lesson library.
World Bible Site Capstone
Build a full Starlight world bible.
World Factbook to World Bible
Use Factbook-style structure for fictional world bibles.
RPG Character Sheet System
Character stats, schemas, cards, and indexes.
Deployment and Troubleshooting
Vercel Basic How-To
Deployment foundation before Astro-specific hosting.
Deployment Workflow
Build, preview, and deploy Astro/Starlight sites.
Troubleshooting Build Errors
Fix install, build, MDX, schema, asset, and deploy errors.