FatoomRe/Calm-Attack

Calm Attack 👾⚔️☁️

Transforming panic into peace, one breath at a time ✨

Calm Attack is an open-source Flutter-based mobile application designed to be a lifeline for individuals experiencing Panic Attacks. Empowering you to reclaim your strength and find peace in the storm, this app offers scientifically-backed grounding exercises to help you regain control when anxiety strikes.

🌈 Why Calm Attack?

• 🚀 Instant Relief: No registration, no barriers—just immediate access to help
• 🧠 Science-Based: Grounding techniques proven by mental health professionals
• 📱 Always Available: Your pocket therapist, ready 24/7
• 🔒 Privacy First: Everything stays on your device—completely offline
• 🎯 Personal Experience: Built by someone who truly understands the need
• 💝 100% Free: Open source means accessible to everyone, forever

---

📋 Table of Contents

• ✨ Features
• 🚀 Installation
• 🎯 Usage
• 🤝 Contributing
• 📚 Documentation
• 🎯 Roadmap
• 📄 License
• 💌 Contact

---

✨ Features

🫁 Breathing Exercise

Find your rhythm, find your calm

• Guided breathing exercises to help regulate breathing and reduce anxiety
• Visual breathing guide with smooth animations
• Simple 3-3-3 breathing pattern (Inhale 3 sec, Hold 3 sec, Exhale 3 sec)

🎵 Sound Focus Exercise

Ground yourself in the present moment

• 6 nature and ambient sound tracks (Waves, Rain, Birds, Fire, Forest, Wind)
• Audio player with play/pause controls
• Visual audio spectrum animation
• Helps anchor your mind in the present

📳 Vibration Focus Exercise

Feel your way back to stability

• Simple start/stop vibration controls
• Continuous haptic feedback for grounding
• Rive animation accompaniment
• Helps reconnect with your body

🌸 Smell Imagination Exercise

Transport yourself to tranquility

• Beautiful flower and nature imagery (8 different images)
• Visual prompts for scent imagination
• Calming visual arrangements
• Engages olfactory memory

🍃 Taste Imagination Exercise

Savor the moment, find your peace

• Appetizing food imagery (cupcake, doughnut, pancake, milkshake, ice cream, pineapple)
• Visual prompts for taste imagination
• Helps distract from panic-inducing thoughts
• Mindful visualization techniques

🫧 Bubble Pop Game

Interactive mindfulness through focused play

• Sequential bubble-popping game to engage cognitive focus
• Numbered bubbles (1-20) with satisfying pop sounds
• Helps redirect anxious thoughts through concentration
• Colorful, calming visual design with rewarding feedback

---

🚀 Installation

📋 Prerequisites

• 📱 Flutter SDK (3.0+)
• 💻 VS Code or Android Studio
• 🍎 Xcode (for iOS development)

🛠️ Quick Setup

1. Clone with love 💕

   git clone https://github.com/FatoomRe/Calm-Attack.git
   cd Calm-Attack
   

2. Install dependencies 📦

   flutter pub get
   

3. Launch your sanctuary 🚀

   flutter run
   

---

🎯 Usage

1. 🏠 Open the app - Your digital sanctuary awaits
2. 🎭 Choose your exercise - Pick what feels right for the moment
3. 🧘‍♀️ Follow the guidance - Let the app guide you through each technique
4. ☮️ Find your peace - One breath, one moment at a time

No account needed. No data collected. Just you and your path to calm.

---

🤝 Contributing

Every contribution saves lives! 💙 Whether you're a developer, designer, mental health professional, or someone with lived experience—your input makes a difference.

🌟 How You Can Help

🐛 Found a Bug?	💡 Have an Idea?	🎨 Love Design?	📚 Great at Writing?
Help us fix issues	Suggest new features	Improve the UI/UX	Enhance documentation
Report Here	Share Ideas	Design Away	Write With Us

🚀 Quick Start for Contributors

1. 🍴 Fork this repository
2. 🌿 Create your feature branch

   git checkout -b feature/amazing-feature
   

3. 💾 Commit your changes

   git commit -m 'Add amazing feature that helps people'
   

4. 📤 Push to the branch

   git push origin feature/amazing-feature
   

5. 🎉 Open a Pull Request

📖 New to open source? Check our Contributing Guide for detailed instructions!

🏆 Contributors Wall of Fame

Coming soon! Your name could be here, helping people find calm. ⭐

---

📚 Documentation

We've created comprehensive documentation to help you get involved:

📄 Document	📋 Description
🤝 Contributing Guide	Complete guide for new contributors
📝 Changelog	Development progress and project roadmap
📚 Full Documentation	Comprehensive project documentation

---

🎯 Roadmap

🔜 Coming Soon

• [ ] 🌙 Dark Mode - For nighttime panic relief
• [ ] 📊 Progress Tracking - See your journey to calm
• [ ] 🔔 Gentle Reminders - Preventive care notifications
• [ ] 🌍 Multi-Language - Help people worldwide
• [ ] 🎧 Custom Audio - Upload your own calming sounds

💭 Dream Features

• [ ] 🤖 AI Personalization - Techniques that adapt to you
• [ ] 👥 Anonymous Support - Community without exposure
• [ ] 📱 Wearable Integration - Help on your wrist
• [ ] 🏥 Professional Resources - Connect with help

Have an idea? Share it with us!

---

📄 License

This project is licensed under the MIT License.

Translation: You can use, modify, and distribute this freely. Because healing should be accessible to everyone, everywhere. 💙

---

💌 Contact