1.5 KiB
2026-02-23 Session Notes
Web Migration to Astro + Docs + CI/CD
Nicholai presented a comprehensive plan to migrate signetai/web from a single 2167-line HTML file served by a minimal Cloudflare Worker to an Astro-based static site with proper docs section and automated deployment. The migration preserves the custom landing page design (canvas animations, parallax scrolling, CRT noise, 9 bespoke sections) by avoiding Starlight and using plain Astro with Content Collections for full styling control.
Phase 1 involves scaffolding the Astro project with config, package.json updates, and removal of Worker-related files. Phase 2 extracts the landing page into ~14 modular Astro components, splitting CSS into global and landing-specific files, and breaking out JS into separate modules for canvas animations, interactions, and theme handling.
Phase 3 adds the docs section by adding frontmatter to the existing 21 markdown files in docs/ plus 5 root docs (VISION.md, README.md, CONTRIBUTING.md, ROADMAP.md, AGENTS.md). A Content Collections glob loader and dynamic route handler ([...slug].astro) render docs with sidebar navigation grouped into 5 sections (Getting Started, Core Concepts, Reference, Infrastructure, Project).
Phase 4 adds GitHub Actions CI/CD with a deploy-web job that builds and deploys to Cloudflare in parallel with npm release. The plan delegates work to 3 Sonnet agents working in parallel, with final integration and browser testing by Opus.
The session captured the plan structure but no implementation work was performed yet.