Astravia

Astravia is a complete, mystical tarot and fortune reading app built natively with UIKit and Storyboards. Four tabs wrap a full esoteric experience: mood check-ins that feed a personal Whisper deck, a Fortune Cookie with 111 hand-written fortunes over a code-drawn starfield, a Reflection hub with six reading types on a rotating 78-card wheel, and a Profile area with a StoreKit subscription paywall. All content ships as editable JSON and is imported into an on-device SQLite database at first launch, so the whole experience runs 100% offline with no login and no API keys.

Highlights

• Guided onboarding that imports cards.json and zodiacDetails.json into the on-device SQLite database at first launch
• Mood tab: daily check-in (Calm, Stressed or Confused) that feeds the Astravia Whisper deck with mood-matched guidance cards
• Fortune tab: Fortune Cookie with 111 fortunes animated over a code-drawn twinkling starfield background
• Reflection hub with six reading types: Daily Reading, Yes or No, Love Reading, Career Reading, Lenormand Card Reading and Zodiac
• Rotating 78-card wheel card picker with shuffle animation and a full reading detail screen with card meanings
• Lenormand readings with the dedicated 36-card Lenormand deck
• Zodiac readings with detailed per-sign content from zodiacDetails.json
• Soul Sounds ambient audio sheet: Attract Love, Release Negative Energy and Meditation Sleep tracks with bundled audio
• Reading history so users can revisit every past reading
• Card back theme picker with multiple designs, plus bundled Nunito and Playfair Display fonts
• Profile tab: StoreKit subscription paywall, Settings and Info pages
• StoreKit subscription (premium unlock) with localized pricing and restore purchases
• Loaf toast notifications for polished feedback, haptics and empty states throughout
• 100% offline and private: no accounts, no analytics, no external requests at runtime

Technology

• Swift, UIKit + Storyboards (iOS 17.0+ deployment target, already configured)
• On-device SQLite database with a dedicated SQLManager layer
• StoreKit subscriptions (product ID listed in the documentation, create your own in App Store Connect)
• JSON-driven content (tarot deck, Lenormand deck, zodiac details, fortunes) - edit the JSON to customize every reading
• CocoaPods with a single dependency (Loaf toast library, MIT license notice included)
• Bundled custom fonts (Nunito, Playfair Display) and ambient audio tracks
• Navy-and-gold mystic design system, re-skin colors from the asset catalog

Requirements

• Mac with Xcode and CocoaPods installed (one pod install step, then open the workspace)
• iOS 17.0+ device or simulator to run
• Apple Developer Program membership to test real subscription purchases on device and to publish to the App Store; the paywall can be tested in the simulator without a membership using a local StoreKit configuration file (step-by-step instructions in the documentation)
• No accounts, no API keys, no third-party SDKs beyond the single toast pod

What You Get

• Complete UIKit + Storyboards Xcode source project, ready to build and run
• All Swift source files, cleanly organized (Controllers, Popups, SQLManager, ProductManager, Extensions, Style, Libs)
• Full JSON content bank: 78 tarot cards, Lenormand deck, zodiac details and 111 fortunes
• Asset catalogs with the app icon, color themes, card back designs, custom fonts and ambient sounds
• Step-by-step HTML documentation with screenshots: setup, architecture tour, bundle ID, renaming, icon replacement, re-theming, JSON content editing, subscriptions with simulator testing, localization, troubleshooting and App Store submission checklist
• Third-party license file for the included open-source code
• Full rights to rebrand, reskin, extend and publish anywhere

Please note: this is a source code template, not a finished published app. Basic Xcode knowledge is required to build, customize and publish. If you have questions, use the contact form on the site, I usually reply within 24 hours.