Walk With Me

Help people with ADHD actually get up and walk, without relying on willpower or remembering a schedule.

The product's job is narrow: cross the gap between "I should go for a walk" and "I'm actually walking." Pick a tiny walk (5/10/15 minutes), get a gentle reminder, walk, and celebrate — no guilt, no harsh streaks, no dashboard clutter.

Repository layout

Path	What it is
backend/	FastAPI + PostgreSQL backend: auth, walks, reminders, adaptive reminder engine, gamification (XP/levels/quests/achievements/rewards).
mobile/	React Native (Expo SDK 57) + TypeScript client: onboarding, home, walking timer, completion, progress, notifications, garden gamification.
Basic_info.txt, Full Plan.txt	Original product brief and plan.

Quick start

Backend

cd backend
cp .env.example .env          # set a real JWT_SECRET_KEY + DATABASE_URL
uv sync
uv run alembic upgrade head
uv run uvicorn app.main:app --reload
# API docs: http://localhost:8000/docs

Or with Docker: docker compose up --build

Mobile app

cd mobile
cp .env.example .env          # set EXPO_PUBLIC_API_URL=http://localhost:8000
npm install
npx expo start                # press a / i, or scan the QR with Expo Go

Android emulator note: unset EXPO_PUBLIC_API_URL or set it to http://10.0.2.2:8000 (the app defaults to that automatically). For a physical device, point EXPO_PUBLIC_API_URL at your machine's LAN IP.

Tests

• Backend: cd backend && uv run pytest
• Mobile unit/component: cd mobile && npm test
• Mobile end-to-end against the real backend: cd mobile && npm run test:integration