Flow~State

home page
health score
tech stack
example of workout plan generated
Example of full schedule

Inspiration

Every morning, millions of people wake up to check their sleep scores, monitor their heart rates, and track their daily steps. We've become a generation obsessed with quantifying our well-being, wearing devices that capture every heartbeat and movement. Yet beneath this endless stream of metrics lies a deeper human truth: we're not just seeking numbers – we're searching for balance, energy, and a genuine sense of wellness in our increasingly demanding lives.

We created FlowState because we believe technology should work in harmony with our bodies, not just monitor them. Our breakthrough came from a simple insight: true wellness isn't about collecting more data—it's about understanding the unique patterns of your body and lifestyle, then turning those insights into meaningful change. By combining advanced biometric analysis with real-world behavioral data, FlowState creates a personalized path to optimal physical and mental performance.

This isn't just another wellness app. It's your intelligent companion for achieving that elusive state of flow, where stress melts away and everything just clicks. Welcome to the future of personalized wellness.

What it does

Flow~State is a personalized wellness platform that helps users improve their health and manage stress through tailored recommendations.

It creates customized workout plans and stress-relief activities by analyzing the user's biometric data, such as heart rate and activity levels, alongside their heart health history.
Automatically plots out events for you on Google Calendar
Displays heart disease risk and cardiovascular health score trained on 3k PPG data from regular and irregular heartbeats
The platform identifies the user's strengths and weaknesses to provide personalized suggestions.
It also builds a detailed understanding of what causes stress or relaxation for the user by combining insights from surveys, calendar data, and wearable devices.
Using this information, Flow~State recommends activities and locations to help reduce stress and seamlessly integrates these into the user's daily schedule. The result is a simple, user-friendly experience that supports better health and well-being.
You can plan events - such as "schedule a dinner with mom" - and based on past stress and fatigue patterns, Flowstate will find a time most suitable for when you feel most energetic and sociable.

How we built it

We developed a comprehensive health and wellness platform by hosting a backend in Flask using Python, which generated all the endpoints our frontend accessed to retrieve data.

To assess the user's heart health, we built a Neural Network-based prediction system trained on heart rate metrics from a biomedical PPG dataset, enabling it to predict the probability of a regular or irregular heartbeat.

Our backend utilized Perplexity Sonar to analyze a user's biometric data obtained via TerraAPI, combined with historical heart health data from our machine learning model, to create a personalized workout plan tailored to the user's strengths and weaknesses. Additionally, we conducted user surveys with friends and family to identify stress-inducing and stress-relieving activities and supplemented this by scraping Google Calendar data and comparing it with wearable device data to build a comprehensive database of stressors and de-stressors. Using Perplexity Sonar, we analyzed this database to recommend activities and locations that could help alleviate the user's stress.

We then integrated Google Gemini and the Google Calendar API to automatically schedule these workouts and stress-relief events into the user's calendar, ensuring a seamless experience.

To calculate an overall stress score, we aggregated various metrics from TerraAPI, including Heart Rate Variability, Heart Rate Fluctuations, blood pressure changes, glucose levels, body temperature, and oxygen saturation, providing a holistic evaluation of the user's stress levels.

For the frontend, we used SwiftUI to create a modern and intuitive interface that connected to all these backend endpoints, delivering a user-friendly experience.

Challenges we ran into

Juggling between creativity, complexity, and feasibility, we spent a significant amount of time brainstorming and rethinking our idea, which heavily tested our efficient task distribution, critical thinking, and technical ability, to actualize our product in less than one day’s time. We have encountered difficulties while acquiring complete data from API services, integrating components using endpoints to enable all of our desired features, and debugging complex scripts that all make up our complex pipeline. To tackle these issues, we actively communicated with sponsors regarding the status of our project and acquired valuable feedback to improve our project direction. We also ensured that each project member is on top of their task and assists one another when they are stuck on a tricky issue.

Accomplishments that we're proud of

We brought together diverse data streams—TerraAPI, PPG data, and Google Calendar—into one cohesive platform, unlocking a new level of personalization. By blending biometric analysis, machine learning, and user behavior insights, we crafted an adaptive wellness solution that evolves with each individual.

We designed a seamless, user-friendly experience powered by automated scheduling and a sleek SwiftUI frontend. Through extensive user surveys and data scraping, we built a rich database of stressors and de-stressors, enabling precise, actionable recommendations.

The outcome? A transformative tool that elevates physical and mental well-being, helping users unlock their full potential.

What we learned

We discovered the critical role of data accuracy and validation in biometric and health-related insights. We mastered best practices for handling sensitive data, ensuring compliance with privacy regulations, and building trust. Leveraging advanced machine learning models, like Perplexity Sonar and Gemini, enabled us to deliver hyper-personalized recommendations.

Integrating multiple APIs taught us the importance of seamless data flow between backend and frontend systems. We also learned that user feedback became our compass, guiding refinements to functionality and usability. These lessons are the foundation of our growth and innovation.

What's next for Flow~State

Imagine Flow~State as your 24/7 wellness ally, blending advanced biometrics like sleep, nutrition, and stress to deliver personalized insights. It starts as a personal health coach but quickly grows into a community hub, where users share progress, celebrate wins, and inspire each other. With real-time stress detection and instant activity suggestions, Flow~State keeps you balanced and focused, no matter how hectic life gets.