██╗ ██╗███████╗ █████╗ ██╗ ████████╗██╗ ██╗███████╗ ██████╗ ██████╗ ██████╗ ███████╗
██║ ██║██╔════╝██╔══██╗██║ ╚══██╔══╝██║ ██║██╔════╝██╔═══██╗██╔══██╗██╔════╝ ██╔════╝
███████║█████╗ ███████║██║ ██║ ███████║█████╗ ██║ ██║██████╔╝██║ ███╗█████╗
██╔══██║██╔══╝ ██╔══██║██║ ██║ ██╔══██║██╔══╝ ██║ ██║██╔══██╗██║ ██║██╔══╝
██║ ██║███████╗██║ ██║███████╗██║ ██║ ██║██║ ╚██████╔╝██║ ██║╚██████╔╝███████╗
╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝ ╚═╝╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚═════╝ ╚══════╝
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
BUILDING BETTER HEALTH · OPEN SOURCE · v1.0.0
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
HealthForge is not another health app with pastel gradients and gentle nudges. It is a high-performance, AI-driven health tracking ecosystem built for people who take their body seriously. Neobrutalist by design. Ruthlessly functional by architecture. Powered by Groq's Llama-3 70B at near-instant speeds, persisted on Neon's serverless Postgres.
┌─────────────────────────────────────────────────────────────────────────┐
│ HEALTHFORGE SYSTEM │
├──────────────┬──────────────────────────────┬───────────────────────────┤
│ CLIENT │ INTELLIGENCE │ DATA LAYER │
│ │ │ │
│ Next.js 14 │──▶ Groq Cloud API │──▶ Neon Serverless DB │
│ TypeScript │ Llama-3 70B │ (Postgres) │
│ Vanilla CSS │ Sub-second inference │ Branching Migrations │
│ Lucide Icons│ AI Chat · Nutrition │ Connection Pooling │
│ │ Health Analytics │ Auto-scaling │
└──────────────┴──────────────────────────────┴───────────────────────────┘
╔══════════════════════════╦═══════════════════════════════════════════════╗
║ LAYER ║ TECHNOLOGY ║
╠══════════════════════════╬═══════════════════════════════════════════════╣
║ Framework ║ Next.js 14 — App Router + Server Actions ║
║ Language ║ TypeScript — Type-safe from day one ║
║ Styling ║ Vanilla CSS — Custom Neobrutalist system ║
║ Icons ║ Lucide — Sharp, consistent iconography ║
╠══════════════════════════╬═══════════════════════════════════════════════╣
║ AI Engine ║ Groq Cloud — Ultra-low latency inference ║
║ Language Model ║ Llama-3 70B — State-of-the-art reasoning ║
╠══════════════════════════╬═══════════════════════════════════════════════╣
║ Database ║ Neon — Serverless Postgres ║
║ ORM ║ Drizzle ORM — Type-safe SQL queries ║
╚══════════════════════════╩═══════════════════════════════════════════════╝
Skip the manual lookup. Describe your meal in plain language — the AI breaks down macros, micros, and calories with Groq-powered accuracy in under a second. Every log is persisted directly to your Neon database, building a nutrition timeline you can query, visualize, and learn from.
Recovery is where gains are made or lost. Visualize your sleep cycles, quality scores, and weekly trends on a dashboard built for clarity. Sleep data is stored in Neon, enabling historical queries across any time range.
Weight, heart rate, activity — tracked in real time, surfaced through high-contrast charts that make patterns impossible to miss. All metrics are written to your personal Neon database instance with full timestamp history.
A dedicated chat interface wired to Llama-3 70B. Ask complex questions about your fitness protocol, get habit coaching, understand your data. The assistant has read access to your stored metrics — context-aware responses only.
Built responsive from the ground up. The same data, the same UI, the same performance — on a 30-inch monitor or a 6-inch phone.
Neon is serverless Postgres built for the modern stack.
┌─ BRANCHING ──────────────────────────────────────────────────────┐
│ Every feature branch gets its own database branch. │
│ Instant, copy-on-write. Zero data duplication cost. │
└──────────────────────────────────────────────────────────────────┘
┌─ AUTOSCALING ────────────────────────────────────────────────────┐
│ Scales to zero when idle. Scales up under load. │
│ You only pay for compute you actually use. │
└──────────────────────────────────────────────────────────────────┘
┌─ CONNECTION POOLING ─────────────────────────────────────────────┐
│ Built-in PgBouncer-compatible pooler. │
│ Works seamlessly with Next.js serverless functions. │
└──────────────────────────────────────────────────────────────────┘
HealthForge/
│
├── public/
│ └── banner.png # App banner asset
│
├── src/
│ ├── app/ # Next.js App Router
│ │
│ ├── components/ # Feature components
│ │ ├── AIChat.tsx # AI chat interface
│ │ ├── AIChat.css
│ │ ├── AuthLayout.tsx # Auth wrapper layout
│ │ ├── AuthLayout.css
│ │ ├── Dashboard.tsx # Main dashboard view
│ │ ├── Dashboard.css
│ │ ├── FitnessSection.tsx # Fitness tracking module
│ │ ├── FitnessSection.css
│ │ ├── Landing.tsx # Landing / onboarding page
│ │ ├── Landing.css
│ │ ├── Layout.tsx # Global layout wrapper
│ │ ├── Layout.css
│ │ ├── MealTracker.tsx # AI-powered meal logging
│ │ ├── MealTracker.css
│ │ ├── NutritionSection.tsx # Nutrition analytics view
│ │ ├── Onboarding.tsx # User onboarding flow
│ │ ├── Onboarding.css
│ │ └── SleepSection.tsx # Sleep analytics module
│ │
│ ├── lib/
│ │ └── config.ts # App config + env helpers
│ │
│ └── styles/
│ ├── globals.css # Neobrutalist design tokens
│ ├── legal.css # Legal pages styling
│ └── marker-colors.css # Chart marker color system
│
├── .babelrc # Babel configuration
├── .env # Environment secrets (not committed)
├── .env.example # Environment variable template
├── .gitignore
├── LICENSE
├── next-env.d.ts
├── next.config.js
├── package.json
├── tsconfig.json
└── README.md
---
Clone the forge
git clone https://github.com/harshshirke66/HealthForge.git
cd HealthForgeInstall dependencies
npm installConfigure environment
Create a .env file in the project root:
# AI
GROQ_API_KEY=your_groq_api_key_here
# Database — Neon Serverless Postgres
DATABASE_URL=postgresql://user:password@ep-xxxx.region.aws.neon.tech/neondb?sslmode=require
DATABASE_URL_UNPOOLED=postgresql://user:password@ep-xxxx.region.aws.neon.tech/neondb?sslmode=requireGet your Groq key at console.groq.com Get your Neon connection string at console.neon.tech
Push database schema
npx drizzle-kit pushIgnite the engine
npm run devOpen http://localhost:3000 — the forge is live.
HealthForge is open source and built in the open. Contributions are welcome.
# Fork, clone, and branch
git checkout -b feature/your-feature-name
# Push and open a PR
git push origin feature/your-feature-nameFor major changes, open an issue first to align on direction before building.
Distributed under the MIT License. See LICENSE for full terms.
┌──────────────────────────────────────────────────┐
│ │
│ HEALTHFORGE · v1.0.0 │
│ OPEN SOURCE HEALTH PLATFORM │
│ │
│ Built by Harsh Shirke │
│ github.com/harshshirke66 │
│ │
└──────────────────────────────────────────────────┘