MindBalance
References
TSA Requirements Guide
Use this guide to quickly locate each TSA Webmaster requirement on our site. Click any item to navigate directly to that feature.
Interactive Resource Directory
Our Resource Library features a searchable, filterable directory of community resources. Users can search by keyword, filter by category (Anxiety, Depression, Stress, Mindfulness, etc.) and provider (NIMH, Mayo Clinic, CDC), sort results, and use active filter chips to refine their search.
Visit Resource LibraryFeatured Resource Spotlights
The Resource Library includes a dedicated "Featured Resources" spotlight section at the top that highlights community resources with featured badges, provider names, descriptions, and direct links to learn more about each resource.
View SpotlightsResource Submission Form
Users can suggest new community resources through our "Suggest a Resource" form in the Resource Library. The form collects the resource name, description, category, provider, website URL, phone number, address, and submitter email.
Open Submission FormAdditional Content Enhancing the Hub
Beyond the core directory, our site enhances the community resource hub with these features:
Competition Documents
Please review the following documentation for our project submission.
Project Overview
MindBalance is a comprehensive mental health education and support hub built for students and young adults. Our mission is to provide accessible, credible information about mental health topics while connecting users with professional resources and community support.
The platform addresses the growing need for reliable mental health information by curating content from authoritative sources like the National Institute of Mental Health (NIMH), Mayo Clinic, and other trusted providers. Users can explore educational articles, find local mental health services, connect with community members, and access crisis support resources.
MindBalance was designed with accessibility as a core principle, offering features like dark mode, adjustable font sizes, colorblind modes, dyslexia-friendly fonts, and focus mode for users with ADHD.
Originality Statement
This website was designed and built entirely from scratch by our team using custom HTML, CSS, and JavaScript. No pre-built templates, themes, or framework systems were used in the creation of this site.
API & AI Usage Compliance Statement
This website integrates several third-party APIs and services to enhance its functionality. These services are used strictly as tools to support features. They do not generate, modify, or write any of our website's code, content, or design. All HTML, CSS, and JavaScript was written entirely by our team.
- OpenAI API: Powers the AI Wellness Companion chatbot, providing conversational responses to user messages. The API receives user input and returns text responses. It does not generate, alter, or contribute to any part of our website's source code, layout, or design.
- ElevenLabs API: Provides text-to-speech audio so users can listen to articles. The API converts our existing article text into audio files. It does not create or modify any website content.
- Supabase: Serves as our database and authentication provider. It stores user data (profiles, posts, mood logs, etc.) and handles login/registration. It does not generate any frontend code or assets.
- Resend API: Sends newsletter welcome emails to subscribers. It delivers emails we designed. It does not create content or modify our site.
- Vercel: Hosts and serves our static website files (HTML, CSS, JS, images). It is a hosting platform only. It does not generate or alter any code.
In summary, no AI tool, API, or external service was used to write, generate, or modify any line of our website's code. No external service adds content, obtains assets, or alters our design. All APIs serve purely as functional tools that our custom-written code calls upon to deliver features to our users.
Features
Resource Library
Interactive directory featuring credible mental health resources from organizations like NAMI, Mental Health America, Crisis Text Line, and The Trevor Project. Includes search, filtering by category, and a spotlight section for featured resources.
Community Hub
Moderated forum for peer support with posts, comments, likes, and real-time updates. Features profanity filtering, media uploads, @mentions system, and admin moderation tools.
Educational Articles
In-depth articles on anxiety, depression, stress, mindfulness, sleep, and teen mental health. Features text-to-speech audio, reading progress tracking, bookmarking, and related articles recommendations.
Crisis Support
Always-visible crisis resources including 988 Suicide & Crisis Lifeline, Crisis Text Line, and The Trevor Project. Quick access from every page ensures help is never more than a click away.
Accessibility Settings
7 accessibility options: Dark Mode, Font Size adjustment, High Contrast, three Colorblind modes (Protanopia, Deuteranopia, Tritanopia), Focus Mode for ADHD, Dyslexia-friendly font, and Reduced Motion.
User Profiles
Profiles with customizable avatars, bio, social links, mood tracking, wellness goals, reading streak calendar, achievements, and privacy controls.
Multilingual Support
Full translation support for 8 languages: English, Spanish, French, Chinese (Simplified), Hindi, Korean, German, and Greek. Language preference persists across sessions.
Find Help Locator
ZIP code-based search to find local mental health services using the SAMHSA Treatment Locator API. Filter by service type and radius, with direct call and directions buttons.
News & Stories
Curated mental health news, recovery stories, workplace wellness articles, and community spotlights. Features real-time content with text-to-speech and full reading controls.
Tech Stack
Frontend
- HTML5, CSS3, JavaScript (ES6+)
- Custom CSS with CSS Variables for theming
- Responsive design with mobile-first approach
- Swiper.js for carousels
- Ionicons for iconography
Backend & Data
- Python Flask server
- Supabase (PostgreSQL) for database
- Supabase Auth for authentication
- Supabase Realtime for live updates
- Supabase Storage for media uploads
APIs & Integrations
- SAMHSA Treatment Locator API
- ElevenLabs API for text-to-speech
- OpenAI API for AI wellness insights
- Resend API for newsletter emails
- Formspree for form submissions
- Supabase API for backend services
Content Sources
- National Institute of Mental Health (NIMH)
- Mayo Clinic
- American Psychological Association
- NAMI, Mental Health America
- SAMHSA
Image & Design Sources
- Unsplash for photography
- Canva for graphics & design
- Ionicons for icon library
- Google Fonts (Poppins)