A minimalist, privacy-first mobile emotion tracking application built with React Native and Expo SDK 57, designed specifically for Android 14 (Google Pixel 5).
Inspired by the Yale Center for Emotional Intelligence's Mood Meter (How We Feel), the app provides a quiet, intentional space to label emotions with granular precision, track somatic sensations, and build emotional awareness throughout the day.
- Yale Mood Meter Taxonomy:
- 4 Quadrants: High/Low Energy × Pleasant/Unpleasant (Red, Yellow, Blue, Green).
- 144 granular emotion words complete with definitions (36 emotions per quadrant across Anxious, Joyful, Serene, Melancholy, Peaceful, and more).
- Contextual & Intensity Awareness:
- Emotion intensity rating (1–10 scale).
- Context tagging (Who: Alone, Friends, Family, Partner, Coworkers, Classmates, Clients; Where: Home, Work, School, Transit, Outdoors, Gym, Cafe/Restaurant).
- Literary Editorial Design:
- Minimalist, magazine-inspired aesthetic with Plus Jakarta Sans typography and clean layouts.
- Warm editorial cream aesthetic (
#FEF9EE) with Yale Mood Meter quadrant accent colors. - Chronological journal timeline displaying quote reflections, emotion badges, and organic illustrations.
- 100% Private & Offline-First:
- All check-ins and reflections are stored strictly on-device in a local SQLite database (
emotion_tracker.db). - Zero third-party telemetry, tracking, or cloud dependencies. Your emotional life remains entirely on your device.
- All check-ins and reflections are stored strictly on-device in a local SQLite database (
| Component | Technology | Version |
|---|---|---|
| Framework | Expo SDK | ~57.0.20 |
| Runtime | React Native / React | 0.86.3 / 19.2.3 |
| Language | TypeScript (Strict) | ~6.0.3 |
| Local Storage | expo-sqlite |
~57.0.2 |
| Target Platform | Android 14 (Google Pixel 5) | com.willwang.emotiontracker |
- Node.js (v18 or higher recommended) & npm
- Android device connected via USB with USB Debugging enabled, or an Android emulator
# Clone the repository
git clone https://github.com/willwang93/emotion-tracker.git
cd emotion-tracker
# Install dependencies
npm install# Start the Metro bundler
npx expo start
# Run the app directly on your connected Android device
npx expo run:android
# Run TypeScript type check
npx tsc --noEmit├── App.tsx # Root layout, date navigation, timeline feed, state orchestration
├── app.json # Expo project configuration & native Android permissions
├── src/
│ ├── components/ # UI Components
│ │ ├── MicroCheckInModal.tsx # Multi-step check-in wizard (Mood Meter -> Nuance -> Intensity -> Context -> Note)
│ │ ├── TimelineCard.tsx # Editorial journal cards with emotion badges & notes
│ │ └── ui/ # Token-locked design primitives (AppText, AppButton, AppCard, AppChip, AppTextInput, AppModalLayout)
│ ├── constants/
│ │ └── moodMeter.ts # Yale Mood Meter taxonomy (144 emotions with granular definitions)
│ ├── services/
│ │ └── db.ts # expo-sqlite initialization, CRUD queries, database migrations
│ ├── theme/
│ │ ├── ThemeContext.tsx # React Context provider & useAppTheme hook
│ │ └── index.ts # Theme tokens (editorial cream)
│ └── types/
│ └── index.ts # TypeScript interfaces (CheckIn, QuadrantType, EmotionItem)
├── stitch/ # Google Stitch design prototype exports, tokens, and screen mockups
└── android/ # Prebuilt native Android project (SDK 34 / Android 14)
MIT