https://github.com/karsterr/habitrack
An open-source Android habit tracking app built with Flutter, supported by a Go + PostgreSQL backend running in Docker. Features include habit creation, daily tracking, reminders, and simple habit-based analytics.
https://github.com/karsterr/habitrack
android docker flutter golang habit-tracking mobile-app open-source personal-development postgres postgresql productivity
Last synced: 5 months ago
JSON representation
An open-source Android habit tracking app built with Flutter, supported by a Go + PostgreSQL backend running in Docker. Features include habit creation, daily tracking, reminders, and simple habit-based analytics.
- Host: GitHub
- URL: https://github.com/karsterr/habitrack
- Owner: KARSTERR
- Created: 2025-05-09T10:48:00.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-05-13T15:08:06.000Z (6 months ago)
- Last Synced: 2025-05-13T15:53:13.380Z (6 months ago)
- Topics: android, docker, flutter, golang, habit-tracking, mobile-app, open-source, personal-development, postgres, postgresql, productivity
- Language: Dart
- Homepage:
- Size: 7.51 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Habitrack
**Habitrack** is an open-source habit tracking mobile application designed for Android. The app helps users build better routines and break bad habits through consistent daily tracking, reminders, and simple insights. It is developed using Flutter for the frontend and Go with PostgreSQL for the backend, containerized via Docker.
---
## ✨ Features
- ✅ User authentication (sign in, sign out, password reset)
- ➕ Add, edit, and delete habits (positive or negative)
- 📅 Daily habit tracking interface
- ⏰ Custom reminders for each habit
- 📊 Basic analytics and progress statistics
- ⚠️ Repeated alerts for bad habits the user wants to reduce
---
## 🛠 Tech Stack
### Mobile App (Flutter)
- Dart & Flutter SDK
- Platform: Android only
- State Management: (add here, e.g., Provider, Riverpod, etc.)
- Local storage: (add if used, e.g., Hive, SharedPreferences)
### Backend (Go + PostgreSQL)
- REST API with Go
- PostgreSQL for data persistence
- Dockerized service for deployment
- Handles:
- User authentication (JWT)
- Habit data storage
- Periodic statistics generation
- Sync between devices (planned)
---
## 📦 Installation
### Backend
```bash
cd backend
docker compose up --build
```
### Flutter App
```bash
cd habitrack_app
flutter pub get
flutter run
```
---
## 📁 Folder Structure
```
habittrack/
├── habitrack_app/ # Flutter app
├── backend/ # Go backend
│ ├── Dockerfile
│ └── main.go
├── README.md
└── docker-compose.yml
```
---
## 🧪 Status
This project is currently under active development as a university capstone. Contributions are welcome!
---
## 📄 License
MIT License – see `LICENSE` file for details.