# Developer guides

Version-bound quickstarts, recipes, conventions, errors and receipts.

Engine 1.0.0: On npm.
Archive identity and release status: https://zodiacs.org/developers/engine/

Choose the local engine for on-device or server-local calculation. Hosted recipes send their requests to the Compute API.

## Node quickstart

Compute a synthetic chart in a Node process with the published package.

HTML: https://zodiacs.org/developers/docs/node/
Markdown: https://zodiacs.org/developers/docs/node.md

## Browser quickstart

Bundle a chart calculation into a browser application without uploading chart inputs.

HTML: https://zodiacs.org/developers/docs/browser/
Markdown: https://zodiacs.org/developers/docs/browser.md

## Deno quickstart

Use the installed engine through Deno's Node compatibility and a local node_modules directory.

HTML: https://zodiacs.org/developers/docs/deno/
Markdown: https://zodiacs.org/developers/docs/deno.md

## Bun quickstart

Run an ESM chart example with Bun using the published package.

HTML: https://zodiacs.org/developers/docs/bun/
Markdown: https://zodiacs.org/developers/docs/bun.md

## Cloudflare Workers quickstart

Bundle a fixed synthetic chart into a Worker without a hosted engine dependency.

HTML: https://zodiacs.org/developers/docs/cloudflare/
Markdown: https://zodiacs.org/developers/docs/cloudflare.md

## Natal chart recipe

Calculate bodies, angles, houses and aspects from a resolved UTC instant and place.

HTML: https://zodiacs.org/developers/docs/natal/
Markdown: https://zodiacs.org/developers/docs/natal.md

## Transit recipe

Compare positions at a target instant with a synthetic natal chart.

HTML: https://zodiacs.org/developers/docs/transits/
Markdown: https://zodiacs.org/developers/docs/transits.md

## Solar and lunar returns

Find return instants and their charts through the techniques entry point.

HTML: https://zodiacs.org/developers/docs/returns/
Markdown: https://zodiacs.org/developers/docs/returns.md

## Synastry recipe

Compare two synthetic natal charts with explicit input and time policies.

HTML: https://zodiacs.org/developers/docs/synastry/
Markdown: https://zodiacs.org/developers/docs/synastry.md

## Longitude-crossing searches

Find longitude crossings under a sample budget and handle a refusal as a whole result.

HTML: https://zodiacs.org/developers/docs/crossings/
Markdown: https://zodiacs.org/developers/docs/crossings.md

## Calculation conventions

Keep UTC, TT, UT1, frames, centres, corrections and zodiac choices explicit.

HTML: https://zodiacs.org/developers/docs/conventions/
Markdown: https://zodiacs.org/developers/docs/conventions.md

## Errors and refusals

Distinguish invalid inputs, typed calculation refusals and hosted API errors.

HTML: https://zodiacs.org/developers/docs/errors/
Markdown: https://zodiacs.org/developers/docs/errors.md

## Receipts and reproduction

Reproduce a request and track where a numerical result came from.

HTML: https://zodiacs.org/developers/docs/receipts/
Markdown: https://zodiacs.org/developers/docs/receipts.md

## Python hosted quickstart

Call the hosted positions endpoint from Python without claiming a native Python engine.

HTML: https://zodiacs.org/developers/docs/python/
Markdown: https://zodiacs.org/developers/docs/python.md

## Hosted election search

Search a bounded window for a declared set of sky conditions over HTTP.

HTML: https://zodiacs.org/developers/docs/elections/
Markdown: https://zodiacs.org/developers/docs/elections.md

## Deprecation policy

Understand public API stability, experimental exclusions and removal notice.

HTML: https://zodiacs.org/developers/docs/deprecation/
Markdown: https://zodiacs.org/developers/docs/deprecation.md

## Release changelog

Find the authoritative changes for each release and where each version came from.

HTML: https://zodiacs.org/developers/docs/changelog/
Markdown: https://zodiacs.org/developers/docs/changelog.md

## Developer status

Identify the installed release, supported surfaces and remaining programme work.

HTML: https://zodiacs.org/developers/docs/status/
Markdown: https://zodiacs.org/developers/docs/status.md

React Native and complete sunrise-based panchang guides are not yet available.