Habistat

Build habits. Track progress. Achieve goals.

🌐 Open-Source | 🔄 Cross-Platform | 🎯 Semi-Gamified

Habistat is a free and open-source habit tracker focused on privacy and simplicity. It helps you build good habits, break bad ones, and track daily activity, with your data fully under your control. Features include time-based habit tracking and optional gamification: streaks, points, and a virtual garden that grows – ideally, like you. 🌱

An alternative to apps like Everyday, Habitify, and Habitica, it is built with the lightweight Tauri framework and runs smoothly on Android, iOS, Windows, macOS, and in any modern browser.

Why Habistat?

Tired of bloated apps and shaky privacy policies? Habistat keeps it simple. Inspired by "Don't Break the Chain," it turns habit tracking into a daily checkmark ritual. Each completed habit advances your streak, grows a virtual plant, and earns points.

Visit: habistat.app 👈

[!NOTE] This app is currently in its alpha development stage and may not be stable until future versions. The currently available versions are Windows and web, with other versions coming soon.

Features

• ✅ Positive & 🚫 Negative Habits: Keep track of what to do and what to avoid. Earn points for fun and remember, your progress is ultimately judged by you.
• 📊 Dashboard & 🎉 Visuals: View your trends and progress with sleek charts and an activity grid.
• 📅 Custom Calendars & 🏆 Gamification: Group habits by themes, earn rewards, and grow your virtual garden.
• 🛜 Offline-First with 🔄 Optional Sync: Fully functional offline and sync across devices only if you choose.
• 🔒 Full Data Portability: Easily import or export your habit history anytime, no restrictions.
• 📱 Clean, Adaptive UI: Enjoy light/dark modes, multilingual support, and a stylish design built with SvelteKit, Tailwind CSS, and shadcn-svelte.

Getting Started

1. Create a Calendar: Name it (e.g., Hobbies, Fitness, Negative) and pick a color.
2. Add Habits: Label them, choose positive or negative, set timers (optional), and assign point values.
3. Track & Grow: Check off daily. Watch your streaks, points, and garden grow. Preferably in that order.

Tech Stack

Habistat is built with a modern and robust technology stack:

• Package Manager: Bun v1.2
• Core Framework: Tauri v2 (Rust backend, web frontend)
• Frontend: SvelteKit v2 (Svelte v5)
• Styling: Tailwind CSS v4
• UI Components: shadcn-svelte
• Icons @lucide/svelte
• Local Database: SQLite via Drizzle ORM
• Cloud Sync & Backend: Convex
• Authentication: Clerk (OAuth with Google, etc.) via svelte-clerk
• Internationalization: svelte-i18n
• Utilities:
  • date-fns (Date Manipulation and Formatting)
  • uuid (Unique Identifiers)
  • p5.js (Creative Coding & Visualization for the Virtual Garden)
  • @number-flow/svelte (Animated Number Transitions)
  • svelte-confetti (Confetti Effects)
  • crazy-fireworks (Fireworks Effects)

Project Structure

habistat/
├── Docs/                         # Documentation & development guides
├── src/                          # Main SvelteKit application
│   ├── convex/                   # Convex backend functions & schema
│   ├── i18n/                     # Internationalization files
│   ├── lib/
│   │   ├── components/           # Svelte UI components
│   │   ├── db/                   # Database client & schema
│   │   ├── hooks/                # Custom Svelte hooks
│   │   ├── services/             # Business logic & data services
│   │   ├── stores/               # Svelte stores for state management
│   │   └── utils/                # Utility functions
│   ├── params/                   # SvelteKit parameter matchers
│   ├── routes/                   # SvelteKit pages & API routes
│   │   ├── dashboard/            # Main dashboard pages
│   │   ├── settings/             # Settings page
│   │   ├── stats/                # Statistics page
│   │   └── premium/              # Premium features page
│   ├── app.html                  # Main HTML template
│   └── hooks.{client,server}.ts  # SvelteKit hooks
├── src-tauri/                    # Tauri Rust backend
│   ├── src/                      # Rust source code
│   ├── capabilities/             # Tauri capabilities configuration
│   └── Cargo.toml                # Rust dependencies
├── static/                       # Static assets (icons, images, etc.)
├── migrations/                   # SQLite database migrations
└── scripts/                      # Build and utility scripts

To view the complete file structure, refer to file-structure.txt.

Useful Links

• Website: https://www.habistat.app
• Creator: Ilya Aizenberg
• Issue Tracker: https://github.com/ilyaizen/habistat/issues

License

This project is licensed under the GNU AGPL v3. See the LICENSE file for details.

Happy tracking! 😎