/Mobile-App

Primary LanguageDartMIT LicenseMIT

Bunk-Mate: Mobile App

Are you tired of missing out on activities or simply wanting to take a day off from college? The Bunk Mate app is here to help! It allows you to effortlessly track your attendance while keeping you informed about the remaining classes needed to meet your attendance requirements.

Installation

To get started, simply download the latest release of the app from this link and install it on your device!

How to Use Bunk Mate

Maximize your experience with the Attendance Tracker app by following these steps:

1. Create an Account
Sign up within the app to create your account.

2. Log In
Use your newly created credentials to log into your account.

3. Add Your Timetable
You’ll be prompted to enter your timetable details. Provide:

  • Timetable name
  • Start and end dates
  • Required attendance percentage

You can also choose to select a timetable shared by other users!

4. Manage Your Courses
After adding your timetable, navigate to the courses page via the navigation bar to view and manage your courses and their schedules.

5. Update Attendance Status
Easily update your attendance on the status page:

  • Single-click to mark a day as bunked
  • Double-click to mark as skipped
  • Deep-press to mark as present

By default, days are marked as present, so you only need to update your status when you bunk or skip a class.

For Developers

Please see the contribution guidelines if you are interested in contributing to Bunk-Mate. Work that is in progress or could be implemented is tracked in the issues and projects.

Setup Instructions

To install the Attendance Tracker app locally, follow these steps:

  1. Clone the repository to your local machine.
  2. Run flutter run to install and launch the app.

Screenshots

Here's a quick look at the app's interface:

Home Screen Status Update Page Timetable Page Add Courses Create Timetable View
Home Screen Status Update Page Timetable Page Add Courses Create Timetable View

With Bunk Mate, you can manage your attendance smartly and take those well-deserved breaks without the stress! Enjoy your college life to the fullest!

Support Us

If you find the Bunk Mate app helpful, please consider starring our repository on GitHub! Your support helps us improve the app and reach more users.

How to Star the Repository

  1. Visit our GitHub repository: Bunk Mate on GitHub.
  2. Click the Star button at the top right of the page.

Your star not only shows your appreciation but also helps others discover the app. Thank you for your support!