Home / Product / Consumer App

Affirmology App Experience - Vision & Prototype Notes (v1)

Updated Jul 12, 2026 · Affirmology_AppExperience_Vision_v1.md

Affirmology App Experience - Vision & Prototype Notes (v1)

Date: 2026-07-07. Captures Jeff's direction for the app's next revisions: the constellation "journeys" explore mode, oracle animation, and how to mock up layout/navigation. Prototype lives at Product/ConstellationJourney/index.html.

The core idea: Journeys to Self as a constellation you build

• Each starter audio is a STAR. Listening fills it (e.g. 7 listens = fully lit). Morning identity audio, blueprint visualization, heart-coherence, tapping, your reading, sleep track = the six stars of the first constellation, "The Origin."
• When every star in a constellation is lit, the CONSTELLATION COMPLETES and unlocks a reward.
• REWARD (built into the prototype): choose a SPIRIT GUIDE from the oracles. The chosen oracle replaces Sophia as the main voice in the chatbot.
• The sky is SCROLLABLE / draggable. Beyond the Origin sit other constellations = future "journeys to self" (Wealth Codes, Relationships, Deep Rest, Purpose, and more). Locked until earned. "Finding edges in space" - the map can keep growing; eventually many more can exist.
• This is ONE way to explore. It is not the only navigation. See "Traditional modes" below.

What the prototype already does (Product/ConstellationJourney/index.html)

Interactive, in-brand (emerald/gold, Cinzel/Cormorant, starfield, GSAP motion). Tap stars to add listens (ring fills, 7 = lit), connecting gold lines draw between lit stars, completing the Origin fires a reward modal to pick a spirit guide (real oracle busts), and the bottom chat bar's guide + prompt swap to the chosen oracle. Drag / wheel / arrows to pan to the locked future journeys. "Demo: complete the Origin" button auto-fills for a fast walkthrough. This is a clickable spec, screen-recordable for the investor/app video.

Oracle animation (wanted next)

• CHATBOT FACE ANIMATIONS: short looping close-up clips of the active guide's face - glowing gold eyes, subtle head movement, the "living statue" breathing - played as the chat avatar. We proved single-face animation works (the Prometheus face test). Each guide gets a ~4-6s idle loop; optionally a "speaking" variant.
• FULL-BODY ORACLE MOMENTS: places where a full oracle scene plays - e.g. the spirit-guide reveal, an ambient "council chamber" backdrop, a loading/wait state, or a domain intro. Reuse the room animations (Atlas + Sophia at the astrolabe, the council ring, etc.) and build per-oracle full-body idle loops as needed.

Chat-avatar loops - BUILT (2026-07-10)

Six main guides animated as small looping chat avatars: Product/ConstellationJourney/chat-avatars/{sophia,prometheus,athena,hermes,sri-agastya,pythagoras}.mp4 (5s, 720p, 1:1, silent - glowing eyes, slow blink, subtle head movement, breathing). Small by design for in-app use. Loop as the active guide's avatar in the chatbot. Next: a "speaking" variant per guide, and avatars for the rest of the roster as needed.

Interstitial oracle "intro" scenes (wanted, teaser)

Short in-between screens/scenes that show 1-few oracle characters WITH THEIR NAME, to build familiarity and tease the cast (e.g. loading transitions, journey intros, first-run onboarding). Reuse the room/full-body animations + a typeset name card. Builds the pantheon in the user's mind over time.

SIGNATURE TRANSFORMATION principle (2026-07-11, Jeff) - SUPERSEDES eyes-only

The eye ignite alone is TOO SUBTLE to read at chat-avatar size. The chatbot activation must be a VISIBLE, whole-avatar TRANSFORMATION: resting -> wild on activate, and wild -> resting on finish. Sophia is the model: her starlight hair blazes out when she speaks and settles back when she is done (sophia_activate_resting_to_wild.mp4 / sophia_return_to_baseline.mp4). That is the experience we want for every oracle. The eye glow stays, but as a supporting detail inside the bigger move, not the move itself. - EVERY oracle needs its own signature "wild" state and a two-way transition (activate + return). Ideas per guide: Prometheus's fire crown flares; Hypnos's cloak/shadows unfurl; Persephone splits cream/black; Lakshmi's gold blooms/coins spark; Chiron's kintsugi scars light; Eros's heart-spark ignites; Trismegistus/Thoth's glyphs and gold particles swirl. - The existing Product/OracleAvatars/*_beacon.mp4 (eyes-only) files stay as a low-key fallback, but the transformation pair is the target.

Eye-beacon principle (2026-07-10, Jeff) - now a SUB-DETAIL of the transformation

Every oracle needs TWO eye states: RESTING (normal, non-glowing marble eyes) and ACTIVE (glowing gold eyes). The eyes IGNITE from resting to glow when the oracle is listening/speaking, and dim back when done. Build each avatar as a matched pair (identical frame, eyes-only difference) so the ignite is a clean start→end interpolation, same technique as Sophia's hair drift. Example built: Council/OracleSheets/Hermes forms/Trismegistus_cream_wizard_resting.png + _glow.png. NOTE: Sophia's current v2 stills are glow-eyes only; add a resting (non-glow) twin when we resume so her beacon works too. - Hermes Trismegistus (Maya astrology guide) is the CREAM wizard with a proper POINTED WIZARD HAT (like the blue version's hat shape), recolored cream/white so it doesn't clash with the emerald app. The earlier plain cream version read like a pope mitre, rejected. Thoth is locked as-is. - THOTH MOTION (2026-07-10, Jeff): Thoth's beacon should have him MOSTLY LOOKING TO THE RIGHT (ibis profile reads best), with slight head movements, as the eyes ignite. Updated Product/OracleAvatars/thoth_beacon.mp4 accordingly. - SMOKE-POOF SHAPE-SHIFT (2026-07-12, Jeff, SUPERSEDES the morph below). Hermes is ONE being with TWO faces: the WIZARD (front-facing) and THOTH (shoulders front, head in full RIGHT profile like an Egyptian hieroglyph). There is NO front-facing Thoth, ever. The transition is NOT a morph: a quick puff of magic smoke and gold dust fully CONCEALS the figure, and when it clears the other form is standing there. No face melting, no head rotating. The poof is quick; the REST on each still is long, so the viewer registers each figure. Stills are framed to overlay exactly. Assets + wiring: Product/OracleAvatars/README_Hermes_Thoth_CodeHandoff.md (stills Trismegistus_cream_wizard_glow.png + thoth_bust_profile.png, clip hermes_poof_wizard_to_thoth.mp4, prebaked hermes_thoth_poof_loop.mp4). Rests are sequenced IN CODE so they stay tunable. Intro line depends on the session's starting form: "I am Hermes, sometimes known as Thoth," or the reverse. FUTURE: Quetzalcoatl gets the same smoke treatment as a RARE visual easter egg, never mentioned in chat copy; possible spirit-guide unlock later. - FORM-MORPH TRANSITIONS (2026-07-10, superseded by the smoke poof above): build a morph animation BETWEEN the wizard (Trismegistus) and Thoth as a variation - one being shape-shifting, gold particles along the kintsugi veins. Reversible (play backwards for Thoth->wizard), and if Thoth ends up the more-present form, run it Thoth->wizard by default. Built: Product/OracleAvatars/hermes_wizard_to_thoth_morph.mp4. EVENTUALLY (future): extend the same morph so Hermes can also transition into the QUETZALCOATL and ATLANTEAN-KING forms - the same shape-shift language, one being becoming its other cultural faces.

Guide casting / roles (2026-07-10, Jeff)

• HERMES has three forms, split by role: the GREEK WINGED HERMES = administrative / messenger tasks and INSIDE the Atlas (creator studio) system, in his messenger role. For the MAYA chatbot (astrology, the reading), use the mystical forms: TRISMEGISTUS (CREAM/WHITE, not blue, the blue clashes with the app's deep emerald) and THOTH. All three should appear roughly equally across the product, just in their fitting contexts.
• INTERFACE PERSONAS (idea): APOLLO (the conductor/critic) as the voice of SYSTEM FEEDBACK / quality / "what changed, how you're doing." ATLAS (the whole system) as a SYSTEM-STATUS / overview / home/settings persona, the one who holds the structure. Turning a couple oracles into functional interface characters, not just chat guides.
• Most-likely-used guides to animate first (wealth/relationships/sleep/healing/transformation are common asks): Sophia (done), Lakshmi (wealth codes), Eros (relationships), Hypnos (sleep/subconscious), Chiron (healing), Persephone (transformation); Apollo/Atlas/Concordia optional.

Traditional modes (this is not the only way in)

The constellation sky is the immersive/exploratory layer. Alongside it, keep conventional ways to FIND or CREATE audios: - A LIBRARY / LIST view (search, filter, recents, favorites) for people who just want a list. - A CREATE flow (pick a theme/goal, generate a new personalized audio). - The constellation map and the list are two lenses on the same underlying audio catalog.

How to explore app layout / navigation for the next revisions

Recommended approach: build a small set of clickable, in-brand HTML mockups of the KEY screens so we can feel the flow before committing to dev: 1. Home / today (what greets you, the daily cue). 2. Library / list mode (find an audio). 3. The Journeys sky (this prototype) as the explore mode. 4. Player (with the animated oracle avatar + soundwave). 5. Chat with the animated oracle guide. 6. Create-your-audio flow. 7. Profile / your blueprint. Then a simple nav model tying them together (tab bar or orbit menu). We iterate on these mockups, pick directions, and hand the winner to dev. Same technique as this prototype (single-file HTML, real assets), so each screen is demoable and screen-recordable.

Open questions / decisions

• Listen threshold per star (7?) and whether it varies by audio.
• Can a guide be re-chosen later, or is it a meaningful one-time-per-journey ritual?
• How constellations are themed/earned (linear vs. pick-your-path).
• Whether the sky is finite (curated set) or "infinite edges" that keep generating.

Affirmology_AppExperience_Vision_v1 - prototype: Product/ConstellationJourney/index.html. Logged for the app-revision work.