HabitSync

HabitSync is a self-hostable habit-tracking platform that combines individual goal tracking with social features like shared habits, challenges, and leaderboards. It provides a PWA front end, a Java/Spring Boot backend API, and an Android mobile client.

Key Features

• Clean, mobile-first Progressive Web App (PWA) UI and installable Android app
• Flexible habit and goal configuration (daily/weekly/monthly/custom, negative habits, weekday selection)
• Social features: shared habits, monthly community challenges, leaderboards, and achievements
• Authentication via OIDC/OAuth2 (multiple issuers supported) and basic auth as alternative
• Notification system with Apprise integration for many delivery channels and custom schedules/triggers
• API-first architecture with Swagger docs and token/basic-auth access; import support for Loop Habit Tracker
• Easy Docker and Docker Compose deployment; supports H2 (file) and PostgreSQL databases

Use Cases

• Personal habit tracking with cross-device sync using the PWA or Android app
• Small social groups or friends running shared challenges and comparing progress
• Home automation integrations and external tooling via the REST API (for dashboards, notifications, or HA integration)

Limitations and Considerations

• The built-in API is marked as incomplete and may change; rely on it cautiously for long-term integrations
• Mobile app is under active development and may require matching server/client versions
• H2 is the default DB (file-based); production setups should prefer PostgreSQL for reliability and backups
• Notifications require an external Apprise API or compatible service for delivery

HabitSync is suitable for users who want a privacy-respecting, self-hosted habit tracker with social features and flexible authentication. It is production-ready with containerized deployment and an emphasis on API integration.