/habits

Habits is an swift app that will reminder you to track and keep going with your habits, from drink water to do exercises!

Primary LanguageSwift

Habit Tracker

Overview

Habit Tracker is an iOS app designed to help you build and maintain habits effectively. The app allows you to add new habits, set reminders, and track your progress. You can easily mark habits as completed, edit them, disable notifications, or delete them as needed. The habit list automatically updates based on the recurrence you choose—daily, weekly, or monthly.

Features

  • Add New Habit: Create new habits with a custom title, description, and frequency.
  • Notification Reminders: Set up reminders for each habit to receive notifications at your preferred time.
  • Mark Habit as Completed: Track your progress by marking habits as completed directly from the habit list.
  • Edit Habit: Update the details of your habit at any time.
  • Disable Notifications: Turn off notifications for specific habits without deleting them.
  • Delete Habit: Remove habits that you no longer want to track.
  • Automatic List Update: The habit list updates automatically based on the selected frequency—every 24 hours, weekly, or monthly.

Requirements

  • iOS 13.0+
  • Xcode 12.0+
  • Swift 5.0+

Installation

  1. Clone this repository: 
    git clone https://github.com/Falkaniere/habits.git
  2. Open the project in Xcode: 
    cd HabitTracker
open HabitTracker.xcodeproj
  3. Build and run the app on your iOS simulator or device.

Usage

  1. Add a New Habit:

    • Tap on the + icon to create a new habit.
    • Set the habit title, description, frequency, and notification time.

  2. Track Your Habits:

    • View all your habits on the home screen.
    • Mark a habit as completed by tapping the checkbox next to it.

  3. Edit or Delete a Habit:

    • Tap on any habit to open the detail view.
    • Edit the habit's details or disable notifications.
    • To delete a habit, swipe left on the habit in the list.

  4. Automatic List Update:

    • Your habit list updates automatically based on the recurrence (daily, weekly, or monthly) you choose.

Notifications

The app uses local notifications to remind you of your habits. Make sure to allow notification permissions when prompted.

Contributing

If you'd like to contribute to the project, please fork the repository and submit a pull request.