Celestora | Flutter AI Astrology App Template

Celestora is a complete AI astrology app template built with Flutter, GetX and Material 3 — 17 screens covering the birth chart, compatibility, AI readings, a daily tarot draw, a moon calendar, a sign reference, onboarding, auth and settings, in dark and light. It casts a real natal chart on the device from a built-in ephemeris, then reads that chart through your own AI provider. Demo mode ships switched on, so every screen works with no API key and no network.

There is no astrology API behind this app. Planet positions, the ascendant, the houses and the aspects are computed in plain Dart on the phone — so there is no per-chart cost, no service that can go down, no key for your users to get, and a chart casts with the network switched off. Nothing is deployed and nothing is hosted: no server, no Firebase, no vendor SDK, and the buyer’s API keys go to the iOS keychain and to encrypted storage on Android.

What’s in the package

• Full Flutter app source code — 17 screens, null-safe, and flutter analyze comes back with zero issues
• A built-in ephemeris in plain Dart — seven bodies, twelve whole-sign houses and five aspect types, each printed with its exact orb, with no network call anywhere in the path
• Dark and light themes, declared side by side in a single app_colors.dart file, with the switch in the app on the You tab (dark, light, or follow the system)
• 186 cities bundled with their coordinates and UTC offsets, so the birth form needs no location service and no geocoding API
• Twenty-two Major Arcana with upright and reversed meanings written out, and every card face painted at run time
• Four runtime dependencies only — get, http, flutter_secure_storage and cupertino_icons. No Firebase, no charting package, no astrology package, and no vendor AI SDK, so no provider package update can break your build
• Philosopher, Hanken Grotesk and Cinzel bundled as font assets with their SIL Open Font License files, plus two subset symbol faces so the astronomical glyphs render everywhere — nothing is fetched at run time
• Clean GetX architecture — view to controller to service to data. No screen ever reads the mock layer, so replacing a service method body is all it takes to go live
• Offline HTML documentation, 19 sections — setup with and without the terminal, a terminal glossary, a screen tour with two animated walkthroughs, the ephemeris explained, provider setup, what to do when a model name is retired, renaming the app, re-theming, the project structure and troubleshooting
• 91 tests, including accuracy tests that check the ephemeris against six published astronomical events

Who is this for

• Flutter developers shipping an astrology or horoscope app who want the hard part — a real chart engine — already solved and already tested
• Freelancers and agencies with a spiritual, wellness or lifestyle client: re-skin one color file, paste the client’s key and hand it over
• Founders validating an astrology app who need something real in front of users this week, without paying a per-chart API fee before the first signup
• Product teams at horoscope, tarot and wellness brands who want a modern reference app to build on

The chart is computed, not fetched

Positions come out of an ephemeris compiled into the app: orbital elements and a Kepler solve for the planets, a periodic series for the Moon, and a precession correction so the zodiac is measured from the equinox of the date rather than from J2000. No astrology service, no per-chart fee, no rate limit. Accuracy is checked against six documented events — two total solar eclipses, the 2020 great conjunction, an equinox, a Venus transit and a Mars opposition — to a tolerance of 0.1°, six arcminutes, tighter than anything the interface shows. Those tests compare against published positions rather than against the app’s own output, because a golden file of your own numbers passes forever while being wrong.