🧠 SpineUp — Ultimate Smart Posture Tracker

Real-time IoT posture monitoring with ESP32, MPU6050 & a modern React dashboard

SpineUp is a full-stack IoT posture monitoring system that pairs an ESP32 microcontroller with an MPU6050 accelerometer/gyroscope to measure spinal tilt angle in real time — then streams the data over Wi-Fi to a modern React dashboard featuring Apple-inspired activity rings, live telemetry graphs, calendar history, multiple themes, and haptic vibration feedback when poor posture is detected.

✨ Features · 📸 Screenshots · 🚀 Quick Start · 🔌 Hardware Setup · ⚙️ Configuration · 🏗️ Architecture · 📜 License

---

✨ Features

🎯 Real-Time Posture Monitoring Apple Watch-style activity ring — animated SVG ring fills dynamically based on posture angle Complementary filter fusion — combines accelerometer + gyroscope data for stable and responsive tracking Live telemetry graph — smooth scrolling posture visualization updated every 200ms Instant posture classification — Excellent / Good / Fair / Poor posture detection with color feedback

📊 Analytics & History Session scoring — cumulative posture score generated from live tracking Streak tracker — counts consecutive seconds of good posture Calendar heatmap — monthly history visualization with score rings Weekly trend chart — bar-chart overview of posture consistency Monthly statistics — average score, tracked hours, and improvement trends

🎨 Premium Design System 4 built-in themes — Base, Light, Gamer, and Student themes Glassmorphic UI panels — frosted-glass cards with subtle transparency Smooth animations — powered by Framer Motion spring physics Responsive layout — desktop sidebar + mobile navigation Persistent settings — preferences saved using localStorage

🔧 Hardware & Connectivity ESP32 Access Point mode — creates its own Wi-Fi network RESTful /angle endpoint — lightweight JSON API with CORS support Vibration motor feedback — haptic alerts when posture exceeds threshold Startup auto-calibration — 500-sample sensor calibration Configurable sensitivity — adjustable thresholds and smoothing from the dashboard

---

📸 Screenshots

🖥️ Dashboard — Live Tracking

The main dashboard includes an Apple-inspired activity ring, live posture graph, streak counter, session score, and elapsed timer in a glassmorphic dark interface.

---

📅 History — Calendar View

Browse posture history month by month using calendar-based score visualization and weekly trend tracking.

---

⚙️ Settings — Full Customization

Configure ESP32 connection settings, choose themes, and adjust posture sensitivity thresholds.

---

🔌 Hardware Diagram

Simple I2C connection between the ESP32 and MPU6050 with a vibration motor connected to GPIO 23.

---

🚀 Quick Start

Prerequisites

Tool	Version	Purpose
Node.js	18+	React development server
npm	9+	Package management
Arduino IDE	2.x	ESP32 firmware upload
ESP32 Board	Any variant	Microcontroller
MPU6050	GY-521 module	IMU sensor

---

1️⃣ Clone the Repository

git clone https://github.com/maryam305/SpineUp.git
cd SpineUp