AstroAI — AI Astrology, Tarot & Numerology App (Flutter + Next.js, Western + Vedic, Birth Chart)

AstroAI — the AI does the reading, grounded in a real chart

AstroAI is a polished Flutter app that bundles three divination systems — Astrology, Tarot, and Numerology — across Western (tropical) and Vedic (sidereal) traditions. Every reading is generated by an LLM grounded in a real, locally-computed chart — not static content, not a human-astrologer marketplace, and not a paid third-party astrology API.

Under the hood is a real deterministic computation backbone — public-domain VSOP87 ephemeris charts, nakshatra and Vimshottari dasha, Guna Milan / Ashtakoot scoring, Pythagorean numerology, and a seeded 78-card tarot draw — with an AI narration layer on top. Not a thin GPT wrapper.

Why buyers love it

• Functional AI, keys never in the app — dual OpenAI + Gemini, switchable with one server env var; every model call runs through a JWT-authenticated Next.js /api/ai/* gateway.
• Self-contained — no paid astrology/kundli APIs and no AGPL Swiss Ephemeris (incompatible with closed-source apps). Charts compute on-device.
• Runs offline — the whole app works against bundled mock data, so you can preview it instantly with zero backend.
• Monetization built in — RevenueCat subscriptions + AdMob, with lean-free gating.
• AI safety framing — a persistent “for reflection & entertainment” disclaimer, no death/doom predictions, no medical/legal/financial directives, crisis sensitivity.

Demo

Download the demo APK (Android): astroai-demo.apk

The app also runs fully offline (mock mode) so reviewers can launch it in seconds; the demo APK points at our hosted backend for live AI. There are no seeded credentials: sign in live with email, guest, or Google/Apple, or tap “Explore a sample chart.”

Features

• Western + Vedic birth charts (whole-sign + Placidus, aspects, Rashi/Lagna/Nakshatra)
• Vimshottari dasha timeline
• AI birth-chart deep-dive
• ❤️ Compatibility — synastry + Vedic Guna Milan
• Tarot spreads (single / 3-card / Celtic Cross)
• Numerology (Life Path, Expression, Soul Urge, Personality, Birthday)
• Ask-the-stars AI chat
• Daily & weekly horoscope (free tier)
• Reading + tarot history with offline cache
• Google + Apple + guest sign-in (Apple iOS-only)
• ☁️ Cloud sync of profiles + history for accounts
• RevenueCat subscriptions + AdMob
• Celestial Editorial design (dark, glassmorphism, Playfair Display + DM Sans)
• ✨ Server-side AI safety framing

Tech stack

• Flutter stable (Dart 3.11+), Riverpod 3, GoRouter, Hive, freezed/json_serializable
• Public-domain VSOP87 ephemeris (local, royalty-free)
• Next.js 15 (App Router, TypeScript) on Vercel + Prisma + Neon Postgres
• JWT auth via jose; zod validation
• OpenAI + Google Gemini (server-side, switchable)
• RevenueCat (subscriptions) + Google Mobile Ads (AdMob)

What’s included

• Full Flutter source (lib/) + the full Next.js backend source (backend/)
• The deterministic computation engines (ephemeris, Western, Vedic, numerology, tarot) — unit-tested
• Hive offline cache + mock layer (offline mode) and Prisma/Neon cloud sync
• The /api/ai/* gateway (dual provider, JWT, safety prompt, rate limiting, caching)
• Accounts (email + Google/Apple + guest), RevenueCat (+ webhook), AdMob
• Celestial Editorial design system, seed data, and full documentation
• 6 months email support, lifetime updates

Requirements

• Flutter (current stable, Dart 3.11+; built on Flutter 3.44 / Dart 3.12)
• A Neon Postgres + Vercel account for the backend
• An OpenAI or Gemini API key (your spend)
• Optional: RevenueCat + AdMob (free tiers)
• Apple Developer + Google Play Console for distribution

Quick setup

1. flutter pub get and dart run build_runner build --delete-conflicting-outputs
2. Run offline: flutter run --dart-define=ASTROAI_BACKEND_URL=
3. Deploy backend/ to Vercel (Root Directory backend); set Neon + AI env vars; migrations auto-run on build
4. Point the app at your backend with --dart-define=ASTROAI_BACKEND_URL=https://your-app.vercel.app
5. Optional: add your RevenueCat pro entitlement + key and AdMob ids

Pricing

This is the source-code license. The app sells in-app Pro via RevenueCat (suggested ~$4.99/mo, ~$29.99/yr, ~$49.99 lifetime), which you keep 100% of.

Support

Email devsnack26@gmail.com · WhatsApp +855 96 741 3911 · 6 months bundled.