Mind Well
A quiet corner for your mind — short therapeutic games and light journaling, built with
Next.js (App Router), TypeScript, Tailwind CSS, and Prisma (SQLite).
Getting started
npm install
cp .env.example .env # then set SESSION_SECRET (see comment in the file)
npx prisma migrate dev
npm run dev
Open http://localhost:3000.
Email OTP (signup, forgot password)
No email provider is wired up yet. In development, verification codes are logged to the
server console and also returned in the API response, and the sign-up / forgot-password
pages surface that code directly in the UI so the flow is testable end-to-end without a
real inbox. Before shipping to production, wire up a provider (Resend, SendGrid, etc.) in
src/lib/otp.ts (deliverOtp) and stop returning devCode from the API routes.
What's implemented
- Auth — signup with email OTP verification, login (username or email), forgot
password with OTP + reset flow, JWT session cookies, route protection.
- Dashboard — badges, streaks, and game history.
- Games
- Animal Runner and Three Things (journaling, with month-end PDF export) are fully
playable.
- World Puzzle, Color Theory, Spin and Connect, Find the Word, and Anagrams are
scaffolded as routes with "coming soon" screens describing their planned mechanics —
see the project spec for full details on each.
Project structure
src/app — routes (pages + API routes)src/components — UI, auth, dashboard, and per-game componentssrc/lib — auth/session, OTP, streaks, badges, validation, shared helpersprisma/schema.prisma — data model
