Skip to content

Android screen-time awareness app (built in Kotlin with Firebase Auth, SQLite, and Android system APIs). UF Software Engineering Semester Project.

Notifications You must be signed in to change notification settings

CouldBeYourMom/Later-Gator

 
 

Repository files navigation

🐊 Later Gator

A Screen Time Awareness Tool for Intentional Digital Habits


🔍 TL;DR – What This Project Demonstrates

  • Native Android development in Kotlin
  • Real-time tracking via AccessibilityService, UsageStatsManager, and Foreground Services
  • A 30+ table SQLite schema for comprehensive usage analytics
  • Firebase Authentication integration
  • Clean, layered architecture (UI → Application → Business Logic → Data)
  • Published as a tagged Android Studio prototype release

🔄 About This Fork

This fork exists as a personal workspace for continued learning, experimentation, and refinement after the completion of the original CEN3031 team project at UF.
The original repository remains the canonical source for the coursework submission and team contributions.

Future updates, refactors, or exploratory features may appear here as part of my ongoing development process.

All original team contributions remain fully credited.


🧠 Project Vision

Later Gator helps users recognize when intentional device use begins drifting into passive scrolling. The app supports healthier digital habits through:

  • Real-time screen usage monitoring
  • Customizable daily and weekly limits
  • “Snooze” and “Exit” interventions
  • Pomodoro-style focus sessions

The mission is simple: encourage intentional digital behavior.


👥 Contributors (Original Team)


🧪 Tech Stack

  • Kotlin
  • Android Studio
  • SQLite
  • Firebase Authentication (see below)
  • Gradle
  • Android API 36 tested

⚙️ Requirements

Before opening this project, ensure the following are installed:

1. Android Studio (Hedgehog or newer)

Includes built-in SDK Manager and emulator tools.

2. Android SDK Platform

  • Minimum recommended API Level: 34+
  • The team primarily tested on API Level 36 (Android 16).

3. An Emulator or Physical Android Device

  • Pixel-class emulator recommended (Pixel 9 or similar).
  • Physical devices must have:
    • USB debugging enabled
    • Google Play Services (for Firebase authentication)

🔐 Firebase Setup (Required to Run the App)

This project uses Firebase Authentication.
To run the app locally, you must provide your own Firebase configuration file:

  1. Go to https://console.firebase.google.com/
  2. Create a new Firebase project (any name)
  3. Add an Android app with the package name:
    com.latergator
    
  4. Download the generated google-services.json
  5. Place the file in:
    app/google-services.json
    

Once added, rebuild the project and Firebase Auth will initialize using your configuration.


🚀 Current Release: Prototype v0.1.0-pre

The academic prototype release is available in the original repository:
👉 https://github.com/smwong36/Later-Gator/releases/tag/v0.1.0-pre

Included

  • Full Kotlin Android Studio project
  • SQLite database and schema
  • Firebase Auth setup
  • All UI screens, services, and business logic
  • A README with installation instructions

Not Included

  • Course PDFs, retrospectives, or grading materials

📄 License

This fork uses the MIT License.

The original academic prototype may be used for educational and research purposes.


💙 Acknowledgments

Later Gator began as a UF Introduction to Software Engineering semester project and has grown into a personal journey in mobile development and software architecture.


🌐 Repository Links

About

Android screen-time awareness app (built in Kotlin with Firebase Auth, SQLite, and Android system APIs). UF Software Engineering Semester Project.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Kotlin 100.0%