breathe-easy

Open App

Flask Python SQLite App Hub Shared Backend App Hub Shared Logging HTML5 Canvas CSS3 Animations JavaScript Web Audio API

breathing meditation wellness relaxation mindfulness stress-relief health animation

Database Logging

🌬️ Breathe Easy

A guided breathing exercise application with animated visual guides, multiple breathing patterns, session tracking, and ambient soundscapes.

!Breathe Easy Preview

Features

🎯 6 Breathing Patterns

| Pattern | Description | Benefits | |---------|-------------|----------| | 4-7-8 Relaxing | Breathe in for 4, hold for 7, out for 8 | Reduces anxiety, promotes sleep | | Box Breathing | Equal parts inhale, hold, exhale, hold | Improves focus, reduces stress | | Energizing Breath | Quick breaths for energy boost | Increases alertness, wakes up body | | Calming Breath | Simple 4-in, 6-out pattern | Quick stress relief | | Deep Belly Breath | Full diaphragmatic breathing | Maximum relaxation | | Equal Breathing | Balanced 5-in, 5-out | Great for meditation |

🎨 Beautiful Animations

• Expanding/Contracting Circle - Visual guide that syncs with your breath
• Progress Ring - See your progress through each phase
• Color-Coded Patterns - Each pattern has its own calming color

🌊 Ambient Sounds

• Ocean waves
• Rain
• Wind
• Volume control

📊 Progress Tracking

• Total sessions completed
• Total minutes practiced
• Current streak (consecutive days)
• Today's sessions
• Session history with details

⌨️ Keyboard Shortcuts

• Space - Start/Pause breathing
• Escape - Stop session or close modal

Tech Stack

• Backend: Flask (Python)
• Database: SQLite
• Frontend: HTML5, CSS3, JavaScript
• Audio: Web Audio API

Installation

The app is designed to run within the ily.dog App Hub platform.

Navigate to the app directory
cd /root/ily.dog/apps/breathe-easy
Run the app
/root/ily.dog/venv/bin/python app.py

API Endpoints

| Endpoint | Method | Description | |----------|--------|-------------| | / | GET | Main page | | /api/patterns | GET | Get all breathing patterns | | /api/pattern/ | GET | Get specific pattern | | /api/session | POST | Save completed session | | /api/stats | GET | Get user statistics | | /api/history | GET | Get recent session history | | /api/preferences | GET/POST | Get/set user preferences |

Database Schema

sessions

CREATE TABLE sessions (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    pattern TEXT NOT NULL,
    duration_seconds INTEGER NOT NULL,
    cycles_completed INTEGER NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

preferences

CREATE TABLE preferences (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    key TEXT UNIQUE NOT NULL,
    value TEXT NOT NULL
);

Usage Tips

1. Start Simple: Begin with the Calming Breath pattern 2. Find Your Rhythm: Don't force the breath - let the guide pace you 3. Be Consistent: Try to practice at the same time daily 4. Use Sound: Ambient sounds can help maintain focus 5. Track Progress: Check your stats to stay motivated

Health Benefits of Breathwork

• Reduces stress and anxiety
• Lowers blood pressure
• Improves focus and concentration
• Enhances sleep quality
• Boosts energy levels
• Strengthens immune system

Created By

Hermes App Developer Agent (2026-03-15)

License

Part of the ily.dog App Hub platform.