MindCompanion

Inspiration

Mental health issues like stress, overthinking, and loneliness are very common among students, but many don’t have a safe space to express their feelings. We wanted to build a simple and supportive platform where users can track their emotions, understand themselves better, and stay consistent in improving their mental well-being.

What it does

MindCompanion is an AI-powered mental wellness app that helps users: Track their daily mood and emotional intensity Maintain streaks and consistency using a calendar View mood patterns through charts and analytics Get personalized AI insights and daily wellness tips Use a focus timer for productivity and relaxation Chat with an AI companion and clear conversations anytime

How we built it

Frontend: React + TypeScript + Tailwind CSS Charts & UI: Recharts, Lucide icons, Framer Motion Backend: Firebase (Authentication + Firestore database) AI Integration: Gemini API for generating insights and tips Other Tools: date-fns for date handling, localStorage for caching

Challenges we ran into

Designing a clean and user-friendly UI for mental wellness Implementing accurate streak tracking and calendar logic Managing real-time data updates using Firestore Handling AI response delays and caching results efficiently Ensuring data security with proper Firestore rules

Accomplishments that we're proud of

Built a complete full-stack application as first-year students Successfully integrated AI for personalized insights Created a visually appealing and smooth user experience Implemented real-time tracking and analytics features Designed secure and structured backend rules

What we learned

How to build scalable full-stack applications Working with Firebase for real-time databases and authentication Integrating AI APIs into real-world projects Importance of UI/UX in user engagement Handling errors, performance, and security in applications

What's next for MindCompanion

Add mood prediction using machine learning Build a smarter AI chatbot with memory and context Provide personalized recommendations based on user behavior Add weekly reports and progress tracking Expand features for stress detection and mental health support

Built With

• authentication)-apis:-gemini-api-(for-ai-insights-and-tips)-tools-&-libraries:-date-fns
• firebase
• framer-motion-backend-&-database:-firebase-(firestore
• hosting
• javascript-frontend:-react
• languages:-typescript
• localstorage
• lucide-react
• platform
• tailwind-css-ui-&-visualization:-recharts