Skip to content

Repository files navigation

Dear Me

A reminder from someone who knows you best. From you. For you.

Dear Me is a mental wellness app that captures how you feel in the moment, your thoughts, emotions, and reflections, then intelligently resurfaces those memories during difficult times, grounding you with perspective from your own past self.

The core loop: Record > Reflect > Replay > Grow.

Inspiration

Dear Me started with my little sister. Every night before bed, she writes down one thing she's grateful for and drops it into her gratitude jar. Whenever she's going through rough times, she reads them back and it genuinely makes her feel better. Her own words from a better day shift her perspective in a way no advice or quote ever could.

That simple practice sparked a bigger question: what if you could do the same thing, but with your voice, your face, your emotions, and have AI help surface the right memory at the right time?

People don't need more advice or another meditation app telling them to breathe. They need to hear from the one person whose perspective they can't dismiss: themselves.

Features

Feature Description
Record Capture video or text memories with a single tap. Speak from the heart, your future self is listening.
AI Analysis Automatic transcription, mood detection, and emotional indexing powered by Google Gemini.
Replay AI-matched memories resurface when you need them most. "You've felt this before... and you got through it."
Insights Conversational AI chat about your emotional journey. Ask questions, see mood trends, discover patterns.
Progress Reflection streaks, weekly calendar, and personalized AI insight cards that celebrate consistency.
Memory Detail Full transcript, mood tags, personal notes, and video playback for every memory.

Tech Stack

Getting Started

Prerequisites

Setup

  1. Clone the repo
git clone https://github.com/your-username/DearMe.git
cd DearMe
  1. Install dependencies
npm install
  1. Create your environment file

Copy .env to .env.local and fill in your credentials:

cp .env .env.local

Required variables in .env.local:

NEXT_PUBLIC_SUPABASE_URL=<your-supabase-project-url>
SUPABASE_ANON_KEY=<your-supabase-anon-key>
SUPABASE_SERVICE_ROLE_KEY=<your-supabase-service-role-key>
GEMINI_API_KEY=<your-gemini-api-key>
  1. Run the dev server
npm run dev

Open http://localhost:3000 in your browser.

Scripts

Command Description
npm run dev Start development server
npm run build Create production build
npm run start Serve production build
npm run lint Run ESLint

Project Structure

src/
├── app/                    # Next.js App Router pages + API routes
│   ├── page.tsx            # Home: greeting, mood check-in, recent memories
│   ├── record/             # Video recording flow
│   ├── processing/         # AI processing transition
│   ├── review/             # Review & save recorded memory
│   ├── save/               # Save confirmation
│   ├── replay/             # Replay hub + individual replay playback
│   ├── replay-trigger/     # Emotional matching entry point
│   ├── memory/[id]/        # Memory detail view
│   ├── insights/           # AI chat about emotional journey
│   ├── progress/           # Streaks, calendar, AI insight cards
│   ├── profile/            # User profile
│   └── api/                # Server-side API routes
│       ├── session/        # Session management
│       ├── memory/         # CRUD for individual memories
│       ├── memories/       # List + similar memory matching
│       ├── upload/video/   # Video upload handling
│       ├── analyze/video/  # AI analysis (transcription + mood)
│       ├── insights/chat/  # Conversational insights AI
│       ├── chats/          # Chat thread persistence
│       └── stats/          # User stats + streaks
├── components/
│   ├── layout/             # RootLayout, StatusBar
│   └── ui/                 # GlassCard, MoodChip, PrimaryButton, etc.
├── lib/                    # Supabase client, utilities
├── services/               # API client, route state, video store
└── types/                  # TypeScript type definitions

Design Philosophy

Dear Me frames itself as mental fitness, not mental illness, an ongoing practice of emotional awareness, like going to the gym for your mind. The design is deliberately warm: soft olive/sage palette, glassmorphism cards, organic shapes, and copy that feels like a letter to yourself.

Built with care. From you, for you.

For the full product vision, design system, and feature specs, see PRD.md.

About

For Future Me — mental wellness app with Gemini AI

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages