I launched Aistrology.app
For the past year most of my evenings went into one project, and it is finally public: Aistrology.app. It calculates natal charts, Human Design bodygraphs and Vedic charts, has a moon-phase calendar, and runs in 12 languages. This post is less about the product and more about what it was like to build.
Why I built it
I spend a lot of time with 3D models, where a small error in geometry ruins the whole print. A birth chart is a similar problem: the positions of the planets, seen from one exact place at one exact minute, turned into a diagram. Most astrology sites I tried either showed a wall of symbols with no explanation, or gave friendly text with no way to see what it was based on. I wanted both the exact numbers and a plain-language reading, so I started writing my own.
The interesting parts
- Chart calculations. Planet positions are computed on the server from an astronomical model. On top of that sit houses, aspects and angles. House systems are a rabbit hole of their own: Placidus behaves very differently from Whole Sign, and some systems break down at high latitudes, where the formulas stop giving sensible answers.
- Time zones are the real enemy. A birth time is local time at a place, decades ago. That means looking up the time zone from the coordinates and then applying the historical offset and daylight-saving rules for that date. Being off by one hour moves the ascendant by roughly 15 degrees, so this has to be right.
- Human Design bodygraphs. Human Design needs two moments: birth, and a “design” moment when the Sun stood 88 degrees of arc earlier, about three months before birth. Finding that moment is a small search problem, not a fixed date offset. Then the gates and channels have to be drawn as an SVG bodygraph that still looks clean on a phone.
- Vedic charts. Same sky, different zodiac: the sidereal zodiac sits about 24 degrees away from the tropical one, and the charts are traditionally drawn as squares rather than wheels. Reusing the calculation layer while changing the presentation kept the codebase sane.
- 12 languages. Translating the interface was the easy part. Localised URLs, dates, number formats, and astrology terms that do not translate one-to-one between languages took much longer.
- Moon-phase calendar. Simple-looking, but people read it by local date, so a new moon at 23:40 UTC lands on different days for different visitors.
What was hard
Not the maths, surprisingly. The hard parts were checking results against established tools until they matched, deciding how much explanation to show without burying people in text, and resisting the urge to add one more feature before launching. Writing interpretations that are consistent (the same chart should always give the same reading) also took more design work than I expected.
What’s next
Transit and relationship charts are high on the list, along with more written guides. If you want to poke at it, the free birth chart calculator is the quickest way in: the chart itself needs nothing but a birth date, time and place, and an account unlocks the readings that explain what each placement means. Feedback, bug reports and “this number looks wrong” emails are all welcome.
Leave a Reply