# 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.
[](https://flutter.dev)
[](https://dart.dev)
[](LICENSE)
[](https://github.com/ellerbrock/open-source-badges/)
## ๐ 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](#-features)
- [๐ Installation](#-installation)
- [๐ฏ Usage](#-usage)
- [๐ค Contributing](#-contributing)
- [๐ Documentation](#-documentation)
- [๐ฏ Roadmap](#-roadmap)
- [๐ License](#-license)
- [๐ Contact](#-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
https://github.com/user-attachments/assets/0bcc22bf-7c62-40f6-ba8c-3c11fd60e897
*Experience the journey from panic to peace*
---
## ๐ Installation
### ๐ Prerequisites
- ๐ฑ [Flutter SDK](https://flutter.dev/docs/get-started/install) (3.0+)
- ๐ป [VS Code](https://code.visualstudio.com/) or [Android Studio](https://developer.android.com/studio)
- ๐ [Xcode](https://developer.apple.com/xcode/) (for iOS development)
### ๐ ๏ธ Quick Setup
1. **Clone with love** ๐
```bash
git clone https://github.com/FatoomRe/Calm-Attack.git
cd Calm-Attack
```
2. **Install dependencies** ๐ฆ
```bash
flutter pub get
```
3. **Launch your sanctuary** ๐
```bash
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](https://github.com/FatoomRe/Calm-Attack/issues) | [Share Ideas](https://github.com/FatoomRe/Calm-Attack/issues) | [Design Away](https://github.com/FatoomRe/Calm-Attack/issues) | [Write With Us](https://github.com/FatoomRe/Calm-Attack/issues) |
### ๐ Quick Start for Contributors
1. **๐ด Fork** this repository
2. **๐ฟ Create** your feature branch
```bash
git checkout -b feature/amazing-feature
```
3. **๐พ Commit** your changes
```bash
git commit -m 'Add amazing feature that helps people'
```
4. **๐ค Push** to the branch
```bash
git push origin feature/amazing-feature
```
5. **๐ Open** a Pull Request
> ๐ **New to open source?** Check our [Contributing Guide](CONTRIBUTING.md) 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](CONTRIBUTING.md) | Complete guide for new contributors |
| [๐ Changelog](CHANGELOG.md) | Development progress and project roadmap |
| [๐ Full Documentation](DOCUMENTATION.md) | 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!](https://github.com/FatoomRe/Calm-Attack/issues)*
---
## ๐ License
This project is licensed under the [MIT License](LICENSE).
**Translation:** You can use, modify, and distribute this freely. Because healing should be accessible to everyone, everywhere. ๐
---
## ๐ Contact
### ๐ฉโ๐ป Meet the Creator
**Fatimah AlAbbas** - *Building with compassion, coding with care*
[](https://x.com/FatoomRe)
[](mailto:FatimahAlabbas1@outlook.sa)
---
### ๐ If this app helped you find calm, please star this repo
### ๐ Share it with someone who might need it
### ๐ Remember: You're stronger than your panic
---
*"You are braver than you believe, stronger than you seem, and more loved than you'll ever know."*
**Made with ๐ for everyone fighting the invisible battle**