Minimalist, High-Performance Habit Tracking. Build lasting momentum with visual feedback and elegant analytics.
Habitus is designed for clarity and consistency. It transforms your daily progress into a beautiful, visual story of your commitment. No clutter, no friction—just you and your evolution.
- ⚡ Real-Time Heatmap: A custom 31-day grid that visualizes your momentum across multiple habit categories.
- 📊 Smart Analytics: Automated KPI rings, category breakdowns, and monthly progress charts.
- 🔥 Streak Tracking: Stay motivated with current and all-time record streaks for every habit.
- 🌓 Premium Themes: Curated light and dark modes with a calming, aesthetic pastel palette.
- 📝 Daily Reflections: A built-in notes system to document your journey and record milestones.
- 📂 Notes Archive: Centralized monthly view of all your daily journals.
- 🔐 Passwordless Auth: Secure, simple sign-in via email Magic Codes (OTP).
| Layer | Technology |
|---|---|
| Frontend | React, Vite, Tailwind CSS, Lucide |
| Backend | Node.js, Express, NeonDB (Serverless Postgres) |
| Auth/API | JWT, SMTP (NodeMailer), TanStack Query |
| Charts | Recharts (Responsive Analytics) |
- Node.js v18+
- PostgreSQL (NeonDB recommended)
- SMTP server credentials (e.g., Gmail App Password)
git clone https://github.com/AdarshGzz/Habitus.git
cd Habitus
npm installCreate a .env file in the root directory:
# Database
DATABASE_URL=postgresql://your-neon-url
# Server Configuration
PORT=3001
JWT_SECRET=your-secret-key
# Email (SMTP)
SMTP_HOST=smtp.gmail.com
SMTP_PORT=465
SMTP_USER=your-email@gmail.com
SMTP_PASS=your-app-password
FROM_EMAIL=your-email@gmail.com# Start development server (Frontend + Backend)
npm run devHabitus uses a Unified Vercel Architecture. The entire stack (React frontend + Express API) is deployed as a single project using Vercel Serverless Functions.
MIT © 2026 AdarshGzz