https://github.com/alvinunreal/anxiety-aid-tools
Free open source tools to help you find calm when you need it most.
https://github.com/alvinunreal/anxiety-aid-tools
anxiety anxiety-helper breathing breathing-exercises privacy-focused self-help self-help-tool
Last synced: 5 months ago
JSON representation
Free open source tools to help you find calm when you need it most.
- Host: GitHub
- URL: https://github.com/alvinunreal/anxiety-aid-tools
- Owner: alvinunreal
- License: gpl-3.0
- Created: 2025-08-11T19:01:59.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-11-28T23:37:50.000Z (7 months ago)
- Last Synced: 2025-11-29T07:41:25.298Z (7 months ago)
- Topics: anxiety, anxiety-helper, breathing, breathing-exercises, privacy-focused, self-help, self-help-tool
- Language: Vue
- Homepage: https://anxietyaidtools.com
- Size: 227 MB
- Stars: 227
- Watchers: 6
- Forks: 22
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Anxiety Aid Tools
**Evidence-based techniques to find calm when you need it most**
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://github.com/alvinunreal/anxiety-aid-tools)
[](https://github.com/alvinunreal/anxiety-aid-tools/stargazers)
[**Website**](https://anxietyaidtools.com/) · [**Mobile Apps**](https://anxietyaidtools.com/mobile) · [**Community**](https://www.reddit.com/r/AnxietyAidTools/) · [**Contribute**](#contributing)
*Transform anxious moments into opportunities for calm with scientifically-backed breathing exercises, grounding techniques, and mindfulness tools.*
---
## What Makes This Special
A collection of anxiety management techniques built around four core principles.
### 🚪 **No Barriers**
- **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](https://anxietyaidtools.com/mobile) for on-the-go access
### 🔒 **Privacy First**
- **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
### 🧬 **Open Source**
- **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
### 🧠 **Science-Based**
- **Research-backed techniques** - Methods studied in clinical settings
- **Educational content** - Understanding why techniques work
- **Evidence references** - Links to supporting research where available
---
## 🛠️ Interactive Techniques
| 🫁 **Breathing** | ⚓ **Grounding** | 🧘 **Visualization** | 💭 **Mindfulness** |
|:---:|:---:|:---:|:---:|
| Guided breathing patterns | 5-4-3-2-1 sensory technique | Peaceful place imagery | Thought labeling |
| 2-3 minutes | 3-5 minutes | 5-10 minutes | 5-10 minutes |
### 🌟 **Featured Techniques**
- **🫁 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
---
## **Why Open Source Mental Health Matters**
> **"Mental health tools should be accessible to everyone, everywhere, without barriers."**
### **Our Mission**
- **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
### **Community Impact**
- **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
---
## **Quick Start**
### 🌐 Web & Mobile
- **Web**: Visit [anxietyaidtools.com](https://anxietyaidtools.com/)
- **Mobile Apps**: Download for [iOS or Android](https://anxietyaidtools.com/mobile)
### 🐳 Docker (Self-Hosted)
```bash
# 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
```
### 💻 Local Development
```bash
git clone https://github.com/alvinunreal/anxiety-aid-tools.git
cd anxiety-aid-tools
pnpm install
pnpm run dev
```
## **For Contributors**
```bash
# 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
```
---
### **Clinical Disclaimer**
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.
---
## **Contributing**
We believe the best mental health tools are built by communities who understand the challenges firsthand.
### **Ways to Help**
- **Report bugs** - Help us improve reliability ([GitHub Issues](https://github.com/alvinunreal/anxiety-aid-tools/issues))
- **Suggest features** - Share ideas for new techniques ([r/AnxietyAidTools](https://www.reddit.com/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](https://www.reddit.com/r/AnxietyAidTools/)
### **Development Setup**
```bash
# 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
```
### **Code Structure**
```
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
```
### **Peaceful Visualization Audio**
We generate the narration tracks with the ElevenLabs Text-to-Speech API.
1. Create an API key at [ElevenLabs](https://elevenlabs.io/app/settings/api-keys) and expose it before running the generator:
```bash
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:
```bash
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///.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.
---
## **Asset Attribution**
- **Illustrations** - Generated using ChatGPT
- **Audio Narration** - Generated using ElevenLabs Text-to-Speech API
---
## **License**
GPL License - feel free to use, modify, and distribute. Mental health tools should be open and accessible.
### **Using Our Assets**
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.
---
**If this project helped you, consider starring it to help others discover these techniques.**
[**⭐ Star on GitHub**](https://github.com/alvinunreal/anxiety-aid-tools) • [**📱 Mobile Apps**](https://anxietyaidtools.com/mobile) • [**💬 r/AnxietyAidTools**](https://www.reddit.com/r/AnxietyAidTools/) • [**🐛 Report Issues**](https://github.com/alvinunreal/anxiety-aid-tools/issues)
*Remember: You're stronger than your anxiety, and you're not alone in this journey.*