Healthmate

Healthmate is a mobile-first wellness PWA for Mediterranean-style meal planning, grocery preparation, habit tracking, body-measurement trends, and safe coaching. It is designed to run locally from the browser first, with Supabase and Anthropic kept as optional production integrations.

Healthmate is for wellness education and day-to-day habit support only. It is not a medical device and does not diagnose, interpret tests, prescribe, or replace professional medical care.

App Preview

The quickest way to see the product shape without starting the app is the static preview:

Open the static Healthmate preview

For the working PWA, run the local development server and open the app in a desktop or mobile browser:

make install
make dev

Open:

http://localhost:3000

What The App Does

• Guides onboarding for a local wellness profile.
• Shows a home dashboard with today's plan, habits, meals, and trends.
• Generates 3, 5, or 7 day meal plans.
• Builds a grocery list from the active plan, grouped by aisle with pantry deduction and check-off support.
• Logs meals, weight, waist, habits, activity, and water.
• Scores meals with deterministic local logic and plate-balance checks.
• Provides a coaching API with a safe rule-based fallback when no LLM key is configured.
• Exports or resets browser-local data from settings.

Local-First By Default

No Supabase project or Anthropic key is required for local development. The app stores data in browser localStorage, and the coach falls back to local rule-based responses unless ANTHROPIC_API_KEY is provided.

Optional service configuration is documented in scaffold/.env.example.

Run On iPhone

Start the dev server on your network:

make dev-phone

Find your Mac's Wi-Fi IP address, then open this URL on the iPhone:

http://YOUR-MAC-LAN-IP:3000

Safari can add it to the Home Screen from the share sheet for a PWA-style test.

Commands

make install     # Install Node dependencies
make dev         # Run the Next.js app locally
make dev-phone   # Run on 0.0.0.0 for mobile testing
make build       # Build the Next.js app
make lint        # Run lint checks
make test        # Run unit tests
make push        # Push main to the configured GitHub remote
make clean       # Remove local Next.js build output

After you create the GitHub repository yourself, make push will add the default remote if needed and push main to:

https://github.com/miladtm94/Health-Kit-Mate.git

You can override the destination without editing the file:

make push GITHUB_REPO=https://github.com/<owner>/<repo>.git

Repository Map

.
├── scaffold/                         # Next.js 14 application
│   ├── src/app/                      # App Router pages and API routes
│   ├── src/components/               # Reusable UI components
│   ├── src/lib/                      # Local data, scoring, coach, and planning logic
│   └── supabase/                     # Optional future schema and seed data
├── healthmate-preview.html           # Static product preview
├── healthmate-preview.png            # README preview image
├── Healthmate-PRD-and-Architecture.md
├── Makefile
├── LICENSE
└── README.md

Support

☕ If Healthmate helps you, you can support the project here: Buy me a coffee

License

MIT License. See LICENSE.