Skip to content

FatoomRe/Calm-Attack

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

153 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

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

 
 
 

Contributors