We Built an AI Wellness App That Knows What You Need Before You Do
How Appic Softwares engineered Harmoni: a behavioral intelligence platform that turns mood data, dream logs, journal entries, and astrological context into recommendations that feel genuinely personal.
17+
AI-powered screens
6
AI models integrated
12 wks
End-to-end delivery
360°
Wellness coverage
Not another meditation app. Something actually different.
Lynsey Whitehill came to us with a clear frustration: most wellness apps feel good for a week, then flatten into static playlists. You pick a category, press play, and the app forgets everything you just felt yesterday. Harmoni was designed to reverse that pattern by treating personalization as a system, not a label.
The brief was ambitious by design: combine meditation, dream analysis, astrology, and journaling into one loop that keeps learning. That meant solving not only UX flow problems, but model routing, latency control, tone consistency, and memory architecture.
If you are scoping a comparable build, our astrology app development page covers chart integrations, personalization, and scale patterns. For mental-health-adjacent and regulated delivery contexts, see healthcare software development.
Industry
Mental health, mindfulness & energy-wellness
Product type
AI-native mobile wellness platform (B2C)
Platforms
iOS & Android (Flutter, single codebase)
Positioning
Meditation + journaling + sleep + astrology + community
Client
Lynsey Whitehill
Our role
Product engineering, AI orchestration, admin/ops layer
AI & data
Multi-LLM routing, voice STT/TTS, vector memory (ChromaDB / Pinecone), AstroSeek
Commercial model
Tiered subscriptions (e.g. monthly lite vs annual plus), payments & entitlements
Why do most AI mental health apps stop working after week two?
This is the question we started with. Not what features to add, but why people abandon apps they initially like. That is the same retention challenge we address across healthcare software development style engagements: the product must earn trust with how it handles sensitive journeys.
Static content with a personalization label is still static content. Users figure that out fast.
Static content disguised as personalization
Users churn when day thirty feels like day one. Without semantic memory and cross-feature context, recommendations repeat and trust drops fast.
Configuration mistaken for intelligence
Choosing a goal at signup is not personalization. Harmoni treats onboarding as calibration: mood, healing intent, dream patterns, friction points, and astrological baseline.
Retention loops that depend on guilt
Badges and streaks help when they mirror real progress. Harmoni pairs gamification with meaningful signals: streak quality, mood arcs, saved interpretations, and community participation, not empty counters.
No behavioral feedback loop
Mood, dreams, journal patterns, and astrological context are usually siloed. Harmoni intentionally connects those signals so each action sharpens the next recommendation.
The AI personalization engine we designed from scratch
We built Harmoni as an interconnected intelligence loop where each user action makes every future recommendation more relevant. The astrology layer follows the same integration discipline we describe on our astrology app development page: chart-grade inputs, live ephemeris, and recommendations that stay tied to the user, not generic copy.
Layer 01
Emotional Intelligence Intake
Onboarding captures current mood, healing focus, recurring dreams, blockers, disconnection triggers, and what the user is craving more of. Birth place, date, and time seed chart-grade astrology. This generates the first personalized output: a Wellness Starting Point with emotional theme, astrological context, and a recommended action.
Layer 02
Multi-LLM Processing Core
Tasks are routed by model strength. GPT-class generation handles scripts and prompts, Claude-class passes sharpen emotional nuance, Gemini-class processing helps multi-signal synthesis, Deepgram handles voice ingestion, ElevenLabs powers narration, and AstroSeek provides chart/transit data.
Layer 03
Long-Term Memory and Pattern Recognition
Journal entries and dream logs are embedded in ChromaDB/Pinecone to support semantic recall over time. This lets Harmoni detect recurring symbols, emotional drift, and repeated themes across weeks, then surface meaningful insights instead of random content.
How we structured 12 weeks without losing the thread
In personalized AI products, every layer depends on every other layer. We phased delivery to isolate dependencies and keep quality predictable.
Phase 01
Documentation, requirements, and architecture
Requirements and technical specifications were locked before implementation. We mapped auth, onboarding, paywall, five-tab IA, community guardrails, and data contracts early to avoid downstream integration conflicts.
Phase 02
UI/UX in Figma and emotional journey design
Core flows were designed in Figma: calibration journey, Wellness Starting Point, meditation setup, dream capture and analysis, progress views, and community participation paths.
Phase 03
Core build across app, backend, and admin
Flutter mobile app, Python backend, PostgreSQL schema, and React admin panel were delivered as one cohesive baseline before AI orchestration was connected.
Phase 04
Full AI stack integration
OpenAI, Claude, Gemini, Deepgram, ElevenLabs, AstroSeek, and vector memory were integrated with async processing, model routing, and prompt controls for tone consistency.
Phase 05
QA, deployment, and handoff
Cross-device QA, release hardening, production deployment, source handoff, and post-launch support completed the delivery cycle.
Technical architecture and personalization flow
Flutter powers the mobile layer, Python orchestrates AI workflows, PostgreSQL anchors transactional data, and vector memory keeps long-term context searchable. That stack lines up with how we ship healthcare software development projects: auditable data paths, operational tooling, and room to grow compliance requirements as the product matures.
| Mobile | Flutter · Material/cupertino adaptive UI · offline-friendly reads |
| Backend | Python · REST · async workers · idempotent webhooks |
| Data | PostgreSQL · ChromaDB / Pinecone · encrypted PII boundaries |
| Admin | React · operational dashboards · support & content tooling |
| AI & voice | GPT-class generation · Claude-class empathy passes · Gemini-class fusion · Deepgram STT · Wav2Vec2 affect · ElevenLabs TTS · AstroSeek ephemeris |
| Growth | Tiered subscriptions · card & wallet payments · contextual push notifications |
Personalization pipeline (conceptual)
Mood state, onboarding calibration, journal/dream embeddings, session completions, and ephemeris snapshots are merged into a context envelope. A router selects the generating model (and emotional fallback), while workers enqueue long outputs - sleep narrations, deep chart copy, multi-step interpretations - so screens stay responsive.
Turning features into flows: the AI-driven wellness journey
Features are easy to list. What matters is whether each step naturally leads to the next and whether the intelligence layer improves the experience instead of interrupting it.
Account, trust & onboarding
- Multi-step registration: identity, credentials, locale/contact, profile photo, terms acceptance, mirroring how regulated wellness products capture informed consent.
- Email OTP/password reset with resend throttling to reduce support load.
- First-run story selling three outcomes: AI-personalized meditations, reflective journaling with voice, and healing sleep stories, each skippable to respect returning users.
- Mood-first calibration (e.g. angry / sad / happy / sleepy) and depth questions on healing intent, recurring dreams, blockers, disconnection contexts, and life cravings.
- Optional birth-chart intake: place, date, time, explicit “unknown birth time” path to avoid drop-off.
- Wellness Starting Point card synthesizes emotional focus, daily astro energy, detected themes, and paired actions (short meditation + reflective prompt).
Home & daily check-in rhythm
- Returning-home pulse: “How are you feeling today?” with quick affect tags feeding the personalization graph.
- Hero recommendations blend beginner paths (e.g. “Meditation 101”) with modality-specific deep work (e.g. chakra sessions) annotated with mood tags.
- Daily check-in module with week-strip sentiment visualization and reflective yes/no questions.
- Bridge from check-in to dreams (“Did you dream last night?”) and into journaling when emotions need narrative, not just a mood tap.
Meditation studio
- Searchable meditation catalog with category and duration filters; thematic series spanning shadow work, chakra balancing, manifestation, inner-child healing, energy cleansing, higher-self dialogue, ancestral/karmic themes, and pure sound-first calm.
- Per-session configuration: selectable duration presets, guided voice profile (e.g. gender/accent), session language, and immersive background bed (forest, tropical, desert, mountain palettes, etc.).
- Playback UX with progress, ambient swap, and hooks to log post-session mood, closing the feedback loop for ranking future sessions.
Guided journaling engine
- Library of depth prompts (shadow work, energy check-ins, inner-child letters, synchronicity reflections) with chronological history cards.
- Text plus voice capture with “start recording” affordances, critical for users who process aloud.
- Tight integration: prompts can be suggested straight from Wellness Starting Point and daily mood graphs, keeping journaling adjacent to meditation rather than siloed.
- Sentiment strip mirrors check-in data so users see language patterns alongside mood trends.
Sleep audio & dream lab
- Sleep hub splits into long-form relaxation mixes, labeled sleep music, and narrative sleep stories filterable by relaxation / spiritual / nature.
- Dream intake supports rich text or voice dictation, then AI interpretation with symbolic and psychological framing; users can save analyses into a personal archive.
- Saved dream list for revisiting motifs over months; ideal input for vector search (“show me every wolf/water motif across my logs”).
Astrology hub
- Sun-sign forecasts with copy tuned to therapeutic tone; CTAs into recommended meditations that match the forecast theme.
- Birth chart screen with structured fields (e.g. symbol, ruler, house, element, modality) plus long-form interpretation bridging natal placements with growth language, fed by live ephemeris (AstroSeek-class integrations).
- Astrological insight cards surface in onboarding and progress views so astro is always action-linked, not decoration.
Progress, streaks & motivation
- Calendar+list history for mood check-ins with timestamped states (angry, happy, confident, etc.).
- Session streak matrix marking completed / incomplete / skipped days, with honest reflection instead of toxic perfection.
- Stacked activity analytics contrasting sleep listens vs. meditation minutes across the week.
- Badge system organized by practice type: consistency streaks, total meditation minutes, deep-duration milestones, first journal entry, chart completion, mood-check milestones.
- Leaderboard prioritizes sustainable practice metrics (e.g. minutes + consistency) rather than vanity spam.
Community, resources & operations
- Community feed with stories, reactions, threaded comments, edit/delete, search, and media attachments.
- Anonymous question lane for sensitive topics, essential for mental-health-adjacent social layers.
- Curated Resources directory (telehealth partners, energy-work institutes, educators) plus editorial blog rails for SEO and reactivation.
- Notification center with context-rich nudges: chakra rebalance, journal streak rescue, personalized sleep story, forum replies.
- Profile center bundles subscription tier, badge progress, quick jumps to mood/astro/dream/progress modules, and support/contact surfaces.
- Monetization: tier cards (e.g. Harmony Lite monthly vs Harmony Plus annual), checkout summary, multi-rail payments.
Retention logic, engagement loops, and monetization readiness
Business outcomes were designed into the product from day one, not added at the end.
Retention through compounding context
Each modality feeds shared memory: a dream symbol referenced in a sleep story, a journal paragraph influencing the next meditation intro. That cross-linking is the product moat commodity wellness catalogs cannot copy without rebuilding architecture.
Habit integrity without shame
Skipped-day visibility and honest streaks meet users where they are. Badges reward restorative depth (long sessions, vulnerable journaling) rather than mindless taps, reducing churn from burnout.
Community that respects vulnerability
Anonymous posting and moderated feeds reduce performative wellness culture. Engagement shows up in comments and saves, giving Harmoni qualitative signal on what themes deserve new prompt packs or audio series.
Monetization ready on launch
Tiered plans, promotional savings on annual commits, and payment rails mean marketing can iterate pricing without a rewrite. Admin-side reporting ties revenue to engagement cohorts.
What founders building AI-powered mobile apps should know
01
Treat onboarding as training data, not paperwork
The first three minutes must feel like a conversation. That is when users reveal affect, blockers, and language. Harmoni’s calibration directly seeds astrology, prompts, and audio; if this step feels like a form, downstream AI will always feel hollow.
02
LLM routing is a clinically informed product choice
One model cannot simultaneously handle symbolic dream analysis, CBT-flavored grounding copy, and chart-flavored storytelling. Routing models by task preserves tone and reduces failure modes when context length explodes.
03
Vector memory is the difference between gimmick and guidance
Keyword tags miss nuance; embeddings catch metaphor, recurrence, and emotional drift. Without vector recall, “personalization” regresses to random scheduling.
04
Async generation is how luxury UX meets model latency
Narration-heavy sleep journeys and long interpretations cannot block UI threads. Queue workers, partial streaming, and optimistic placeholders keep the app feeling instant while quality renders in the background.
05
Safety and consent are part of the feature spec
Dream and journal content is sensitive. Retention policies, delete-account paths, export thinking, and clear consent on analytics are not compliance footnotes; they affect whether users trust the loop enough to return.
Questions founders ask when building AI-native wellness apps
Practical answers from shipping Harmoni’s calibration layer, dream intelligence, community trust model, and payment stack.
How does Harmoni remember users across sessions?
Structured profile data (mood history, onboarding answers, chart inputs) sits in PostgreSQL, while qualitative entries from journaling and dreams are embedded into a vector store for semantic recall. Retrieval-augmented prompts let models cite the user’s own language instead of generic platitudes.
Why invest in both speech-to-text and text-to-speech?
Voice removes friction during emotional spikes; users journal or log dreams when typing feels inadequate. High-quality TTS keeps 30-45 minute sleep journeys immersive without licensing thousands of static files.
Is astrology decorative in Harmoni?
No, it is wired into recommendations. Forecast copy, chart metadata, and onboarding timing feed the same router meditations and prompts use. If astrology were only a tab, it would not improve retention; here it is part of the context graph.
How do you handle sensitive community content?
Anonymous posting, user-owned edits/deletes, reporting hooks, and rate limits are built into the community MVP so trust scales. Ops teams get visibility via the admin layer without exposing private journal data.
What monetization primitives were shipped?
Tiered subscriptions with surfaced savings on annual plans, checkout summaries, and multi-method payments. Entitlements gate premium audio, deep interpretations, or plus-tier community features depending on product rules.
How long did delivery take?
Twelve weeks across five phases, from systems design through AI integration and store-ready QA, precisely because changing the sequencing would have created integration risk between charts, vectors, and payments.
Building a wellness product that has to feel emotionally intelligent?
We design and ship behavioral AI systems where intelligence does real work. If your product needs more than a model wrapper, let us map what it takes end to end.
Share Your Ideas Here!
We are all ears!