Skip to content

A simple Android Stretch App that reminds you to stretch

Notifications You must be signed in to change notification settings

ivanx000/StretchApp

Repository files navigation

🧘 StretchApp

Combat sedentary fatigue with a full-stack break-management system designed for developers and long-term computer users.

🎯 Overview

StretchApp is a health and wellness tool built to address the physical strain of long hours at a desk. The application provides a structured "top-of-the-hour" timer that prompts users to take 5-minute movement breaks. By allowing users to target specific body areas, it delivers curated, visual exercise instructions to ensure physical well-being remains a priority during intense work sessions.

Key Features

  • ⏱️ Top-of-Hour Timer: Intelligent 5-minute countdowns triggered at the start of every hour.
  • 🎯 Targeted Recovery: Select specific muscle groups (Neck, Back, Wrists, etc.) for personalized relief.
  • 🎬 Visual Guidance: Interactive GIF-based exercise library for clear, easy-to-follow instructions.
  • 🔄 Dynamic Logic: Randomized exercise selection to prevent routine fatigue.
  • 🎨 Responsive UI: A clean, intuitive interface built with SCSS and modular styling.

🏗️ Architecture

Logic & Routing (JavaScript)

  • Vanilla JS Engine: Handles real-time countdown synchronization and UI state management.
  • Modular Data Structures: Curated arrays of exercise assets categorized by body part.
  • EJS Templating: Dynamic rendering of exercise components and timer states.

Design & Styling

  • SCSS/CSS3: Utilizes pre-processors for maintainable, nested styling and modular design.
  • Asset Management: Integrated GIF library for instructional playback.

🚀 Getting Started

Prerequisites

  • Node.js (v18+)
  • npm or yarn

Installation

  1. Clone the Repository:
    git clone [https://github.com/ivanx000/StretchApp.git](https://github.com/ivanx000/StretchApp.git)
    cd StretchApp
    

2. **Install Dependencies:**
```bash
npm install

  1. Run the Application:
npm start

The app will be available at http://localhost:3000

📡 Roadmap

Future Enhancements

  • ⚛️ React Migration: Transitioning the frontend to a modern React architecture for improved state management.
  • 🌐 Community Feed: Implementing a social layer where users can share wellness milestones.
  • 💾 Persistent Database: Adding a backend database to allow user-generated exercise contributions and history tracking.

🛠️ Tech Stack

  • Frontend: HTML5, SCSS, Vanilla JavaScript
  • Templating: EJS (Embedded JavaScript)
  • Runtime: Node.js
  • Assets: Instructional GIF Library

🎓 Use Cases

  • Developer Wellness: Preventing RSI and back pain during long coding sessions.
  • Remote Work: Creating a structured break routine in a home office environment.
  • Posture Correction: Targeted stretches for common desk-related physical strain.

About

A simple Android Stretch App that reminds you to stretch

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages