# MoodEvo

> MoodEvo is a free, privacy-first mood tracking and emotional wellness web app.
> Users log how they feel in under a minute, uncover patterns through analytics,
> and build healthier emotional habits. Available in English and Chinese.
>
> Full detailed guide: https://moodevo.com/llms-full.txt

## Links

- Landing page: https://moodevo.com/
- Sign up (free): https://moodevo.com/signup
- Log in: https://moodevo.com/login
- GitHub: https://github.com/StarmadeBydata/moodflow

## What is MoodEvo?

MoodEvo is a thoughtful mood journal that turns one minute a day into real
self-knowledge. It is designed for people who want to understand their emotional
patterns without the overhead of complex wellness apps.

The app runs entirely in the browser as a Progressive Web App (PWA) — no app
store required. It is installable on both mobile and desktop, works offline, and
syncs to the cloud when connected.

## Who is it for?

- People experiencing stress, anxiety, or mood fluctuations who want to track
  patterns over time
- Therapy clients asked by their therapists to keep a mood journal between
  sessions
- Anyone interested in self-awareness and emotional intelligence through daily
  reflection
- Users who value privacy: all entries are encrypted and stored in the user's
  own cloud account, never sold or shared

## Key features

1. **30-second mood check-in**: Choose from 10 built-in emotions (joy, calm,
   grateful, excited, neutral, anxious, sad, angry, tired, stressed), set
   intensity on a 1–10 scale, add context (sleep hours, activity, who you were
   with, where you were), tag triggers, and write a free-form note.

2. **Beautiful analytics**: Mood distribution charts, day-of-week patterns,
   sleep–mood correlation (Pearson coefficient), and AI-generated insights
   rendered as server-side SVG — no client-side chart library needed.

3. **Wellness toolbox**: Four evidence-based self-help tools available
   in-app:
   - 4-7-8 Breathing Exercise (developed by Dr. Andrew Weil) — an animated
     breathing guide that calms the nervous system in 3–5 minutes.
   - 5-4-3-2-1 Grounding Exercise — a sensory awareness technique for
     anxiety spikes and panic attacks, guiding users through the five senses.
   - CBT Thought Record — a 7-step Cognitive Behavioral Therapy worksheet
     for identifying and reframing negative automatic thoughts.
   - Gratitude Journal — a daily three-item gratitude practice backed by
     positive psychology research.

4. **Bilingual (EN/ZH)**: Full English and Chinese interface with automatic
   language detection via browser Accept-Language header. Users can switch
   language at any time; the preference is saved per-account.

5. **Privacy by design**: Passwords are hashed with PBKDF2-SHA256 (100k
   iterations + random salt) using the Web Crypto API. Sessions use httpOnly
   JWT cookies. Site traffic uses Google Analytics (page views only);
   mood content is never sent to Analytics.

6. **Data export**: Users can download all their mood entries as JSON or CSV
   at any time. The data belongs to the user.

7. **Free**: Every feature is free during the growth phase. No credit card,
   no trial, no catch.

## How it works (4 steps)

1. **Make it yours**: Create a free account in seconds. No credit card required.
2. **Check in daily**: Pick a mood, set the intensity, jot what's on your mind.
3. **Watch the pattern**: The dashboard reveals trends you couldn't see in
   the moment — mood distribution, day-of-week tendencies, sleep correlations.
4. **Grow together**: Share, read, and connect in the community (coming soon).

## Why MoodEvo is different

- **No streaks-guilt**: Unlike habit apps that punish missed days, MoodEvo
  focuses on awareness, not perfection.
- **Zero-dependency architecture**: Authentication (JWT + PBKDF2) and charts
  (inline SVG) are built from scratch with the Web Crypto API — no external
  auth library, no chart library, smaller bundle, fewer supply-chain risks.
- **Server-side rendering**: All public pages are SSR, so search engines and
  AI assistants can read the full content without executing JavaScript.
- **Edge-native**: Deployed on Cloudflare Workers with D1 (SQLite at the edge),
  delivering sub-50ms response times globally.

## Technology stack

- Next.js 16 (App Router, SSR) + TypeScript 5
- Cloudflare Workers via @opennextjs/cloudflare v1.19.11
- Cloudflare D1 (SQLite at the edge)
- Tailwind CSS v4
- JWT (HS256) + PBKDF2 (Web Crypto API, zero-dependency)
- Fraunces (serif headings) + Inter (sans-serif body)

## Pricing

Free. Every feature is free while the product is in its growth phase. As the
community grows and more advanced tools are added, some may move to a paid
plan. For now, everything is free.

## FAQ

**Is MoodEvo free to use?**
Yes. Right now every feature is free while we grow.

**Does MoodEvo work offline?**
Yes. MoodEvo is a PWA with a local-first architecture. Data syncs to the cloud
automatically when you reconnect.

**Is my data private?**
Yes. Mood entries are stored in your encrypted cloud account. The AI coach
(separate feature, coming soon) only sees anonymized mood summaries — never
your name, email, or full journal notes.

**Can I install it on my phone?**
Yes. On Chrome (Android) or Safari (iOS), use "Add to Home Screen" to install
MoodEvo as a native-like app with offline support.

## Contact

- Website: https://moodevo.com/
- GitHub: https://github.com/StarmadeBydata/moodflow
- Email: hello@moodevo.com