MindMap – Mental Health Tracking Application

MindMap is a mental health Progressive Web App (PWA) for people managing anxiety, ADHD, bipolar, depression, and chronic migraines. It helps users record, visualize, and reflect on daily experiences.

Owner: Jonny Terrero (jonnyterrero/MindMap). OmniFlex may fork this repo under MIT + any signed IP agreement — there is no ownership transfer. See docs/OMNIFLEX_FORK_GUIDANCE.md.

Table of Contents

• Features
• Tech Stack
• Repository layout
• Getting Started
• Integration-ready modules
• Compliance
• License

Features

• Mood & Symptom Tracking – Log mood, anxiety, sleep quality, and physical symptoms with notes
• Routine & Medication Management – Schedule routines, track adherence, reminders (wiring still incomplete — see LAUNCH_READINESS_AUDIT.md)
• Analytics Dashboard – Trends and correlations
• Emergency & Support Tools – Crisis contacts and quick-access plans
• Weather Correlation – Local weather vs symptoms
• Offline-Ready PWA – Installable; limited offline use
• ML pipeline (research) – Separate ml/ package; not production-serving yet

Tech Stack

Layer	Choice
App	Next.js 15 (App Router) + TypeScript in frontend/
UI	Tailwind CSS, shadcn/ui, Radix, Lucide
Data	Supabase (Postgres) + tracked migrations in supabase/
Mobile shell	Capacitor (frontend/mobile, frontend/capacitor.config.ts)
ML	Python (ml/ — uv / pyproject)
Deploy	Vercel (frontend)

Legacy FastAPI/Streamlit prototypes are not the active path; backend/ is currently a placeholder.

Repository layout

MindMap/
├── frontend/          # Next.js PWA (canonical app) — run pnpm here
│   ├── app/           # App Router pages + API routes
│   ├── components/    # shadcn/ui + feature UI
│   ├── hooks/
│   ├── lib/
│   ├── e2e/           # Playwright
│   └── mobile/        # Capacitor assets
├── supabase/          # schema.sql + migrations + tests
├── ml/                # Research ML pipeline (not wired to prod yet)
├── backend/           # Placeholder (legacy FastAPI removed from active tree)
├── docs/              # Fork guidance, design notes
├── LAUNCH_READINESS_AUDIT.md
├── DEVELOPMENT_PLAN.md
└── LICENSE            # MIT — Copyright (c) Jonny Terrero

Getting Started

Prerequisites

• Node.js 18+
• pnpm
• Optional: Python 3.11+ + uv for ml/

Install & run (frontend)

git clone https://github.com/jonnyterrero/MindMap.git
cd MindMap/frontend
pnpm install
cp .env.example .env.local   # fill Supabase + keys
pnpm dev

Open http://localhost:3000.

pnpm build && pnpm start   # production locally
pnpm lint
pnpm exec playwright test  # e2e (when configured)

ML package

cd ml
uv sync
# see ml/README.md and ml/HANDOFF.md

Integration-ready modules

Safer to extract into a product fork (still subject to compliance):

Module	Location (approx.)	Notes
Routine / medication UI patterns	frontend/components, routine routes under frontend/app	Good UX candidates for OmniFlex companion features
Mood / symptom logging forms	frontend/app + form hooks	Port UI; do not reuse fake /api/v1 stubs as-is
Companion chat entry point	product backlog	Suggested UX; verify implementation status before forking
Design system primitives	shadcn components under frontend/components/ui	MIT-friendly reuse with attribution

Do not treat as production-ready without reading LAUNCH_READINESS_AUDIT.md: stub /api/v1/* APIs, unwired notifications, plaintext journal columns, incomplete account deletion.

Compliance

• Mental-health data can trigger HIPAA / SOC 2 obligations depending on deployment and BAA status
• Upstream MindMap and any OmniFlex fork must not ingest real clinical / NYU pilot datasets until each party’s compliance review is done
• Prefer synthetic data for UX work (routine dropdowns, companion chat entry)

License

MIT — see LICENSE. Copyright (c) Jonny Terrero.

MIT already allows commercial forks and derivatives with copyright notice retention. Any terms beyond MIT (attribution, upstream contribution, dataset/ML restrictions, revenue share) must be in a separate signed agreement before deeper OmniFlex integration.

---

Built for clarity over hype.