Habits Factory

A power-user-oriented habit-tracking engine focused on precision, insight, and behavioral optimization.

What is Habits Factory?

Habits Factory is an open-source habit tracking application designed for users who want more than simple checkboxes. It provides:

• Daily Routine Tracking - Log and monitor your habits with precision
• Trend Visualization - See your progress through intuitive charts and graphs
• Data-Driven Insights - Discover correlations between habits using advanced algorithms
• Behavioral Optimization - Use analytics to refine and improve your routines

Who is it for?

End Users seeking meaningful analytics beyond basic habit tracking apps. If you want to understand the relationships between your habits and optimize your daily routines, Habits Factory provides the tools you need.

Developers who value clean, scalable architecture. The codebase follows modern best practices with a clear separation between frontend and backend, making it easy to understand, extend, and contribute to.

Core Philosophy

Habits Factory is built on four fundamental principles:

Principle	Description
Correctness First	Predictable behavior and validated data
Composable Architecture	Modular, extensible components
Performance-Oriented	Reactive UI, efficient APIs
Long-term Maintainability	Clear contracts, strong separation of concerns

Quick Links

• Getting Started

  ---

  Installation guide and first steps

• Architecture

  ---

  Technical design and stack overview

• Features

  ---

  Explore all capabilities

• Correlation Algorithms

  ---

  Deep dive into habit analytics

• API Reference

  ---

  Backend API documentation

• Roadmap

  ---

  Planned features and enhancements

Technology Stack

Backend

• Django - High-level Python web framework
• Django REST Framework - Powerful API toolkit
• PostgreSQL - Production database (SQLite for development)

Frontend

• Vue.js 3 - Progressive JavaScript framework with Composition API
• Vite - Next-generation frontend build tool
• Tailwind CSS v4 - Utility-first CSS framework

License

Habits Factory is released under the Apache-2.0 License.

Contributing

We welcome contributions! See our Contributing Guide for details on how to get involved.