Skip to content

A Flutter-based mobile application designed to help users manage panic attacks. Provides a range of exercises and techniques to help them calm their mind and body during anxiety moments.

License

Notifications You must be signed in to change notification settings

FatoomRe/Calm-Attack

Repository files navigation

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.

iphone-slow-reveal

Flutter Dart License: MIT Open Source Love

🌈 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

🫁 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
0723.1.mp4

Experience the journey from panic to peace


🚀 Installation

📋 Prerequisites

🛠️ 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

👩‍💻 Meet the Creator

Fatimah AlAbbas - Building with compassion, coding with care

Twitter Email


🌟 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

About

A Flutter-based mobile application designed to help users manage panic attacks. Provides a range of exercises and techniques to help them calm their mind and body during anxiety moments.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published