heliosian/docs/dev.md

Local development

Toolchain prerequisites: see setup.md.

Run

go run .

The server listens on http://localhost:8080 (override with PORT). Templates, static assets, and sample data are read from disk on every request — edit a file and refresh the browser; no restart needed.

Local data

The server reads local data from sampledata/, mirroring the production Sheets layout: one directory per app, one CSV file per table, first row is the schema. It goes through the same data-source interface production backends implement, so app code never knows which backend it is talking to.

Real data

DIRECTORY_SHEET=<spreadsheet id> go run .

switches the directory app to the Google Sheets source. At startup the directory tables are read from the spreadsheet and normalized into the in-memory data model (see docs/data.md); the server refuses to start if that load fails, and the model reloads every five minutes. Requires a service account key in creds/ (any *.json; the directory is gitignored) with the Sheets API enabled and the spreadsheet shared read-only with the service account. Real data never leaves the process: nothing is written to disk.

Layout

• main.go — server entry point and app routing
• internal/data — data source interface and the CSV sample-data implementation
• internal/directory — directory app handlers
• web/directory — directory app page templates and static assets
• tools/screenshot — dev-site page capture, see screenshots.md