prompts.txt

no user accounts/authentication feature1. Project Overview
* App Name: The Oracle's Gym
* Tagline: A sparring partner for your intuition.
* Core Purpose: To provide a sophisticated practice environment for intermediate and advanced tarot readers. The app solves the problem of not having varied, complex, and specific scenarios to practice on, and provides a unique "feedback loop" to help readers measure the relevance and depth of their interpretations.
* Target Audience: Experienced tarot enthusiasts who know the card meanings but want to improve their storytelling, intuitive accuracy, and ability to handle complex, real-world questions.
2. Vibe & Design Aesthetic
* Use the attached images to draw inspiration from for the ui elements design and the app’s design
* Core Concept: The aesthetic is "Modern Grimoire" or "Soft Witchcraft." It should feel elegant, focused, and personal—like a beautifully crafted digital journal. The design should empower the user without resorting to mystical clichés, drawing heavily from the ethereal and sophisticated mood of the provided images.
* Color Palette: Inspired by the deep, muted tones and soft highlights in your reference images, we'll use a palette of soft mauves, sage greens, warm creams, dusty purples, warm golden yellows, honey and amber tones , Ivory, cream, and soft pearl tones, sophisticated purples and plums, dusty roses, terracotta, and burnt oranges Accents of muted gold or antique bronze will be incorporated for subtle highlights, reminiscent of aged metallic details found in ancient texts or elegant jewelry.
* Typography: For headers, we'll use an elegant serif font that evokes a sense of history and wisdom, similar to the classic, refined lettering seen in the grimoire-style images. Body text will utilize a clean, highly readable sans-serif to ensure clarity and a modern feel, balancing the traditional header style with contemporary usability.
* Visual Elements: The UI will feature Art Nouveau-inspired borders and delicate line work, echoing the flowing, organic patterns and intricate details present in the reference art. Subtle mystical symbols (e.g., celestial bodies, stylized botanicals, abstract sigils) will be integrated sparingly as elegant icons or background textures, maintaining the ethereal illustration style from your images. Think soft, watercolor-like gradients and gentle glows for interactive elements, creating a sense of depth and magic without being overtly fantastical.
3. Core User Experience (UX) Flow
1. Onboarding: A brief, elegant walkthrough of the three practice modes. The user selects their preferred default digital deck.
2. Dashboard: The user lands on a clean main screen with three clear choices: "Case Files," "Oracle's Outcome," and "Reading Replay," along with access to their "Master Journal."
3. Mode Selection: The user chooses a mode to begin their practice session.
4. The Reading: Within any mode, the user is presented with a scenario. They proceed to the Reading Interface to shuffle, draw cards, and lay them out in a chosen spread.
5. Interpretation & Feedback: The user types (or voice records) their interpretation. They then submit it to receive their "feedback" (revealing the Hidden Insight, the scenario Outcome, or a future information update).
6. Journaling: The app prompts the user: "Would you like to save this reading to your Master Journal?" The complete reading is saved for future review.
4. Feature Breakdown
* 4.1. Dashboard
    * Clean design following the specified aesthetic.
    * Three prominent buttons for the three modes.
    * A persistent icon/link to the "Master Journal."
    * A "Settings" icon (for deck selection, notifications, etc.).
* 4.2. Mode 1: Case Files (Deep-Dive Practice)
    * A scrollable library of cases, displayed as cards with a title and theme tags.
    * User Flow: Select Case -> Read Scenario -> Perform Reading -> Submit Interpretation -> Tap "Reveal Hidden Insight" -> Compare interpretation to the revealed insight.
* 4.3. Mode 2: Oracle's Outcome (Predictive Practice)
    * Presents a scenario with 2-4 distinct paths (A, B, C).
    * User Flow: Read Scenario -> Perform Reading -> Select the path you advise -> Tap "Lock In & Reveal Outcome" -> The app reveals the narrative consequences of that path.
* 4.4. Mode 3: Reading Replay (Nuance Practice)
    * A list of "in-progress" readings.
    * User Flow: Select a new Replay prompt -> Perform Reading -> Submit Interpretation.
    * Push Notification System: After 24-48 hours, a notification alerts the user to "new information" regarding their reading.
    * The user reviews their original interpretation alongside the new context.
* 4.5. The Reading Interface
    * A virtual space to draw cards.
    * Deck Selection: A library of high-quality digital decks.
    * Spreads: A library of classic spreads (e.g., 3-Card, Celtic Cross) and a "Freestyle" option.
    * Tapping a card enlarges it for detailed viewing.
* 4.6. The Master Journal
    * A searchable and filterable archive of all saved readings.
    * Filter Options: By date, by mode, by theme, by cards that appeared, by keyword.
    * Annotation Feature: Users can add notes to saved readings.
* 4.7. Theming & Categorization
    * A core system for organizing all content.
    * Functionality: Allows users to filter existing cases or direct the AI to generate new cases based on a chosen theme.
    * Theme Categories: Career & Finance, Romance & Relationships, Family & Home, Personal Growth & Spirituality, Creativity & Projects, Health & Well-being.
5. Content Generation: The AI Story Architect
* A backend AI model will be prompted using a Master Blueprint to generate all scenarios.
* Blueprint Rules:
    1. Create a Relatable Character: Define a name, desire, and problem.
    2. Define the Stakes: Clarify what the character stands to gain or lose.
    3. Inject a Hidden Nuance: Every case must include a secret fear or motivation that serves as the "Hidden Insight."
    4. Ensure Tarot-Friendliness: The core question must be open-ended.
    5. Assign Theme & Difficulty: Tag every case with a theme and a difficulty level (Beginner, Intermediate, Master).