Site Technology
This page documents the actual stack currently used in this repository so teams can review build decisions and implementation constraints.
Runtime And Build
- Default task runner: Deno (`deno task ...`)
- Dev server and bundler: Vite (`vite`)
- Production delivery: prerendered SolidJS pages served through a Superstructure site surface
- Type checking: Deno check (`deno check`)
- Local requirements: Node.js 22+ and Deno 2.7+
- Developer tooling: WebStorm + Codex for implementation workflows
Framework And Routing
- Framework: SolidJS (`solid-js`)
- Router: @solidjs/router with an explicit route manifest that reuses page modules from `src/routes`
- App shell: `src/app.tsx`
- Downstream integration: Superstructure surface module defined in `superstructure/surfaces/site`
Styling And UI
- CSS framework: Tailwind CSS v4
- Tailwind Vite integration: @tailwindcss/vite
- Utility class merge helper: tailwind-merge
- Global theme and shared styles: `src/app.css`
Media And Asset Pipeline
- Responsive image stack:@responsive-image/core,@responsive-image/solid,@responsive-image/vite-plugin
- Route-level image imports use `?responsive` for optimized variants
- Primary image usage pattern: hero photos + section bands + SVG card illustrations
SEO, Discovery, And Ops
- Page meta helper: `src/helpers/meta.tsx`
- Sitemap and robots generation: `scripts/prerender.ts`
- Route manifest and sitemap helper: `src/site/route-data.ts`
- Validation command: `deno task check`