Habistat Tracker
Habistat Tracker
Build habits. Track progress. Achieve goals.
🌐 Open-Source | 🔄 Cross-Platform | 🎯 Part-Gamified
Habistat is a free and open-source habit tracker productivity tool—an alternative to apps like Everyday, Habitify, and Habitica. It is designed with privacy, transparency, and ease of use in mind. Built with Tauri and Svelte, it runs natively on Windows, macOS, Android, and iOS, and is fully accessible from any modern browser. You can track daily routines with either a points system or simple progress logs. All data can be exported or imported as JSON, giving you complete control. Build steady habits one day at a time, and let meaningful change grow naturally. 🌿
Why?
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.
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.
- 📊 Dashboard & 🎉 Visuals: View your trends and progress with sleek charts and an activity grid.
- 📅 Custom Calendars: Group habits by themes.
- 🛜 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.
- 🌐 Local-First Architecture
- ☁️ Cloud Sync
- 🐛 Advanced Debug System
- 🎯 Multiple Debug Levels
- 🔧 Runtime Configuration
- 📊 Debug History
- 🎨 Visual Indicators
- 📱 Module Loggers
- 🚀 Production Optimized
Getting Started
- Create a Calendar: Name it (e.g., Hobbies, Fitness, Negative) and pick a color.
- Add Habits: Label them, choose positive or negative, and set timers (optional).
- Track & Grow: Check off daily.
Debug System
Habistat Tracker includes a powerful debug system for development and troubleshooting:
Quick Start
# Enable debug levels in your .env.local
VITE_DEBUG_LEVELS="error,warn,info,debug"
VITE_DEBUG_RUNTIME_TOGGLE="true"
Usage
import { debugLogger } from '$lib/utils/debug-logger';
// Simple logging
debugLogger.info('User logged in', { userId: '123' });
debugLogger.error('Something went wrong', { error: details });
// Module-specific loggers
const log = getModuleLogger('AuthService');
log.info('Authentication successful', { userId: user.id });
Features
- 🎯 Multiple Debug Levels: Trace, Debug, Info, Warn, Error
- 🔧 Runtime Configuration: Toggle settings without restart
- 📊 Debug History: In-memory message history
- 🎨 Visual Indicators: Emoji indicators for different levels
- 📱 Module Loggers: Dedicated loggers for different modules
- 🚀 Production Optimized: Automatic cleanup and tree-shaking
For detailed documentation, see Debug System Documentation.
Development
Prerequisites
- Node.js 18+
- Bun package manager
- SQLite (for local development)
Setup
Clone the repository
git clone https://github.com/your-username/habistat-tracker.git cd habistat-trackerInstall dependencies
bun installSet up environment variables
cp .env.example .env.local # Edit .env.local with your configurationInitialize the database
bun run db:setupStart development server
bun run dev
Available Scripts
# Development
bun run dev # Start dev server on port 3001
bun run check # Type-check with svelte-check
bun run check:watch # Type-check in watch mode
# Code Quality
bun run lint # Lint with Biome
bun run format # Format with Biome + Prettier
bun run format:check # Check formatting
# Database (SQLite + Drizzle ORM)
bun run db:generate # Generate migrations from schema
bun run db:migrate # Apply migrations
bun run db:push # Push schema changes directly
bun run db:studio # Open Drizzle Studio
bun run db:reset # Reset database (development only)
bun run db:setup # Generate + migrate (initial setup)
# Tauri (Desktop App)
bun run tauri dev # Run Tauri development build
bun run tauri build # Build Tauri production app
# Build
bun run build # Build for production
bun run preview # Preview production build
Architecture
Dual-Database System
Habistat uses a hybrid local-first architecture:
- Local Database: SQLite (via Drizzle ORM) for offline-first functionality
- Cloud Database: Convex for optional synchronization when authenticated
Key Technologies
- Frontend: SvelteKit 2 with Svelte 5 (runes mode)
- Styling: Tailwind CSS v4 with shadcn-svelte components
- Database: SQLite with Drizzle ORM
- Backend: Convex for cloud synchronization
- Authentication: Clerk
- Desktop: Tauri
- Build: Vite with SvelteKit adapter-static
Environment Variables
Required
# Clerk Authentication
PUBLIC_CLERK_PUBLISHABLE_KEY="your_publishable_key"
CLERK_SECRET_KEY="your_secret_key"
# Convex Configuration
VITE_CONVEX_URL="https://your-project.convex.cloud"
CONVEX_DEPLOYMENT="your-project-name"
CLERK_JWT_ISSUER_DOMAIN="https://your-clerk-domain.clerk.accounts.dev"
Debug Configuration
# Debug levels (comma-separated): error,warn,info,debug,trace
VITE_DEBUG_LEVELS="error,warn,info"
# Debug options
VITE_DEBUG_RUNTIME_TOGGLE="true"
VITE_DEBUG_INCLUDE_TIMESTAMPS="true"
VITE_DEBUG_INCLUDE_CALLER_INFO="false"
VITE_DEBUG_MAX_HISTORY_SIZE="1000"
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Ensure code passes linting and type checking
- Submit a pull request
Code Quality
- Use the provided debug system for logging
- Follow the existing code style (2 spaces, max 100 chars/line)
- Add comments for complex logic
- Use TypeScript for type safety
License
This project is licensed under the AGPL-3.0 License - see the LICENSE file for details.
Support
For issues and questions:
- Check the Debug System Documentation
- Review existing issues on GitHub
- Create a new issue with detailed information
Built with ❤️ using Svelte, Tauri, and modern web technologies.
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:
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.)
└── 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! 😎
