astro only

README.md

@@ -37,6 +37,12 @@ Run Astro locally while editing:
 npm run dev
 ```
 
+Check that the generated site builds successfully:
+
+```bash
+npm run check
+```
+
 Regenerate Markdown content from the exported post HTML:
 
 ```bash
@@ -85,3 +91,16 @@ Then open:
 ```text
 http://localhost:4321/
 ```
+
+## Deployment
+
+This project deploys as a static Astro build. A deployment job should install
+dependencies, run the build, and publish the generated `dist/` directory:
+
+```bash
+npm ci
+npm run build
+```
+
+Use `npm run start` only when you intentionally want Astro to serve the built
+output in an environment such as a local or Nomad preview job.