Skip to content

Getting Started

This is the centralized documentation portal for all AnglinAI projects. It aggregates docs/ folders from each project repository into a single searchable site.

How It Works

  • Build-time aggregation — A prebuild script fetches markdown files from each project’s docs/ directory (via local filesystem or GitHub API) and writes them into the Astro content collection.
  • Automatic rebuild — GitHub webhooks on source repos trigger a Cloudflare Pages rebuild whenever docs are updated.
  • Search — Pagefind indexes all content at build time for instant client-side search.

Adding Documentation

To a project

Create or edit markdown files in the docs/ directory of any source repository listed on the homepage. They will appear under that project’s section on the next build.

General (cross-project) docs

Add markdown files to the docs/ folder in this repository (admin-docs). They appear under the General section in the sidebar.

Local Development

Terminal window
# Install dependencies
npm install
# Build (aggregates docs + builds site)
npm run build
# Start dev server (run build first to populate content)
npm run dev
# Preview production build
npm run preview

A GITHUB_TOKEN environment variable is required in .env for the GitHub API fallback. Local filesystem paths are tried first.