Stress Micro-Coach

A responsive web app that provides personalized 2–5 minute desk-friendly stress relief exercises, with optional AI-powered suggestions via OpenAI integration.

✨ Features

• Three stress levels (Low, Medium, High) with tailored exercises
• Smart suggestions based on stress triggers (deadlines, bugs, deployments)
• Built-in timer with progress bar and countdown
• Session history tracking with localStorage persistence
• CSV export for wellness data analysis
• Full accessibility with keyboard navigation and screen reader support
• AI enhancement via OpenAI API for personalized suggestions (optional)
• Offline-capable with fallback to curated local exercises

🚀 Quick Start

Frontend Only (No Server Required)

1. Simply open index.html in your web browser
2. Start using the app immediately with curated stress relief exercises
3. All data stored locally in browser localStorage

With AI-Powered Server

1. Install dependencies:

   npm install

2. Set up environment:

   # Copy environment template
   copy .env.example .env
   
   # Edit .env and add your OpenAI API key
   # Get API key from: https://platform.openai.com/api-keys

3. Start the server:

   npm start

4. Open the app:

   • Navigate to http://localhost:3000
   • Or serve index.html from the same domain as your API

🛠️ Tech Stack

Frontend:

• Vanilla JavaScript (ES6+)
• CSS Grid/Flexbox with CSS Variables
• Semantic HTML5 with ARIA accessibility
• localStorage for data persistence

Backend (Optional):

• Node.js with Express
• OpenAI GPT-4o-mini API integration
• CORS enabled for frontend communication
• Environment-based configuration

🔒 Privacy & Data

Frontend-Only Mode:

• All data stays in your browser's localStorage
• No external API calls or data transmission
• Complete privacy and offline functionality

Server Mode:

• Stress level and reason sent to OpenAI for personalized suggestions
• No personal data stored on server
• Session history remains in browser localStorage
• OpenAI's data usage policies apply

📈 Scalability Ideas

Enhanced Features:

• User accounts with cloud sync
• Progress tracking and analytics
• Team/organizational dashboards
• Integration with calendar apps for stress pattern detection

Technical Improvements:

• Service worker for true offline PWA
• Real-time stress monitoring via wearable integrations
• Machine learning for suggestion effectiveness tracking
• Multi-language support with localized exercises

Enterprise Features:

• Single sign-on (SSO) integration
• Compliance reporting (HIPAA, GDPR)
• Custom exercise libraries for organizations
• Slack/Teams bot integration

🎯 Use Cases

• Individual wellness - Personal stress management throughout the day
• Workplace wellness - Team stress relief during high-pressure periods
• Healthcare - Complementary tool for anxiety management programs
• Education - Student stress relief during exam periods
• Remote work - Structured breaks for distributed teams

📱 Browser Support

• Chrome/Chromium 88+
• Firefox 85+
• Safari 14+
• Edge 88+
• Mobile browsers (iOS Safari, Chrome Mobile)

🤝 Contributing

This is a minimal viable product (MVP). Potential contributions:

• Additional exercise types and categories
• Improved AI prompts for better suggestions
• Enhanced accessibility features
• Mobile app version
• Integration with popular wellness platforms

📄 License

MIT License - Feel free to use, modify, and distribute as needed.

---

Start managing stress better, one micro-moment at a time. 🧘‍♀️✨ "# Vibecoding"