This repository contains the standalone HagiCode documentation site built with Astro and Starlight.
The docs site is where users learn the platform: product overviews, installation guides, tutorials, blog posts, and downloadable configuration presets all live here.
- Product introductions and onboarding guides for new users
- Step-by-step installation and configuration documentation
- Blog content and updates for the HagiCode ecosystem
- Preset files and static assets referenced by public docs pages
src/content/docs/- documentation pages and blog contentsrc/components/andsrc/layouts/- site UI building blockspublic/- static assets, downloadable presets, and shared mediascripts/andtests/- verification helpers for docs quality and routing behavior
npm install
npm run dev
npm run build
npm run previewThe local docs server runs on http://localhost:31265 by default.
Desktop download data is fetched at runtime from the canonical index endpoint published by repos/index.
When runtime loading reaches terminal failure, docs falls back to the Index Desktop history page at https://index.hagicode.com/desktop/history/.
repos/index remains a referenced dependency only; the stable fallback surface is https://index.hagicode.com/desktop/history/ plus https://index.hagicode.com/desktop/index.json.
This repository still serves public/version-index.json as a local snapshot for offline fallback, but maintainers should investigate the runtime fetch chain and the index deployment before changing docs UI behavior.
Repository-scoped update detail pages are no longer hosted in this docs site. A future change will introduce the replacement version update information surface.
Use this repository when the goal is end-user education and public documentation. Product storytelling lives in repos/site, while application behavior lives in repos/web, repos/hagicode-desktop, and repos/hagicode-core.