- Habit Tracking - Track daily habits with beautiful visual cards
- Streak Counter - Stay motivated with fire emoji streak indicators
- Weekly Calendar - Quick navigation with visual completion status
- Statistics Dashboard - Analyze your habits with completion rates and charts
- Customizable - Choose from 28+ icons and 18 vibrant colors
- Reminders - Set custom alarm times for each habit
- Flexible Scheduling - Select specific days for each habit
- Dark Mode - Eye-friendly theme for day and night
- Mobile-First - Optimized for Android devices
- Offline-First - Works completely offline, no internet needed
- Privacy-Focused - All data stored locally on your device
- Lightning Fast - Smooth animations and instant responses
- Modern UI - Clean, minimalist design with glassmorphism effects
Track your daily habits with a beautiful card interface. See your active streaks at a glance.
Create new habits with custom icons, colors, and schedules. Set reminders to stay on track.
Visualize your habit completion with a color-coded heatmap calendar.
Track your progress with detailed completion rates and habit breakdowns.
Customize your experience with dark mode and manage your data.
Beautiful dark theme for comfortable evening tracking.
Before you begin, ensure you have the following installed:
- Node.js (v16 or higher)
- npm or yarn
- Android Studio (for Android builds)
- JDK 17 (for Android builds)
- Download the apk file form Release
- Install to your phone
- Clone the repository
git clone https://github.com/yourusername/habitflare.git
cd habitflare- Install dependencies
npm install- Run development server
npm run devThe app will open at http://localhost:5173
-
Install Android Studio from developer.android.com
-
Set up environment variables:
# Add to your system environment variables
ANDROID_HOME=C:\Users\YourName\AppData\Local\Android\Sdk
JAVA_HOME=C:\Program Files\Java\jdk-17
# Add to Path
%ANDROID_HOME%\platform-tools
%ANDROID_HOME%\tools
%JAVA_HOME%\bin# 1. Build web assets
npm run build
# 2. Sync to Android
npx cap sync android
# 3. Open in Android Studio
npx cap open android
# 4. In Android Studio: Build > Build Bundle(s) / APK(s) > Build APK(s)APK location: android/app/build/outputs/apk/debug/app-debug.apk
- Generate keystore (first time only):
keytool -genkey -v -keystore habitflare.keystore -alias habitflare -keyalg RSA -keysize 2048 -validity 10000-
Move keystore to
android/app/ -
Create
android/keystore.properties:
storePassword=YourPassword
keyPassword=YourPassword
keyAlias=habitflare
storeFile=habitflare.keystore- Build release APK:
cd android
./gradlew assembleReleaseAPK location: android/app/build/outputs/apk/release/app-release.apk
| Technology | Purpose |
|---|---|
| React 18 | UI framework |
| TypeScript | Type safety |
| Tailwind CSS | Styling |
| Capacitor | Native Android wrapper |
| Lucide React | Icon library |
| Vite | Build tool |
| LocalStorage | Data persistence |
habitflare/
├── android/ # Capacitor Android project
├── assets/ # Images and icons
├── components/ # React components
│ ├── BottomNav.tsx # Bottom navigation
│ └── HabitCard.tsx # Habit display card
├── views/ # Main screens
│ ├── Home.tsx # Home screen with habit list
│ ├── AddHabit.tsx # Create new habit
│ ├── CalendarView.tsx # Calendar & statistics
│ └── Settings.tsx # App settings
├── utils/ # Utility functions
│ └── dateUtils.ts # Date manipulation helpers
├── App.tsx # Main app component
├── constants.tsx # Icons and colors config
├── types.ts # TypeScript interfaces
└── index.tsx # Entry point
This project is licensed under the MIT License - see the LICENSE file for details.