A comprehensive, evidence-based mental health tracking application designed to help individuals understand, monitor, and manage their emotional triggers through therapeutic insights and data-driven self-awareness.
Start your therapeutic journey with secure, evidence-based mental health tracking.
- 🚀 Live Application
- 🌟 Overview
- ✨ Features
- 🔬 Therapeutic Framework
- 🚀 Quick Start
- 📦 Installation
- 🎯 Usage
- 📊 Screenshots
- 🛠️ Technical Details
- 🏗️ Architecture
- 🤝 Contributing
- 📚 Resources
- 📄 License
- 👨⚕️ Disclaimer
The Therapeutic Trigger Tracker is a sophisticated mental health application that combines evidence-based psychological frameworks with modern data visualization to provide users with deep insights into their emotional patterns and triggers. Built with Python and Streamlit, it offers a professional-grade therapeutic tracking experience while remaining accessible and user-friendly.
Empowering individuals with data-driven self-awareness tools to understand, process, and grow from their emotional experiences through evidence-based therapeutic approaches.
- 🔍 Pattern Recognition: Identify recurring triggers and emotional responses
- 📈 Progress Tracking: Monitor your healing journey with quantifiable metrics
- 🛠️ Coping Tools: Access evidence-based therapeutic techniques
- 🎯 Personalized Insights: Receive tailored recommendations based on your data
- 💪 Empowerment: Take control of your mental health journey
- 🔐 Secure Accounts: User authentication system to protect your private data
- 📅 Historical Tracking: Monitor your progress over time with personalized data
- Secure sign-up and login system to protect your privacy
- Individual user accounts with isolated data storage
- Password protection for your sensitive information
- Personalized experience tailored to your journey
- Multi-dimensional trigger categorization (Interpersonal, Environmental, Cognitive, Physical, etc.)
- Enhanced emotional tracking including complex emotions (shame, loneliness, overwhelm)
- Narrative therapy elements (before/after contexts, thoughts, physical sensations)
- Coping strategy effectiveness rating
- Therapeutic check-ins (self-compassion, safety, energy levels)
- Real-time wellness scoring algorithm
- Emotional trend analysis with moving averages
- Trigger pattern recognition across time and location
- Intensity correlation studies
- Progress indicators with visual feedback
- Personalized historical data tracking over time
- Personalized recommendations based on clinical frameworks
- Evidence-based intervention suggestions
- Crisis support indicators for high-intensity patterns
- Pattern analysis using psychological best practices
- Growth tracking with milestone recognition
- Guided breathing exercises with visual prompts
- 5-4-3-2-1 grounding techniques with interactive guidance
- Self-compassion breaks with therapeutic scripts
- Personalized coping plans for different intensity levels
- Emergency resource management
- SMART goal setting with progress calculations
- Achievement system with therapeutic milestones
- Consistency tracking with streak monitoring
- Long-term trend visualization
- Wellness score evolution
- Advanced search and filtering across all data fields
- Chronological organization with multiple sorting options
- Detailed entry views with therapeutic context
- Data export capabilities for professional consultation
This application integrates multiple evidence-based therapeutic approaches:
- Thought pattern identification and tracking
- Behavioral response analysis
- Mood-behavior correlation studies
- Cognitive restructuring support
- Distress tolerance skill tracking
- Emotion regulation measurements
- Interpersonal effectiveness indicators
- Mindfulness integration
- Values alignment assessment
- Psychological flexibility tracking
- Mindful awareness practices
- Acceptance-based interventions
- Safety-focused design principles
- Trustworthiness and transparency
- Choice and collaboration emphasis
- Strengths-based approach
Access the App Here - No installation required!
# Clone the repository
git clone https://github.com/worldsocoled/therapeutic-trigger-tracker.git
# Navigate to project directory
cd therapeutic-trigger-tracker
# Install dependencies
pip install -r requirements.txt
# Run the application
streamlit run app.py🌐 visit the live app: https://therapeutic-trigger-tracker-4f8zqxgabnkfgp3wayghkj.streamlit.app/**
- Python 3.7+ (recommended: Python 3.9+)
- pip package manager
streamlit>=1.25.0
pandas>=1.5.0
plotly>=5.0.0
numpy>=1.20.0
supabase>=2.0.0pip install streamlit pandas plotly numpypip install -r requirements.txtconda create -n trigger-tracker python=3.9
conda activate trigger-tracker
pip install -r requirements.txtstreamlit --version
python -c "import pandas, plotly, numpy; print('All dependencies installed successfully!')"- Create an Account: Sign up with a secure username and password
- Log In: Access your personalized dashboard with your credentials
- Data Privacy: Your entries are stored securely and privately
- ✨ New Entry: Log detailed trigger experiences with therapeutic context
- 📊 Dashboard: View real-time analytics and emotional trends
- 🎯 Insights: Receive personalized therapeutic recommendations
- 🛠️ Coping Tools: Access evidence-based therapeutic techniques
- 📈 Progress: Track long-term growth and set therapeutic goals
- 📚 All Entries: Manage and review your complete therapeutic journal
- Daily Consistency: Aim for daily entries to capture comprehensive patterns
- Honest Reflection: The app is most effective with genuine, honest entries
- Regular Review: Weekly review of insights and progress for optimal growth
- Professional Integration: Share data with your therapist for enhanced treatment
- Goal Setting: Use the progress tracking to set and achieve therapeutic goals
- Take three deep breaths before beginning each entry
- Be specific about triggers and circumstances
- Include physical sensations and emotional nuances
- Rate coping effectiveness honestly
- Practice self-compassion in your reflections
Real-time wellness metrics and emotional trend analysis
Comprehensive trigger logging with therapeutic framework integration
Personalized recommendations based on evidence-based psychology
Interactive therapeutic techniques with guided instructions
Secure login and sign-up system for personalized tracking
- Frontend: Streamlit with custom CSS/HTML
- Backend: Python with pandas for data processing
- Visualization: Plotly for interactive charts
- Data Storage: CSV files with user authentication system
- Styling: Glass morphism design with therapeutic color psychology
User Schema:
- username: string (unique)
- password: string (hashed)
Entry Schema:
- user_id: string (linked to user account)
- timestamp: datetime
- trigger: string (categorized)
- intensity: integer (1-10)
- emotions: multiple integers (anxiety, sadness, anger, etc.)
- coping_strategies: array
- effectiveness: integer (1-10)
- context: object (before, after, thoughts, physical)
- therapeutic_metrics: object (self-compassion, safety, energy)- Wellness Score Calculation: Multi-factor algorithm considering negative emotions, positive emotions, and coping effectiveness
- Pattern Recognition: Time-series analysis for trigger identification
- Progress Tracking: Trend analysis with moving averages
- Recommendation Engine: Rules-based system using therapeutic best practices
- User Authentication: Secure password hashing and verification
- Responsive Design: Mobile-first approach with responsive layouts
- Fast Loading: Optimized data processing and caching
- Scalable: Handles thousands of entries efficiently
- Accessible: WCAG 2.1 compliance with proper contrast ratios
- Secure: Password protection and user data isolation
therapeutic-trigger-tracker/
├── 📄 app.py # Main Streamlit application
├── 📁 data/ # Data storage directory
│ ├── users.csv # User authentication data
│ ├── user_data/ # Individual user data directory
│ │ ├── user1_entries.csv # User-specific trigger entries
│ │ ├── user1_goals.csv # User-specific goal tracking
│ │ └── user1_coping.csv # User-specific coping plans
├── 📁 utils/ # Utility functions
├── 📁 assets/ # Images and static files
├── 📋 requirements.txt # Python dependencies
├── 📖 README.md # Project documentation
└── 📄 LICENSE # MIT License
Key Components:
├── 🎨 CSS Styling # Therapeutic design with glass morphism
├── 📊 Data Processing # Pandas-based analytics
├── 📈 Visualization # Plotly interactive charts
├── 🧠 Therapeutic Logic # Evidence-based algorithms
├── 🔐 Authentication System # User login and sign-up functionality
└── 🔧 Helper Functions # Utility and calculation functions
We welcome contributions from mental health professionals, developers, and users! Here's how you can help:
- 🐛 Bug Reports: Submit issues with detailed reproduction steps
- 💡 Feature Requests: Suggest new therapeutic tools or insights
- 📝 Documentation: Improve README, comments, or user guides
- 🧠 Therapeutic Input: Mental health professionals can suggest evidence-based improvements
- 💻 Code Contributions: Submit pull requests with new features or fixes
# Fork the repository
git clone https://github.com/worldsocoled/therapeutic-trigger-tracker.git
# Create a feature branch
git checkout -b feature/your-feature-name
# Make changes and commit
git commit -m "Add: therapeutic feature description"
# Push and create pull request
git push origin feature/your-feature-name- Follow Python PEP 8 style guidelines
- Include docstrings for new functions
- Add comments for therapeutic rationale
- Test changes with sample data
- Update documentation for new features
- Cognitive Behavioral Therapy Techniques
- Dialectical Behavior Therapy Skills
- Acceptance and Commitment Therapy
- Trauma-Informed Care Principles
- Crisis Text Line: Text HOME to 741741
- National Suicide Prevention Lifeline: 988
- SAMHSA National Helpline: 1-800-662-4357
- Psychology Today Therapist Finder
This project is licensed under the MIT License - see the LICENSE file for details.
MIT License
Copyright (c) 2024 Therapeutic Trigger Tracker
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
This application is designed for educational and self-reflection purposes only and is not intended to replace professional mental health care.
- 🩺 Not a Medical Device: This app is not a substitute for professional diagnosis or treatment
- 👩⚕️ Seek Professional Help: Always consult qualified mental health professionals for clinical concerns
- 🚨 Emergency Situations: If you're experiencing thoughts of self-harm, contact emergency services immediately
- 📊 Data Privacy: Your data is stored securely with user authentication protection
- 🔒 No Guarantees: While based on evidence-based practices, results may vary
- Immediate Danger: Call 911 (US) or your local emergency number
- Suicide Prevention: Call 988 (US) or visit suicidepreventionlifeline.org
- Crisis Text Line: Text HOME to 741741
- 🐛 Issues: GitHub Issues
- 💬 Discussions: GitHub Discussions
- 📧 Email: worldsocoledwebartistry@gmail.com (for sensitive inquiries)