Anxiety Aid Tools

Evidence-based techniques to find calm when you need it most

Website · Mobile Apps · Community · Contribute

Transform anxious moments into opportunities for calm with scientifically-backed breathing exercises, grounding techniques, and mindfulness tools.

A collection of anxiety management techniques built around four core principles.

• No signup required - Open the website and start immediately
• No ads - Clean interface focused on what matters
• Works offline - Available when you need it, regardless of connection
• Native mobile apps - iOS and Android apps for on-the-go access

• Minimal analytics - Privacy-focused Cloudflare Web Analytics only
• No personal tracking - No cookies, fingerprinting, or personal data collection
• Local storage only - All preferences saved on your device
• Aggregate data only - Analytics are anonymized and aggregated

• Code is public - Anyone can inspect, improve, or adapt it
• Community maintained - Built by people who understand anxiety
• GPL licensed - Free to use, modify, and redistribute

• Research-backed techniques - Methods studied in clinical settings
• Educational content - Understanding why techniques work
• Evidence references - Links to supporting research where available

• 🫁 Breathing Exercises - Interactive animations guide your breath rhythm
• ⚓ 5-4-3-2-1 Grounding - Sensory awareness to anchor you in the present
• 🎯 Guided Breathing - Customizable breath patterns with visual cues
• 💪 Progressive Muscle Relaxation - Release physical tension systematically
• 🌅 Peaceful Visualization - Immersive guided imagery sessions
• 🧠 Thought Labeling - Cognitive techniques to reframe anxious thoughts
• 🫧 Stress Relief Bubbles - Interactive bubble-popping for instant relief
• 🌀 Online Fidget Spinner - Minimal virtual spinner with realistic momentum for restless energy
• 🎵 Sound Therapy - Calming ambient soundscapes
• ⚾ Virtual Stress Ball - Tactile relief through digital interaction

"Mental health tools should be accessible to everyone, everywhere, without barriers."

• Remove barriers to mental health support
• Democratize access to evidence-based techniques
• Build trust through transparency and community input
• Enable customization for different cultures and needs

• Global reach - No geographic restrictions
• Always free - No premium features or paywalls
• Privacy respectful - Minimal anonymized analytics to improve the service
• Community-driven - Built by and for people who understand anxiety

• Web: Visit anxietyaidtools.com
• Mobile Apps: Download for iOS or Android

# Quick run from Docker Hub
docker run -p 3000:3000 alvinunreal/anxiety-aid-tools:latest

# Or build and run with Docker Compose
git clone https://github.com/alvinunreal/anxiety-aid-tools.git
cd anxiety-aid-tools
docker compose up

git clone https://github.com/alvinunreal/anxiety-aid-tools.git
cd anxiety-aid-tools
pnpm install
pnpm run dev

# Fork the repository
gh repo fork alvinunreal/anxiety-aid-tools

# Make your improvements
git checkout -b feature/your-improvement

# Sync translations (if you modified text)
npm run sync-locales

# Submit your contribution
gh pr create

This tool provides general anxiety management techniques and is not a substitute for professional mental health treatment. If you're experiencing persistent anxiety, please consult a healthcare provider.

We believe the best mental health tools are built by communities who understand the challenges firsthand.

• Report bugs - Help us improve reliability (GitHub Issues)
• Suggest features - Share ideas for new techniques (r/AnxietyAidTools)
• Add translations - Make it accessible to more people
• Improve content - Enhance educational materials
• Design contributions - Better UX for people in distress
• Share your story - Help others by sharing how these tools helped you on our subreddit

# Install dependencies
pnpm install

# Start development server
pnpm dev

# Run with HTTPS (for testing PWA features)
pnpm dev-https

# Build for production
pnpm build

# Check translations are in sync
pnpm sync-locales

# Generate scene narration (see "Peaceful Visualization Audio" below)
pnpm generate:peaceful-visualization --lang en

anxiety-aid-tools/
├── components/          # Reusable Vue components
│   ├── *Exercise.vue   # Interactive technique components
│   └── TechniquesGrid.vue
├── composables/        # Shared logic
│   └── useTechniques.js # Technique data and utilities
├── i18n/              # Internationalization
│   └── locales/       # Translation files
├── pages/             # Route components
│   └── [technique].vue # Individual technique pages
└── public/            # Static assets
    └── aat.svg        # App logo

We generate the narration tracks with the ElevenLabs Text-to-Speech API.

1. Create an API key at ElevenLabs and expose it before running the generator:

   export ELEVENLABS_API_KEY=sk-your-key-here

   You can also place it in a .env file that your shell loads.
2. Run the helper script from the project root:

   pnpm generate:peaceful-visualization --lang en

   • Choose a single scene when prompted, or pass --scene all to batch the whole exercise.
   • Use --overwrite to re-generate clips that already exist, or --dry-run to preview without hitting the API.
3. Generated audio files are written to public/audios/peaceful-visualization/<locale>/<scene>/<step>.mp3.
   The Vue exercise automatically picks them up based on the current locale and scene.

Repeat step 2 for each supported locale once you have suitable voices configured in ElevenLabs.

• Illustrations - Generated using ChatGPT
• Audio Narration - Generated using ElevenLabs Text-to-Speech API

GPL License - feel free to use, modify, and distribute. Mental health tools should be open and accessible.

All assets in this project (illustrations, audio, etc.) are included under the same GPL v3 license as the code. You're welcome to use them in your own projects. Attribution is appreciated — if you use our assets, please credit Anxiety Aid Tools.