Astroway Natal Chart Widget

Embeddable natal chart calculator for any website. One <div>, one <script>, no build step and no API key.

Positions come from Swiss Ephemeris compiled to WebAssembly and are computed in the visitor's browser. Birth data is never sent to a server.

Live demo and configurator: https://app.astroway.info/widget

<div data-astroway-widget="natal" data-lang="en" data-theme="dark"></div>
<script src="https://app.astroway.info/widget.js" async></script>

That is the whole integration. The script finds every [data-astroway-widget] on the page, mounts an iframe into it and resizes it as the chart is drawn.

Or from npm, if you prefer to self-host the loader:

npm install @astroway/widget

import '@astroway/widget'

The hosted widget.js updates in place, so a Subresource Integrity hash on the <script> tag would break the embed on the next release. If your security policy requires SRI, install the npm package instead, serve widget.js from your own origin and pin the hash there.

Several widgets can live on one page, each with its own language and theme:

<div data-astroway-widget="natal" data-lang="de" data-theme="light"></div>
<div data-astroway-widget="natal" data-lang="pl" data-theme="dark"></div>
<script src="https://app.astroway.info/widget.js" async></script>

If your site sends a strict CSP, allow the loader and the iframe:

script-src  https://app.astroway.info;
frame-src   https://app.astroway.info;

Nothing else is needed: the widget loads no third-party assets on your page, and the ephemeris files are fetched inside the iframe, on our origin.

The widget renders a "Powered by AstroWay" line inside the iframe, but that link lives on our domain, not on yours, so search engines do not read it as a link from your site. If you want to credit the project in a way that counts, add a plain link next to the widget:

<p>Chart engine by <a href="https://app.astroway.info" rel="noopener">Astroway</a>.</p>

This is optional. The widget works the same either way.

Planet positions to the arcsecond, house cusps to the arcminute, aspects with configurable orbs, and a rendered chart wheel. House systems include Placidus, Koch, Regiomontanus, Campanus, Whole Sign and Equal.

The full application behind the widget covers synastry, transits, progressions, directions, solar and lunar returns, Human Design and around forty other techniques: https://app.astroway.info/features

The engine is the same one that powers app.astroway.info and the Astroway Calculation API. Planet longitudes are checked against Swiss Ephemeris reference output to within one arcsecond, house cusps to within one arcminute.

Ephemeris coverage follows the DE431 model: roughly 13000 BCE to 17000 CE.

The iframe runs on app.astroway.info and loads the WASM ephemeris on demand. Date, time and place entered by the visitor stay in the browser: the chart is computed locally and no birth data is transmitted. The loader adds no cookies and no tracking of its own.

Pages that already use the global-variable form keep working:

<div id="astroway-widget"></div>
<script>
  var astrowayWidget = "natal";
  var astrowayLang   = "en";
  var astrowayTheme  = "dark";
</script>
<script src="https://app.astroway.info/widget.js"></script>

This form supports a single widget per page. New integrations should use the data-attribute form above.

• examples/plain.html: static HTML
• examples/react.jsx: React component
• examples/vue.vue: Vue 3 single file component
• examples/wordpress.php: WordPress shortcode

• Astroway app: the full application
• Calculation API: REST access to the same engine, 760 endpoints
• @astroway/mcp: MCP server for AI assistants

MIT. See LICENSE.