Skip to content

README.md

Latest commit

 

History

History
74 lines (47 loc) · 2.33 KB

README.md

File metadata and controls

74 lines (47 loc) · 2.33 KB

Fit Sentinel 🛡️👟

Your Smart Step Counter & Fitness Guardian

Fit Sentinel is an Android app that helps users stay active and safe by accurately counting steps using both Accelerometer & Gyroscope or the device’s built-in Pedometer, depending on availability. Built with Kotlin and Jetpack Compose, the app offers a sleek and modern UI for step tracking, activity history, and optional safety features.

🚶 Core Feature: Intelligent Step Counting

🎯 Highly Accurate Step Counter

  • Uses Accelerometer + Gyroscope for custom step detection
  • Falls back to the Pedometer sensor (TYPE_STEP_COUNTER) if available
  • Works reliably indoors and outdoors
  • Battery-efficient and runs in the background

✨ Other Features

  • 📈 Daily & Weekly Step History – Track progress over time
  • 🎨 Modern Compose UI – Material 3 theming with light/dark mode
  • 🔢 Step Goal Notifications – Set daily step targets
  • 🔒 Privacy-First Design – No unnecessary data collection

📱 Screenshots

Dashboard Step Counter
image image

🛠️ Tech Stack

  • Language: Kotlin
  • UI: Jetpack Compose + Material 3
  • Architecture: MVVM
  • Sensors: Accelerometer, Gyroscope, Step Counter
  • Local Storage: Room Database
  • Dependency Injection: Hilt

⚙️ How It Works

The app checks for the availability of the TYPE_STEP_COUNTER sensor. If it's not available, it automatically falls back to a custom algorithm using accelerometer and gyroscope data to count steps based on movement patterns. This ensures compatibility with a wide range of Android devices.

🎨 Design Prototype

You can explore the app's UI/UX design via the Figma link below:

Figma Design – Fit Sentinel

🧑‍💻 Getting Started

Prerequisites

  • Android Studio Giraffe or later
  • Android SDK 33+
  • Kotlin 1.9+

Build & Run

git clone https://github.com/yourusername/fit-sentinel.git
cd fit-sentinel
./gradlew installDebug