Guides

Why Astrology Apps Are Adding Primary Directions in 2026

Consumer transit apps are commoditized. Primary directions is the cleanest depth wedge for subscription retention. The math, the ICPs, the build plan.

OK

Oleg Kopachovets

CTO & Co-Founder

May 26, 2026
10 min read
237 views
Primary directions in modern astrology apps
Primary directions in modern astrology apps
0%

The depth wedge in 2026

Consumer astrology apps had a great run. Co-Star raised on transit alerts written like text-message poetry. The Pattern got bought because it framed transits as psychology. CHANI built a paid subscription on top of planetary cycles narrated by a public figure. All three are excellent products. All three sit on the same engine: daily and weekly transits to natal points, with copy on top.

That layer is now commoditized. Any indie team can pull transits from a half-dozen APIs, wrap them in a wellness tone, and ship a v1 in two weeks. Acquisition costs in the category have climbed. App-store search is crowded with "horoscope" and "natal chart" results. The market signal is clear: transits-with-copy is not a moat anymore.

The next subscription wedge is depth. Specifically, depth that consumers cannot get from a horoscope tabloid or a free chart widget. Techniques that working astrologers actually use for client forecasting, packaged into a phone-friendly interface, priced as a subscription.

Primary directions is one of the cleanest signals in that category. It is the 17th-century-rediscovered Hellenistic predictive technique that pro astrologers swear by and that almost no consumer app ships. As of May 25, 2026, it is also a single API call away. That changes the build math.

What primary directions actually are

Primary directions move a natal point, say Mars, forward through the sky at the Earth's actual rotation rate. About 1° of right ascension across the meridian equals 1 year of life under the Ptolemy key. When the directed Mars reaches a natal point like the Sun, that is a dated event in your life. Not a vague "Mars season" mood. A specific year, sometimes a specific month.

The math is older than telescopes. Ptolemy wrote it up in the Tetrabiblos. William Lilly used it in 17th-century England. Placidus de Titis formalized the 3D semi-arc method that most pros use today. The canonical modern reference is Martin Gansten's Primary Directions: Astrology's Old Master Technique (2009). Practitioners like Bernadette Brady, Robert Hand, Demetra George, and Chris Brennan teach versions of it. Solar Fire and Janus ship it on desktop. The reason it stayed off mobile is that the calculation is unforgiving and the explainer copy is hard to write.
Two distinctions you will see in the literature. In mundo directs the body of the planet through its actual diurnal arc. In zodiaco flattens the planet to its ecliptic longitude first. Both are valid. Most modern software defaults to zodiacal. Then primary directions versus arc directions: primary uses Earth's rotation as the engine. Arc methods (Naibod, solar arc) move every point by a fixed yearly amount. Astrologers use them as cross-checks on the primary picture.

That is the orientation. The reader does not need the formulas. The build does not need the formulas either, because the API returns the dated events.

The retention math

Here is the part founders care about. Subscription astrology apps live or die on day-90 retention. The category benchmarks roughly look like this, based on indie-app patterns observed across 2024-2026:

A daily horoscope feature alone retains in the 30-40% range at day 90. The problem is well known. Users binge for a week, the copy starts to feel repetitive, the notification gets muted. There is no specific dated event pulling them back.

Add transits and progressions and you climb to roughly 45-55% at day 90. Better. Users now have personalized timing copy, and a Saturn transit is at least a discrete thing. But progressions move slowly and most transits feel ambient.

Primary directions sit in a different segment. They pull the astrologer-curious power user. This person is one or two years into learning their own chart. They have a tropical Sun, a Whole Sign rising, a Twitter account that follows three working astrologers. They want to know when. Not vibes. A date. Day-90 retention in this segment, when the product is built well, lands in the 65-75% band.

The reason is structural. Each direction is a discrete event with a date attached. The product can ship a notification at 30 days out, 7 days out, and on the day. "Mars directed to natal Sun in 11 months. Career intensity peak." That sentence is calendar-friendly. It survives the muting reflex because it is concrete and rare. A user might have three to six significant directions per year, not three hundred transits per week. Scarcity helps the inbox.

The retention loop is built from the technique itself. You do not have to manufacture engagement with copy tricks. You just surface the next dated event.

The ICP buyer math

Two segments pay for depth.

The first is the astrologer-curious power user. Subscription tolerance is roughly $9.99 to $19.99 per month. They buy because they want a tool that respects the seriousness of their interest. They have tried the consumer apps and found them shallow. They are not professionals, but they read books, listen to The Astrology Podcast, and want a calendar of their own significant moments. Conversion is high once they hit the paywall, because the alternative is a $500 desktop install of Solar Fire that runs on a Windows machine.

The second is the astrologer professional going digital. This is the prosumer tier at $29 to $49 per month. Working astrologers building a client practice want forecasting tools that match what they teach. Many of them also want a client-facing view they can share. This segment is smaller but pays predictably and churns less, because the tool is part of their working revenue.

CAC payback for a $14.99 per month app at 30% gross margin: 12-month LTV lands near $54. CAC needs to stay under roughly $30 to keep payback inside a year. Primary directions help on this number from an unexpected angle. The keyword cluster around "primary directions calculator", "directed Mars", "Gansten primary directions", "1° per year astrology" is undermonetized in paid search. Most advertisers in the category bid on "horoscope" and "natal chart". Bidding on the depth cluster gets you cheaper clicks and better-qualified visitors. App-store search organic also responds, since "primary directions" returns thin results in May 2026.

What the field actually offers right now

A scan of the competitive landscape in mid-2026:

Co-Star is transits-only with poetic push notifications. No directions. No timing techniques beyond transits.
The Pattern frames the natal chart as psychology. Excellent copy. No directions, no traditional predictive techniques.
CHANI focuses on planetary cycles and Lunar mansions, with high-craft narrated audio. No directions.
Astrodienst (astro.com) has primary directions in its calculation engine. The output is a desktop-style PDF table. It is not an app-native experience. There is no notification system, no upcoming-events feed, no premium subscription tier built around the feature.
Janus 5 / Solar Fire on the desktop side support full directions including secondary, tertiary, and converse. Both are roughly $300-$500 one-time purchases, Windows-only, aimed at professionals. Not a subscription experience. Not on a phone.

The wedge that nobody is sitting on: app-native primary directions, with dated event notifications, sold as a subscription, available via API so an indie team does not have to recompile a 1970s codebase. That is the open lane.

What to build in a weekend

A working v1 is small.

Stack: React Native or a PWA. Single screen on signup that takes birth data. On submit, the app hits /api/v3/directions/primary once for the next five years of significant directions. The response comes back as a sorted timeline of events, each one carrying the promissor, the significator, the type (conjunction, square, trine), the exact date under the Ptolemy key, and a confidence-style severity flag.

Cache the timeline locally with SQLite or AsyncStorage. The full five-year list is small, a few dozen events for most charts, not thousands. No round-trips needed after signup.

Two views ship the product. A calendar view plots the events on a horizontal five-year strip, color-coded by planet. Tap any event to expand a card with plain-language copy. An upcoming list shows the next ten directions sorted by date, with countdowns. That is the entire information architecture for v1.

Push notifications at 30 days, 7 days, and day-of for each major direction. Skip the minor ones at this tier or you will train users to mute.

Premium tier at $14.99 per month adds Naibod and Lunar arc directions as alternative time keys, chart-ruler arc events, and a relocation mode for users who have moved away from their birthplace. Relocation directions are a small calculation tweak and a meaningful upsell for the digital-nomad slice of the audience.

Engineering estimate: four to six days for v1, including onboarding, payment, and notifications. About half a day of that is the timing layer, because one API call gives you the whole timeline. Building the same feature against raw Swiss Ephemeris plus Gansten's 3D formulas is a four-to-six-week solo project, and you still have to test the math against published example charts before you can ship with confidence.

If you want to widen the depth wedge further, the same API stack ships solar returns, profections, and zodiacal releasing. Pair them on the same timeline view and you have a multi-technique forecasting product that no consumer app currently offers. See /p/directions, /p/solar-return, /p/profections, and /p/zodiacal-releasing.

Adoption signals already visible

The audience exists. Demetra George teaches primary directions in her Hellenistic curriculum. Chris Brennan covers them on The Astrology Podcast. Austin Coppock references them in his yearly forecasts. Acyuta-Bhava Das and Adam Sommer mention them on YouTube. The new generation of astrology educators is normalizing the term in front of an audience that already pays for online courses.

The subscription apps have not caught up. The term "primary directions" returns no first-class feature in any of the top ten apps in the App Store astrology category as of May 2026. That gap is the opportunity window. It will close. Founders who ship in the next two quarters get the SEO, the App Store keyword positioning, and the first-mover positioning with the depth segment of the audience.

What kills an "advanced" astrology app

A short list of mistakes that show up in App Store reviews of failed attempts.

Surfacing every minor direction is the first one. There are dozens of partile and aspectual contacts in any five-year arc. Show them all and the notification feed reads like spam. Users mute, then uninstall. Ship the top ten to twenty events per five-year window, classified by severity. Hide the rest behind an "advanced" toggle for the pro tier.

The second mistake is exposing the math in the UI. Right ascension, oblique ascension, polar elevation, mundane proportional distance. These scare 95% of users. Use them in the data model, never in the consumer copy. The user sees "Mars to Sun, March 14, 2027". The technique name belongs in a settings detail screen, not on the home tab.

The third is overpromising. "Primary directions predict your future" invites bad reviews and, in some jurisdictions, regulatory attention. The right framing is conservative: "significant timing moments in your chart, plain-language, with dates". Brennan's framing of astrology as "the study of significant time" is the model. Significant, not deterministic.

The fourth, less obvious, is letting the UI feel like a desktop port. Astrodienst already exists for that audience. If your product looks like a PDF, you have lost. The phone experience has to feel like a calendar app, not like an ephemeris table.

Ship it

The conditions are unusual right now. The technique is centuries old. The audience exists and is paying for education in it. The desktop tools are locked behind one-time licenses on legacy operating systems. The consumer apps have not added the feature. And as of May 25, 2026, the calculation is a single API call against a Gansten-method Placidus semi-arc 3D implementation.

That combination does not stay open forever. Get an API key, ship a v1 in a weekend, and watch what the depth segment does to your retention curve.

Start with the primary directions API page, pair it with the broader timing API and astrology chat API for plain-language summaries, and check pricing for the free tier that covers a full development cycle.
Oleg Kopachovets

Oleg Kopachovets

CTO & Co-Founder

Technical founder at Astrology API, specializing in astronomical calculations and AI-powered astrology