Repository avatar
Developer Tools
v0.6.8
active

astrology

org.zodiacs/astrology

Astrology with planet positions tested against NASA JPL Horizons: charts, compatibility, horoscopes.

Documentation

zodiacs.org

The source of zodiacs.org: a free astrology site with guides, calculators that compute charts in the visitor's browser, and a developer section. The site also keeps the Registry (Astrofolio), its record of the Zodiacs collection, as a separate wing with its own pages.

Production deploys from main through Vercel as a static Astro build, with a few serverless functions under api/.

This repository is public so that its work can be read and checked. It is not open source: all rights are reserved (see LICENSE).

What is where

  • The astrology site is everything Astro builds from src/: the sign guides, the Learn pages, the calculators (/birth-chart/, /moon-sign/, /rising-sign/ and others), the daily pages and the developer pages under /developers/. Charts are computed on the visitor's device by @zodiacs/engine, which the site vendors as a digest-pinned archive in vendor/.
  • The Registry wing is the static pages in public/registry/, public/thesis/, public/archive/ and public/sdk/, plus the wing routes under src/pages/registry/, src/pages/terminal/ and src/pages/fomo/. It keeps its own register; CLAUDE.md gives the boundary between the two, and CI enforces it.
  • Records of how the site and its engine are checked are in docs/: docs/platform/programme/ (the programme's acceptance ledger and status), docs/platform/evidence/ (measurements), and docs/claims/ledger.json (the evidence behind every accuracy, time and privacy sentence on the site).

Development

npm ci
npm run dev        # Astro dev server
npm run build      # static build to dist/ (runs the generators' checks first)
npm run check      # consumer boundary, footer and astro check
npm test           # vitest
node scripts/check-dist.mjs   # link and artifact integrity over dist/

Several files are generated; CLAUDE.md lists each with its generator. Edit the source, run the generator, and commit both: CI regenerates them and fails on any difference.

Privacy

Birth details entered in the calculators are computed on the visitor's device. What the site does send, and when, is described on the privacy page.

Licence

All rights reserved; see LICENSE, which also lists the parts that come with their own terms: the chart engine (MIT code with CC BY 4.0 ΔT data, and the time and star data its NOTICE lists), the CC BY 4.0 sky data, the CC BY 4.0 historical time atlas (whose resolver is MIT) and GeoNames place data, and third-party packages.

CONTRIBUTING.md says what kinds of report are welcome, SECURITY.md how to report a security problem, and CODE_OF_CONDUCT.md the rules for taking part.

No installation packages available.

Remote