Websites Monorepo

May 25, 2026 · View on GitHub

A simple monorepo for managing multiple documentation and website projects.

Structure

websites/
├── starlight/    # Starlight (Astro) based website
├── fumadocs/     # Fumadocs (Next.js) based website
└── ...           # Add more websites as needed

Getting Started

Prerequisites

  • Node.js 18.0.0 or higher
  • npm, yarn, or pnpm

Installation

From the root directory:

npm install

This will install dependencies for all workspaces.

Adding a New Website

  1. Navigate to the appropriate directory under websites/
  2. Import or initialize your website project there
  3. The monorepo workspace configuration will automatically recognize it

Example: Adding a Starlight Project

cd websites/starlight
npm create astro@latest -- --template starlight

Example: Adding a Fumadocs Project

cd websites/fumadocs
# Follow the official Fumadocs installation guide at:
# https://fumadocs.vercel.app/docs/getting-started
npx create-fumadocs-app@latest

Working with Individual Projects

Navigate to any website directory and use its standard commands:

cd websites/starlight
npm run dev          # Start development server
npm run build        # Build for production

Workspace Benefits

  • Shared Dependencies: Common dependencies are hoisted to the root
  • Isolated Projects: Each website maintains its own configuration
  • Simple Structure: Easy to add, remove, or migrate projects
  • Flexible: Works with any npm-compatible project

Available Websites

  • Starlight: For building documentation sites with Astro
  • Fumadocs: For building documentation with Next.js

Tips

  • Each website directory contains its own README with specific instructions
  • You can use any package manager (npm, yarn, pnpm) - workspace features work with all
  • Projects can be developed independently or together
  • Simply copy/paste existing projects into the appropriate directories