Badwater Astro Human Design

Long-running experimental fork of the Hugo HD encyclopedia at 33.02 Badwater Hugo Human Design/. Astro + SQLite (build time only) + Svelte islands. The site runs in parallel with the Hugo build at hd.badwater.group during the experimental period and converges into the canonical site at cutover.

See STATUS.md for what is currently shipped and where the boundary is between Hugo-canonical and Astro-canonical data.

Quickstart

npm install
npm run build      # runs sync → seed → graph → astro build
npm run dev        # local dev server on :4321

The build pipeline assumes the Hugo project is at the relative path expected by scripts/lib/hugo-yaml.ts. The first npm run sync will halt with a descriptive error if any referential integrity check fails against Hugo data.

Chart calculator

CLI calculator that produces an HDChart JSON payload from birth data, designed to be pasted directly into the existing loader on /your-chart/ or shared with the Hugo site (the storage shape is mutual).

npm run chart -- --place "Boise, Idaho" --date 1988-07-15 --time 14:30
npm run chart -- --place "..." --date ... --time ... --out chart.json
npm run chart -- --lat=43.615 --lon=-116.202 --tz America/Boise --date 1988-07-15 --time 14:30

Stdout is the JSON payload; stderr is a human-readable summary (resolved location, computed offset, JDs). Add --verbose to also see per-planet ecliptic longitudes; --minimal to suppress the stderr summary when piping.

Note on negative coordinates. Node's parseArgs treats --lon -116.202 as two flags. Use --lon=-116.202 (with =) for negative latitudes or longitudes. The --place form sidesteps this entirely by geocoding internally.

The math is validated against Swiss Ephemeris (via pyswisseph) on a synthetic fixture. See docs/reference/chart-validation-report.md for the validation result.

Spec: docs/superpowers/specs/2026-05-06-chart-calculator-design.md.

Spec

Architecture spec lives in the Hugo project at docs/superpowers/specs/2026-05-03-astro-port-architecture-design.md.