Product Overview & Architecture
DreamStream is a high-performance, native-first dream journal and analysis engine. This page provides a high-level map of how the app works for product and marketing teams.
🎯 Core Philosophy
DreamStream helps users bridge the gap between their waking and subconscious lives using a three-pillar approach:
- Immersive Capture: Frictionless text and voice logging with native haptics.
- AI Intelligence: Meaningful analysis and Jungian reflections powered by Google Gemini.
- Visualization: Bringing dreams to life through stunning AI artwork and comics.
🛣️ The User Journey
flowchart TD
A["**Wake Up**"] --> B["**Log Dream** (Native Voice/Text)"]
B --> C["**Cloud Sync** (Database + Queue)"]
C --> D["**AI Magic** (Insights + Art)"]
D --> E["**Reflect & Grow** (Chat + Visuals + IRT)"]
style A fill:#9333EA,stroke:#fff,stroke-width:2px,color:#fff
style D fill:#A855F7,stroke:#fff,stroke-width:2px,color:#fffNew Hires
If you are new to the product, start by creating a "Lucid" dream entry in the staging environment to see the full AI pipeline in action.
🧱 The Building Blocks (Data Model)
The unit of experience. A collection of user narrative and AI-generated media.
| Field | Purpose | AI Generated? |
|---|---|---|
| Story | The core narrative | No |
| Type | Lucid, Nightmare, etc. | No |
| Insight | Psychological analysis | Yes |
| Visuals | Art, Comics | Yes |
| Archetype | Jungian labeling | Yes |
The "Long-term Memory" of the app.
| Field | Purpose | Sync? |
|---|---|---|
| Digital Twin | Face reference for art | Yes |
| Known People | Personal relationship map | Yes |
| Dream Persona | Synthesis of past dreams | Yes |
Background workers that do the heavy lifting.
| Status | Meaning |
|---|---|
pending |
In the queue |
processing |
AI is thinking/drawing |
completed |
Results are ready |
📂 Implementation Map
For developers and technical product managers, these are the core files:
- Logic Orchestration:
App.tsx - Data Schemas:
types.ts - Native Bridge:
src/services/nativeService.ts - AI Worker:
supabase/functions/process-generation-jobs/index.ts