Momo

A mobile-first health & wellness web app for people going through weight-loss treatments with GLP-1 medications (Mounjaro, Ozempic, Wegovy). Momo combines a clinical progress tracker with a supportive community in a single Progressive Web App.

What it does

• Health tracker — log applied medication doses, weight, and body measurements over time, with a built-in generator for medical prescriptions.
• Support community — a private social feed where users share progress, ask questions, and celebrate milestones. Admins can pin important posts.
• Humanized notifications — a scheduled engine sends motivational check-ins at key times of day (hydration, protein intake, encouragement).
• Viral growth gate — new users must invite 3 friends to unlock full access; a Premium subscription bypasses the gate and is the main monetization path.

Tech stack

Layer	Technology
Frontend / Backend	Next.js 14 (App Router) · React 18 · TypeScript
Database / Auth	Supabase — PostgreSQL, Auth, Row-Level Security
Styling	Tailwind CSS
Hosting / Cron	Vercel (Vercel Cron for scheduled jobs)
Notifications	Web Push API (Service Workers)
Payments	InfinitePay webhooks
AI	OpenAI & Anthropic SDKs

Architecture highlights

• Notification engine (app/api/push/engine/route.ts) runs on a Vercel Cron schedule (8:00, 14:30, 19:00, 20:00, 21:00 BRT) to dispatch user check-ins and admin reports.
• Subscription flow — payments are settled via the InfinitePay webhook (/api/webhooks/infinitepay); approved payments flip assinatura_ativa on the profiles table and record history in assinaturas.
• Referral gate — access is unlocked by 3 confirmed invites (referral_invites) or an active subscription.

Key Supabase tables

• profiles — extended user data (starting weight, subscription status)
• assinaturas — payment & subscription history
• medicoes_saude — weight and body measurements
• doses — medication dose applications
• receitas_geradas — generated prescriptions
• social_posts — community feed
• referral_invites — viral invite tracking

Getting started

# install dependencies
npm install

# configure environment (see .env.example)
cp .env.example .env.local

# run the dev server
npm run dev

The app runs at http://localhost:3000.

Environment

Copy .env.example and fill in your Supabase project keys, payment webhook secrets, Web Push (VAPID) keys, and the admin email used for reports. See AI_CONTEXT.md for a full walkthrough of the modules and business rules.

Scripts

Command	Description
npm run dev	Start the development server
npm run build	Production build
npm run start	Start the production server
npm run lint	Run ESLint
npm run gen:icons	Generate PWA icons

---

Single-tenant production system for the Momo weight-loss support platform.