1. Documentation
  2. Quickstart
ReadmeGitHub
  • Introduction
  • Quickstart
  • Text
  • Code
  • Lists
  • Tables
  • Accordion
  • Badge
  • Button
  • Callout
  • Code Block
  • Code Block Group
  • Code Snippet
  • Columns
  • Custom components
  • GitHub
  • Hover Card
  • Mermaid
  • Properties
  • Related Topics
  • Tabs
  • Tree
  • Images
  • Video
  • Files
  • Grain
  • Shade
  • Moss
  • Configuration
  • Content
  • Navigation
  • Site Identity
  • Appearance
  • Header and Footer
  • Fonts
  • Icons
  • Integrations
  • Search
  • OpenAPI
  • AI Chat
  • React Router
  • Astro
  • Next.js
  • Cloudflare
  • Vercel
  • robots.txt
  • sitemap.xml
  • JSON-LD
  • rss.xml
  • llms.txt
  • llms-full.txt
  • .md endpoints

Quickstart

Create a ready-to-use documentation project with create-heyo-docs.

Loading documentation…

Introduction< PreviousTextNext >

Powered by heyo

On this page

Create a projectManual installation

The fastest way to start with Heyo Docs is create-heyo-docs. The creator generates a standalone project, lets you choose a framework, and sets up your first documentation page.

Create a project

Run the creator and answer its questions about the project directory, framework, deployment target, theme, and package manager. When it finishes, follow the printed commands to move into the new directory and start the development server:

bun create @heyo-sh/heyo-docs

Then edit content/index.mdx and configure the site name, description, and theme in heyo-docs.config.ts. The starter creates its first sidebar automatically; add explicit groups only when you need a custom order. Read the content guide to learn more about the file structure.

Recommended installation

Choose create-heyo-docs when starting a new project. The generated starter also includes SEO configuration, a sitemap, robots.txt, RSS, and files for AI agents.

Manual installation

Manual installation is useful when documentation needs to live inside an existing application. Find complete framework-specific instructions in the articles below.

React Router

Add Heyo Docs to an existing React Router application.

Next.js

Configure documentation in an existing Next.js App Router application.

Astro

Add Heyo Docs to an existing Astro project.

When your documentation is ready, continue with deployment to Vercel or Cloudflare.