Celestora | Flutter AI Astrology App Template

LIVE PREVIEWBUY FOR $28

Celestora is an entire AI astrology app template constructed with Flutter, GetX and Materials 3 — 17 screens overlaying the beginning chart, compatibility, AI readings, a each day tarot draw, a moon calendar, an indication reference, onboarding, auth and settings, in darkish and lightweight. It casts an actual natal chart on the machine from a built-in ephemeris, then reads that chart via your personal AI supplier. Demo mode ships switched on, so each display screen works with no API key and no community.

There is no such thing as a astrology API behind this app. Planet positions, the ascendant, the homes and the facets are computed in plain Dart on the telephone — so there isn’t a per-chart value, no service that may go down, no key in your customers to get, and a chart casts with the community switched off. Nothing is deployed and nothing is hosted: no server, no Firebase, no vendor SDK, and the customer’s API keys go to the iOS keychain and to encrypted storage on Android.

What’s within the bundle

• Full Flutter app supply code — 17 screens, null-safe, and flutter analyze comes again with zero points
• A built-in ephemeris in plain Dart — seven our bodies, twelve whole-sign homes and 5 facet sorts, every printed with its precise orb, with no community name wherever within the path
• Darkish and lightweight themes, declared facet by facet in a single app_colors.dart file, with the swap within the app on the You tab (darkish, gentle, or observe the system)
• 186 cities bundled with their coordinates and UTC offsets, so the beginning kind wants no location service and no geocoding API
• Twenty-two Main Arcana with upright and reversed meanings written out, and each card face painted at run time
• 4 runtime dependencies solely — get, http, flutter_secure_storage and cupertino_icons. No Firebase, no charting bundle, no astrology bundle, and no vendor AI SDK, so no supplier bundle replace can break your construct
• Thinker, Hanken Grotesk and Cinzel bundled as font belongings with their SIL Open Font License information, plus two subset image faces so the astronomical glyphs render in all places — nothing is fetched at run time
• Clear GetX structure — view to controller to service to information. No display screen ever reads the mock layer, so changing a service methodology physique is all it takes to go reside
• Offline HTML documentation, 19 sections — setup with and with out the terminal, a terminal glossary, a display screen tour with two animated walkthroughs, the ephemeris defined, supplier setup, what to do when a mannequin title is retired, renaming the app, re-theming, the mission construction and troubleshooting
• 91 checks, together with accuracy checks that verify the ephemeris in opposition to six printed astronomical occasions

Who is that this for

• Flutter builders delivery an astrology or horoscope app who need the exhausting half — an actual chart engine — already solved and already examined
• Freelancers and companies with a non secular, wellness or way of life consumer: re-skin one colour file, paste the consumer’s key and hand it over
• Founders validating an astrology app who want one thing actual in entrance of customers this week, with out paying a per-chart API price earlier than the primary signup
• Product groups at horoscope, tarot and wellness manufacturers who desire a fashionable reference app to construct on

The chart is computed, not fetched

Positions come out of an ephemeris compiled into the app: orbital components and a Kepler remedy for the planets, a periodic sequence for the Moon, and a precession correction so the zodiac is measured from the equinox of the date quite than from J2000. No astrology service, no per-chart price, no price restrict. Accuracy is checked in opposition to six documented occasions — two whole photo voltaic eclipses, the 2020 nice conjunction, an equinox, a Venus transit and a Mars opposition — to a tolerance of 0.1°, six arcminutes, tighter than something the interface reveals. These checks evaluate in opposition to printed positions quite than in opposition to the app’s personal output, as a result of a golden file of your personal numbers passes eternally whereas being incorrect.

A wheel drawn in code, not shipped as artwork

Twelve home sectors, a zodiac ring, the planetary glyphs at their actual longitudes and the facet net between them — one CustomPainter, no SVG, no sprite sheet, no art work license to trace. The wheel attracts itself in, ring by ring, on the primary forged. Faucet any glyph and it pulls up that placement’s personal card. Positions, Elements and Transits are three tabs of 1 display screen. A chart with no beginning time drops the angles as an alternative of faking them, and the wheel repaints solely when the chart modifications, so the identical widget scales all the way down to a listing thumbnail.

The mannequin reads the chart, not the birthday

Each placement the app computed is written into the temporary in plain phrases — Solar at 23° Taurus in home 11, Moon conjunct Saturn, 2.3° orb — and also you see the temporary earlier than it’s despatched. 5 studying sorts ship, every with its personal construction: the natal portrait, the yr forward, love and connection, work and objective, and compatibility. One request, one studying, parsed again into titled sections: this isn’t a chatbot, and the mannequin isn’t requested to work out the place a planet is.

Two charts on one wheel

The double wheel places one chart on the outer ring and the opposite on the internal, then attracts solely the contacts that cross between them — so a compatibility declare at all times factors at an actual facet. Attraction, Ease, Understanding and Endurance are rated aside, in stars quite than a share: a single quantity claims a precision astrology doesn’t have. Underneath the rankings sits the contact checklist, one row per facet with its orb; faucet a row and the 2 glyphs gentle up on the wheel above it.

A card a day, dealt from a drawn deck

The fan shuffles, you contact a card, and it turns over in 3D — an AnimatedBuilder and a rotateY remodel, no packages. Twenty-two Main Arcana, each face painted from geometric motifs and astrological glyphs, so there may be nothing traced and nothing licensed. Upright and reversed every have their very own written which means. The day’s card is seeded by the date, so the identical day at all times offers the identical card and a screenshot check stays repeatable.

Three AI suppliers, or none in any respect

Each name is a plain REST request written by hand — no vendor SDK, so no supplier bundle can break the construct, and nothing is proxied via a server of ours.

• Google Gemini — the shipped default. A key from AI Studio is free and desires no bank card, so your customers are by no means despatched to a billing kind on their first run.
• OpenAI — sturdy, predictable prose. The important thing wants a cost methodology, which fits an app with paying customers.
• Anthropic Claude — essentially the most cautious with an extended, structured temporary; it retains each part tied to an actual placement. Additionally pay-as-you-go.
• Demo mode — switched on out of the field. Readings are composed on the machine from the chart itself, so the app solutions for any beginning information with no key, no community and no value. It’s not a folder of canned pattern textual content.

Mannequin names expire, and this template is constructed for that: the mannequin id is an editable discipline within the app quite than a relentless within the supply, a retired title produces a plain-language error with a button straight to the sphere that fixes it, and the documentation has a piece on updating it. Including a fourth supplier is one class and one catalog entry — no display screen modifications.

There’s a complete app across the wheel

The 4 signature screens are the rationale to purchase it, however a purchaser ships the remaining: a month of moon phases with day-after-day drawn as a disc quite than picked from an icon set, a reference for the twelve indicators with dates, factor, mode and ruler, the birth-profile kind with an offline index of 186 cities and a guide UTC offset for the awkward ones, and each studying saved for later. 17 screens in all — splash, onboarding, auth, at this time, chart, synastry, readings, tarot, moon, indicators, profiles, settings and the paywall.

Constructed to be handed over

A template that runs on the primary strive, re-skins from one file, and factors at your personal key with out opening a single display screen file. Each palettes sit facet by facet in app_colors.dart, each typeface is a household fixed in app_text_theme.dart, and each nook radius and margin lives in app_spacing.dart — re-skinning is a day, not a rewrite. There aren’t any picture belongings to redraw: the wheels, the moon discs, the cardboard faces and the signal emblems are painted, so the one bundled information are the 5 typefaces and their license. Views by no means attain into the mock layer, and each typeface is bundled quite than downloaded, so the interface renders identically offline and on a chilly first launch.

Get it operating in 5 minutes

Unzip, run flutter pub get, run flutter run. That’s the complete setup — there isn’t a server to start out, no database to create, no key to register and no account to enroll in. The very first thing you see is a working app in Demo mode, and also you add a supplier key later solely in order for you reside readings. Each chart on each display screen is forged by the app itself both approach.

Attempt it before you purchase

The Stay Preview runs the actual app in your browser, in Demo mode. Solid a chart and watch the wheel draw itself in, faucet a glyph to learn its placement, put two charts on one wheel, and switch over the cardboard of the day — the 4 screens this template is constructed round are all clickable earlier than you spend something.

Necessities

To run and construct the supply code you want the Flutter SDK (model 3.29 or newer) and Dart 3.7 or newer, along with a Flutter-ready IDE — Android Studio or Visible Studio Code with the Flutter & Dart plugins. Runs on each Android and iOS from a single codebase. No server, no Firebase, no database.

Third-party prices and sincere limits

• Third-party API prices are yours. Celestora computes charts on the machine, however the written readings are produced by a third-party AI supplier that you simply or your customers provide a key for. Connecting it to a reside supplier — similar to Google Gemini, OpenAI or Anthropic — will contain these third-party providers, which will incur their very own separate prices and should not included on this merchandise. Gemini has a free tier that wants no bank card; the opposite two require a cost methodology. Demo mode is free eternally and desires no key in any respect.
• The ephemeris is show grade. It’s checked in opposition to six printed occasions to 0.1°, which is much tighter than something the interface prints, however it’s a compact sequence resolution quite than a full planetary principle. In case you want observatory precision, the entire engine is one file to exchange.
• For leisure. The astrology and tarot content material on this app is offered for leisure. It’s not medical, psychological, authorized or monetary recommendation, and the app says so the place a person reads it.

What’s not included

• No backend and no bundled studying mannequin. Written readings run in opposition to a supplier you select with your personal key. Demo mode composes its textual content on the machine from the chart itself, which is why it really works offline — it’s not an area language mannequin.
• The classical seven our bodies solely. Solar via Saturn. Uranus, Neptune, Pluto, Chiron, the lunar nodes and the asteroids should not positioned — a compact sequence wouldn’t place them precisely, and the classical seven are what a natal chart is learn from.
• Entire-sign homes solely. Placidus, Koch and the opposite quadrant techniques should not included. Entire signal is the oldest system and it has no edge circumstances, which can be why a chart nonetheless attracts above the polar circle.
• 5 main facets — conjunction, sextile, sq., trine and opposition, every with its personal orb. Minor facets and declinations should not calculated.
• Start profiles and studying historical past reside in reminiscence for the demo. They reset to the pattern information on restart; solely the API keys are persevered, within the iOS keychain and in encrypted storage on Android. Each service methodology returns a Future and touches the mock layer in precisely one place, so writing them to disk or to your API is a physique swap with no display screen modifications.
• If safe storage is unavailable the app says so and retains keys in reminiscence for that session solely, quite than failing silently or writing them to plain preferences.
• The paywall is a mock. Plans and an improve move are wired up, however no cost code, retailer product or receipt validation ships — actual purchases want your personal.
• English solely. No localization information or RTL layouts are included.

Help and updates

Questions on setup, suppliers, the ephemeris or re-skinning are answered via the merchandise’s feedback. Merchandise assist covers the template itself; it doesn’t cowl a supplier’s personal account, quota or billing.

Changelog

1.0.0 — Preliminary launch.

Source