Project Info
This project did not submit a demo video on Devpost.
Inspiration
More than 4 in 10 (42%) students face mental health challenges, and we've all had days when stress makes school even tougher. This platform empowers teachers with real-time insights into students' well-being and provides AI-driven suggestions to adjust lessons and workloads, creating a more supportive and successful classroom environment.
What it does
MindSpace is a Mental Health Platform for School Students (K-12), designed to help teachers understand their students' emotional and mental well-being through real-time polls. It provides AI-generated suggestions (via the Gemini API) on how to structure lessons and manage workloads based on students' moods and feelings.
How we built it
We built this platform using a combination of Firebase for real-time data storage, Gemini AI to generate personalized suggestions for teachers, and HTML, CSS, and JavaScript for the front-end interface. The platform collects and analyzes students' emotional data through simple polls and uses AI to recommend how teachers can adapt their lessons and workloads to best support their students' mental well-being.
Challenges we ran into
One of the biggest challenges we faced was integrating Firebase for real-time data collection and ensuring seamless storage and retrieval of students' poll responses. Managing the dynamic data flow while keeping the interface responsive was crucial. Another challenge was integrating the Gemini API to generate personalized suggestions for teachers. Ensuring the API could process real-time emotional data from students and return meaningful, actionable feedback required precise coordination between our back-end and front-end systems. On top of that, we struggled with Wi-Fi issues at Cal Hacks, constantly having to move around to find the best spot to work. Despite these obstacles, we balanced the technical challenges while maintaining an easy-to-use interface, making the process rewarding.
Accomplishments we're proud of
We’re incredibly proud of building this web app in just 48 hours with a team of only two. Over the course of the hackathon, we developed an 11-page platform that integrates Firebase for real-time data and the Gemini API for AI-driven suggestions. Despite the tight deadline and small team size, we successfully created a fully functional app that empowers teachers to better support their students' mental well-being.
What we learned
Throughout this project, we learned the importance of managing time and tasks effectively, especially when working with a tight deadline. We deepened our understanding of Firebase for real-time data handling and gained valuable experience integrating third-party APIs like Gemini into a dynamic web app.
What's next
Next for MindSpace, we're developing a mobile app for greater accessibility and adding a mental health resource hub to support students. We plan to expand the platform beyond schools to universities and even workplaces, increasing its impact on well-being across different environments.
MindSpace
Inspiration
More than 4 in 10 (42%) students face mental health challenges, and we've all had days when stress makes school even tougher. This platform empowers teachers with real-time insights into students' well-being and provides AI-driven suggestions to adjust lessons and workloads, creating a more supportive and successful classroom environment.
What it does
MindSpace is a Mental Health Platform for School Students (K-12), designed to help teachers understand their students' emotional and mental well-being through real-time polls. It provides AI-generated suggestions (via the Gemini API) on how to structure lessons and manage workloads based on students' moods and feelings.
How we built it
We built this platform using a combination of Firebase for real-time data storage, Gemini AI to generate personalized suggestions for teachers, and HTML, CSS, and JavaScript for the front-end interface. The platform collects and analyzes students' emotional data through simple polls and uses AI to recommend how teachers can adapt their lessons and workloads to best support their students' mental well-being.
Challenges we ran into
One of the biggest challenges we faced was integrating Firebase for real-time data collection and ensuring seamless storage and retrieval of students' poll responses. Managing the dynamic data flow while keeping the interface responsive was crucial. Another challenge was integrating the Gemini API to generate personalized suggestions for teachers. Ensuring the API could process real-time emotional data from students and return meaningful, actionable feedback required precise coordination between our back-end and front-end systems. On top of that, we struggled with Wi-Fi issues at Cal Hacks, constantly having to move around to find the best spot to work. Despite these obstacles, we balanced the technical challenges while maintaining an easy-to-use interface, making the process rewarding.
Accomplishments that we're proud of
We’re incredibly proud of building this web app in just 48 hours with a team of only two. Over the course of the hackathon, we developed an 11-page platform that integrates Firebase for real-time data and the Gemini API for AI-driven suggestions. Despite the tight deadline and small team size, we successfully created a fully functional app that empowers teachers to better support their students' mental well-being.
What we learned
Throughout this project, we learned the importance of managing time and tasks effectively, especially when working with a tight deadline. We deepened our understanding of Firebase for real-time data handling and gained valuable experience integrating third-party APIs like Gemini into a dynamic web app.
What's next for Mind Space
Next for MindSpace, we're developing a mobile app for greater accessibility and adding a mental health resource hub to support students. We plan to expand the platform beyond schools to universities and even workplaces, increasing its impact on well-being across different environments. We also plan to optimize our application. The files are currently organized to simply work. We want to work on authentication protocols, api secruities and introducing colours that will not dictate/have an effect while aswering the questions.
Analysis
View
Metric
- 2
Figures cover GitHub contributors during the hackathon window. A co-authored commit counts in full for each author, so per-member totals add up to more than the whole-team figures.
Technology
- CSSIn code
- HTMLIn code
- JavaScriptIn code
- FirebaseClaimed
3 of 4 appear in the indexed code. 1 claimed on Devpost could not be matched to code, which may simply mean the tool leaves no trace in the repository.
AI coding agents
No AI coding agent signals were found in this repository.
Detected from committed agent config files and commit authorship. Absence of a signal is not proof an agent was unused.
Codebase size
Source size
47 KB
Source files
16
Counts recognized source files only; vendored directories, binaries and lockfiles are excluded, so this is smaller than the repository on disk.
Repository
Madesh3/MindSpace
19 files · 63 KB · @ 8e0b1ab
Structure
Interface
14 files · 74%Screens, components and styles rendered to the user.
Application logic
2 files · 11%Domain rules, services and shared utilities.
Supporting
Layers are inferred from where files sit in the tree, not from reading the code. A project that names its directories unconventionally will read oddly here — open the file browser to check anything the diagram implies.
Languages
- HTML79%
- CSS10%
- Markdown10%
- JavaScript2%
Share of indexed source by file size. Binary and vendored files are excluded.
This project’s features have not been analysed yet.
Export this project's context (description, README, evidence, key source files) to chat with an AI agent elsewhere.