Habit Tracker is an open-source full-stack habit-tracking template built with Nuxt 3, Drizzle ORM, and SQLite, designed to help users log daily habits and monitor consistency through a calendar heatmap and dynamic progress rates. The project ships as a complete Nuxt 3 application with server-side rendering (SSR), GitHub authentication via nuxt-auth-utils, and Pinia for client-side state management. It is published on GitHub under the zackha/habit repository and is licensed under the MIT License.
What is Habit Tracker?
Habit Tracker is a full-stack web application template for tracking daily habits. It takes habit definitions and daily completion check-ins as input, then produces a calendar heatmap, completion-rate statistics, and a progress view for each habit. The stack is Nuxt 3 on the frontend and backend, Drizzle ORM with SQLite for persistence, and Nuxt UI for the component library. It uses server-side rendering to improve performance and SEO, and it is designed for one-command deployment on NuxtHub.
Key Features
- Server-side rendering (SSR) — Nuxt 3 SSR renders habit pages on the server, improving initial load times and search-engine visibility.
- GitHub authentication — Users sign in with a GitHub account using the nuxt-auth-utils module; no custom auth backend is required.
- Drizzle ORM with SQLite — Database models and queries are written with Drizzle ORM against a lightweight SQLite file, avoiding a separate database service.
- Calendar heatmap — A heatmap visualization shows completion history for each day, making streaks and gaps immediately visible.
- Progress tracker — Dynamic completion rates for each habit update automatically as users log their daily check-ins.
- Dark/light mode toggle — Nuxt UI components provide a built-in theme switcher between dark and light appearances.
- Markdown habit descriptions — Habit entries accept markdown formatting, so notes can include links, lists, and emphasis.
- Component-based architecture — The Vue 3 codebase is organized into modular components, simplifying maintenance and customization.
Who is it for?
- Self-hosters — Individuals who want a private, self-hosted habit tracker without a subscription; they can deploy the app to their own NuxtHub instance.
- Nuxt/Vue developers — Developers who want a real project demonstrating SSR, Drizzle ORM, GitHub OAuth, and Pinia working together in one codebase.
- Product teams — Teams building habit, routine, or task-management products who need a functional open-source starting point with SQLite persistence.
What can you do with Habit Tracker?
- Personal habit logging: Create daily habits, mark them complete each day, and watch the calendar heatmap fill in to reflect your consistency.
- Visual habit analysis: Use the progress tracker's completion percentages to see which habits are hardest to maintain over time.
- Production deployment: Because the project is MIT-licensed and NuxtHub-ready, you can deploy your own copy or visit the live demo at https://habit.nuxt.dev.
FAQ
Is Habit Tracker free?
Yes. The project is open source under the MIT License, so the code is free to use, modify, and redistribute. There is a live demo at https://habit.nuxt.dev, but self-hosting is required for your own instance.
What authentication does it use?
Habit Tracker uses GitHub authentication through the nuxt-auth-utils module. Users sign in with their GitHub account; there is no built-in email/password registration flow.
What database does it use?
The app uses SQLite with Drizzle ORM. This keeps the database embedded in the project and eliminates the need to set up a separate database server.
Can I deploy to NuxtHub?
Yes. The README lists seamless deployment with NuxtHub as a feature, and the demo at https://habit.nuxt.dev is hosted on the Nuxt platform.
