🎯 HabitTracker

Build Better Habits, Transform Your Life

A beautifully designed mobile application built with React Native and Expo to help users create, track, and maintain healthy daily habits with ease.

📱 Download APK • 🎥 Demo Video • 📋 Features • 🚀 Getting Started

---

🎥 Demo

🎬 Watch Full Demo Video

Click the image above or the link to see HabitTracker in action

📱 Screenshots

✨ Features

🎯 Core Features

• Create & Manage Habits - Add new habits with custom names, descriptions, and colors
• Daily Tracking - Mark habits as complete or incomplete with a simple tap
• Progress Visualization - View your progress with beautiful calendar views and interactive charts
• Smart Notifications - Get reminded about your habits at the perfect time
• Theme Support - Switch between elegant dark and light themes

🔧 Advanced Features

• Streak Tracking - Monitor your longest streaks and current progress
• Habit Categories - Organize habits by categories (Health, Productivity, Personal, etc.)
• Weekly/Monthly Views - Analyze your performance over different time periods
• Export Data - Backup your progress and export statistics
• Offline Support - Works perfectly without internet connection

🎨 User Experience

• Intuitive Interface - Clean, modern design that's easy to navigate
• Smooth Animations - Delightful micro-interactions and transitions
• Responsive Design - Optimized for all screen sizes
• Accessibility - Built with accessibility best practices

🚀 Getting Started

Prerequisites

Before you begin, ensure you have the following installed:

• Node.js (v16 or higher)
• npm or Yarn
• Expo CLI
• Git

📲 Installation

1. Clone the repository

   git clone https://github.com/yourusername/habittracker.git
   cd habittracker

2. Install dependencies

   npm install
   # or
   yarn install

3. Start the development server

   npx expo start

4. Run on your device

• Install Expo Go on your mobile device
• Scan the QR code displayed in your terminal
• Or press a for Android emulator, i for iOS simulator

🔧 Development Setup

# Install dependencies
npm install

# Start development server
npm start

# Run on Android
npm run android

# Run on iOS
npm run ios

# Run on web
npm run web

# Build for production
npm run build

🏗️ Built With

Core Technologies

• React Native - Mobile app framework
• Expo - Development platform and tools
• TypeScript - Type-safe JavaScript
• React Navigation - Navigation library

UI & Styling

• NativeBase / React Native Elements - UI component library
• React Native Reanimated - Advanced animations
• React Native Vector Icons - Icon library

Data & Storage

• AsyncStorage - Local data persistence
• React Native SQLite - Local database
• Redux Toolkit - State management

Additional Libraries

• React Native Calendars - Calendar components
• Victory Native - Data visualization
• Expo Notifications - Push notifications
• React Native Haptic Feedback - Haptic feedback

📱 App Architecture

src/
├── components/          # Reusable UI components
│   ├── common/         # Common components (Button, Input, etc.)
│   ├── habits/         # Habit-specific components
│   └── charts/         # Chart and visualization components
├── screens/            # Screen components
│   ├── HomeScreen/     # Main dashboard
│   ├── HabitsScreen/   # Habits management
│   ├── ProgressScreen/ # Progress visualization
│   └── SettingsScreen/ # App settings
├── navigation/         # Navigation configuration
├── services/          # API and data services
├── store/             # Redux store and slices
├── utils/             # Helper functions and utilities
├── hooks/             # Custom React hooks
├── constants/         # App constants and themes
└── types/             # TypeScript type definitions

🎨 Design System

Colors

const colors = {
  primary: '#6366F1',
  secondary: '#8B5CF6',
  success: '#10B981',
  warning: '#F59E0B',
  error: '#EF4444',
  // ... more colors
}

Typography

• Headings: Inter Bold
• Body Text: Inter Regular
• Captions: Inter Medium

📊 Features in Detail

🎯 Habit Management

• Create habits with custom names, descriptions, and icons
• Set habit frequency (daily, weekly, custom)
• Organize habits into categories
• Archive or delete habits

📅 Progress Tracking

• Visual calendar with completion status
• Streak counters and statistics
• Monthly and yearly overview
• Progress charts and analytics

🔔 Smart Notifications

• Customizable reminder times
• Motivational messages
• Streak milestone celebrations
• Daily summary notifications

🤝 Contributing

We love contributions! Please see our Contributing Guide for details.

Development Process

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Code Style

• Follow ESLint and Prettier configurations
• Use TypeScript for type safety
• Write meaningful commit messages
• Add tests for new features

🧪 Testing

# Run unit tests
npm test

# Run tests with coverage
npm run test:coverage

# Run E2E tests
npm run test:e2e

📦 Building for Production

Android

# Build APK
expo build:android

# Build AAB (recommended for Play Store)
expo build:android -t app-bundle

iOS

# Build IPA
expo build:ios

🚀 Deployment

The app can be deployed through:

• Expo Application Services (EAS) - Recommended
• Manual builds using Expo CLI
• Direct submission to app stores

📱 Download

Or download the APK directly: 📱 Download APK

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👥 Team

Nadeesha DevOps Enthusiast

🙏 Acknowledgments

• Design inspiration from leading habit tracking apps
• Icons from Feather Icons
• Illustrations from Undraw
• Color palette inspired by Tailwind CSS

📞 Support

Having issues? We're here to help!

• 📧 Email: nadeeshamedagama@gmail.com
• 🐛 Bug Reports: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 📱 Social: @HabitTrackerApp

🗺️ Roadmap

🔄 Version 2.0 (Coming Soon)

• Social features - Share progress with friends
• Habit templates and community suggestions
• Advanced analytics and insights
• Wearable device integration
• Habit coaching and tips

🎯 Future Features

• Web application companion
• Team habit challenges
• Integration with health apps
• AI-powered habit recommendations
• Multi-language support

---

Made with ❤️ for habit builders everywhere

⭐ Star this repository if you found it helpful!

_{HabitTracker © 2024. All rights reserved.}