Habitinator

A cross-platform productivity app built with .NET MAUI and Blazor. Manage habits, dailies, and to-dos with a focus timer, analytics, and reliable sync across web and mobile.

Live Demo. habitinator.app

Demo | Preview | Download | Features | Tech stack | Getting Started

---

Preview

Board | Statistics | Focus timer

     

Edit daily | Activity day detail | Settings

     

Regenerate screenshots with tools/Habitinator.Screenshots/run.ps1. The script uses Playwright with a mobile viewport in light and dark themes.

---

Download and install

Download the latest build from the releases page, or use the direct links below. Every package ships with a SHA256 checksum file.

Platform	Package	Size	Notes
Android		41 MB	Install on device. Enable unknown sources first
Windows		53 MB	Installer with auto-updates. Recommended
Windows		78 MB	Portable. Extract and run
iOS and macOS	Source only	-	Build from source using the .NET MAUI workload
Web		-	Live demo, no install needed

Windows runtime note. If your release is framework-dependent, install .NET Desktop Runtime once.

Option 1: Prebuilt packages, recommended

1. Pick your platform from the table above
2. Download the package and its .sha256 file
3. Verify the checksum, then follow the platform steps below

Option 2: Build from source

# Windows
dotnet build -t:Run -f net11.0-windows10.0.19041.0

# Android, requires the Android SDK
dotnet build -t:Run -f net11.0-android

Installation instructions

Android

1. Enable Install from unknown sources in system settings
2. Transfer the APK to your phone
3. Open the APK and install

Windows

Installer. Run Habitinator-windows-x64-setup.exe and follow the setup wizard. It keeps the app updated.

Portable. Extract the ZIP file, then run Habitinator.exe. If prompted, install .NET Desktop Runtime.

---

Key features

• Core planner. Track habits, dailies, and to-dos. Organize them with tags, notes, and checklists.
• Global session timer. A stopwatch with target logging to trace time spent on specific items.
• Statistics and heatmap. Interactive heatmap dashboard to monitor your progress over time.
• Local-first and sync. The mobile and desktop clients run on SQLite for offline support and sync changes to a server-side PostgreSQL backend.

---

Technology stack

Layer	Technologies
Runtime	.NET 11
Web UI	Blazor Web App with Interactive WebAssembly, MudBlazor
Native Apps	.NET MAUI + Blazor Hybrid for Android, iOS, macOS, Windows
Database, Server	Neon Serverless PostgreSQL or any PostgreSQL via EF Core
Database, Client	SQLite via EF Core
Orchestration	.NET Aspire AppHost

---

Getting started

Prerequisites

Make sure you have Docker installed and running for the local PostgreSQL container.

Run and debug via Aspire

To start PostgreSQL, the web backend, and the native client host environment, run:

dotnet run --project src/AppHost/AppHost.csproj

Seeded demo user

The application seeds a guest account on startup:

• Email. guest@habitinator.local
• Password. Guest123!

Regenerate screenshots

To regenerate the mobile screenshots in the Preview section, first start the web app via AppHost, then run:

pwsh ./tools/Habitinator.Screenshots/run.ps1 -BaseUrl "http://127.0.0.1:5033"

---

Solution graph

Here are the project dependencies, auto-updated via documentation scripts:

flowchart LR
%% Auto-generated by tools/Habitinator.Diagrams - project reference graph
  App_MAUI["App.MAUI"]
  App_MAUI_UITests["App.MAUI.UITests"]
  App_Shared_RCL["App.Shared.RCL"]
  App_Shared_RCL_Tests["App.Shared.RCL.Tests"]
  App_Shared_Tests["App.Shared.Tests"]
  App_Web["App.Web"]
  App_Web_Client["App.Web.Client"]
  App_Web_IntegrationTests["App.Web.IntegrationTests"]
  AppHost["AppHost"]
  App_MAUI --> App_Shared_RCL
  App_Shared_RCL_Tests --> App_Shared_RCL
  App_Shared_Tests --> App_Shared_RCL
  App_Web --> App_Shared_RCL
  App_Web --> App_Web_Client
  App_Web_Client --> App_Shared_RCL
  App_Web_IntegrationTests --> App_Web
  AppHost --> App_Web

Loading