Skip to content

feat: Rebuild Awesome GitHub site — complete Astro conversion #840

Description

@ashleyshaw

Summary

Rebuild the Awesome GitHub website from the React/Babel prototype (wceu-2026/design_handoff_awesome_github/design_source/) into a production-ready Astro 5 static site deployed to https://github.lightspeedwp.agency/awesome-github/.

Motivation

The current prototype is a single-HTML-file React/Babel app — useful as a design reference but not deployable or maintainable. The Astro site needs to be the canonical, production version: statically built, SEO-friendly, properly typed, and wired into the existing GitHub Pages deployment pipeline.

Acceptance criteria

  • Typed TypeScript data layer (catalogue.ts, learn.ts, glossary.ts) porting all 110+ catalogue items across 8 categories
  • 252 statically-generated pages: catalogue lists, detail pages, learn tracks, lessons, glossary, cookbook, getting-started, why
  • Svelte SearchPalette with Cmd/Ctrl+K keyboard activation
  • Detail pages with Install-in-VS-Code, copy-URL, copy-file, and View-on-GitHub action buttons
  • Mobile hamburger navigation with animated X, slide-in drawer, Escape key support
  • Light/dark theme toggle persisted via localStorage
  • All pages use design system tokens (var(--*)) — no hardcoded colours
  • npm run build produces 0 errors in CI
  • WCAG 2.2 AA: focus rings, colour contrast ≥ 4.5:1, reduced-motion respected

Scope

  • website/src/lib/ — data layer (catalogue, learn, glossary, resources)
  • website/src/components/AwesomeGithub/ — SearchPalette, Nav, Footer
  • website/src/layouts/AwesomeGithubLayout.astro
  • website/src/pages/awesome-github/** — all route pages
  • website/src/styles/awesome-github.css — design tokens

References

Metadata

Metadata

Assignees

Type

No type

Priority

None yet

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions