www Astro website

Overview

Work on the Astro site in www/: update content, add pages or news posts, and adjust styling while following the local design system.

Quick Start

• Install deps: cd www && npm install
• Run dev server: npm run dev
• Build: npm run build
• Preview build: npm run preview

Project Map

• Use www/src/pages/ for route files (e.g., index.astro, manual.astro, news/).
• List news posts in www/src/pages/news/index.astro via Astro.glob; export title and date from each post.
• Wrap pages with www/src/layouts/Layout.astro; keep Nav, global CSS, fonts, and analytics wired in.
• Edit the main nav in www/src/components/Nav.astro.
• Treat www/src/styles/global.css as the home for global typography, colors, and layout defaults.
• Place static assets in www/public/ (images, icons).
• Follow the design system in www/DESIGN.md.
• Avoid editing www/dist/ directly (build output, ignored by git).

Conventions

• Wrap pages with Layout and set title plus description when available.
• Put shared styling in www/src/styles/global.css; keep page-specific styles in each .astro file's <style> block.
• Follow www/DESIGN.md: bold, high contrast, thick borders, sharp corners, palette-driven accents.
• Preserve existing typography: Fira Mono for headings, system-ui for body.
• Keep assets in www/public/ and reference by absolute path (e.g., /screenshot.png).

Common Tasks

Update content

• Edit the target .astro file in www/src/pages/ or www/src/pages/news/.
• Adjust local styles in the same file if layout changes are needed.

Add a new page

1. Create www/src/pages/<route>.astro.
2. Use Layout and provide title/description.
3. Add a nav link in www/src/components/Nav.astro if the page should appear in the top nav.

Add a news post

1. Create www/src/pages/news/<slug>.astro.
2. Export title and date as strings.
3. Use Layout and include a back-link to /news/.
4. Rely on Astro.glob in /news/ to surface the post automatically.