using astro

README.md

@@ -1,10 +1,13 @@
 # familyfedie-website
 
-Local static website files.
+Local static website files built with Astro.
 
 ## Project Structure
 
 - `website/` - top-level static pages
+- `src/pages/` - Astro endpoints that generate static HTML from `website/`
+- `src/components/` - Astro components for the shared layout migration path
+- `dist/` - generated static output from `npm run build`
 - `website/index.html` - homepage
 - `website/about.html` - about page
 - `website/contact.html` - contact page with the form
@@ -23,6 +26,12 @@ Local static website files.
 
 ## Maintenance
 
+Run Astro locally while editing:
+
+```bash
+npm run dev
+```
+
 After changing shared navigation, sidebar, or footer markup in
 `scripts/components.mjs`, run:
 
@@ -32,6 +41,14 @@ npm run render:layout
 
 ## Local Preview
 
+Build the Astro output first:
+
+```bash
+npm run build
+```
+
+Then serve `dist/` with Docker:
+
 ```bash
 docker compose up
 ```