HabitQuest

HabitQuest is a hackathon MVP for a conversation-first wellbeing coach. Its core promise is simple:

When you do not know what to do right now, HabitQuest gives you 3-5 realistic actions in seconds.

The agent is the product. The dashboard is a companion view. Supabase is the source of truth for auth, plans, check-ins, completions, and conscious permissions.

Current product direction

HabitQuest is not trying to be a heavy habit tracker. It is a lightweight decision helper for people who feel stuck, tired, or overloaded and need a next step.

The MVP loop:

1. Enter the demo with anonymous auth.
2. Complete a short conversational setup.
3. Ask the coach for a realistic plan.
4. Complete concrete actions.
5. Unlock conscious permissions through readable rules.
6. Check in again when energy, stress, or time changes.

Portfolio highlights

• Conversation-first UX: the coach drives onboarding, planning, check-ins, completion, and reward usage.
• Real persistence: Supabase Auth, Postgres, and RLS back the user state.
• Typed domain tools: the agent calls typed tools instead of faking UI-only behavior.
• Mobile-first companion dashboard: the dashboard shows today's plan, progress, and available permissions.
• Rule-based rewards: rewards are conscious permissions unlocked by legible rules, not an arbitrary points economy.

Stack

• Next.js App Router
• React + TypeScript
• Supabase Auth + Postgres + RLS
• shadcn/ui
• Vercel AI SDK

Validation

pnpm typecheck
pnpm lint
pnpm test
pnpm validate

Do not use build as the primary behavior check. Tests and typecheck are the main validation surface for this repo.

Deployment notes

The app is intended for a public Vercel demo after the product pass is stable. Required environment variables are documented in .env.example.

Product maturity

This is a presentable MVP, not a finished consumer wellness product. The next product questions are retention, better personalization, and whether conscious permissions create healthier behavior over multiple days.