See your mental load. Act before burnout.
A mobile-first cognitive bandwidth monitor that visualizes mental load in real time — like a heart rate monitor for your mind — and suggests interventions before you hit overload.
- Production URL: https://shadowesu.github.io/Headspace_App/
- Optimized for mobile; best viewed on a phone-sized viewport.
npm i
npm run devOpen http://localhost:5500/Headspace_App/ — visit / (Onboarding) or /home (dashboard).
| Path | Purpose |
|---|---|
/ |
Onboarding & cognitive archetype |
/home |
Main dashboard with bandwidth orb |
/live-session |
Real-time session tracking |
/weekly-report |
Historical charts & patterns |
/interventions |
Intervention library |
/group |
Team/classroom mode |
/environment-radar |
Live weather, air quality, UV, pollen |
/sense |
About cognitive bandwidth |
/safeguards |
Settings, privacy, emergency |
/hospitals |
Nearby hospital search |
/widget |
Compact wearable display |
The Environment Radar (/environment-radar) fetches live data directly from your browser:
| API | Data | Key required |
|---|---|---|
| ipapi.co | Location | No |
| Open-Meteo | Weather, UV, sun | No |
| Open-Meteo Air Quality | PM2.5, PM10, AQI | No |
| Open-Meteo Pollen | Grass, tree, weed | No |
| OpenWeatherMap | Weather (optional) | Yes |
| NewsAPI | Headlines (optional) | Yes |
Add optional keys to .env:
VITE_OPENWEATHER_API_KEY= # Enhanced weather
VITE_NEWS_API_KEY= # News headlines for stress contextThe /hospitals page uses Google Maps Places API:
- Copy
.env.exampleto.env - Get an API key from Google Cloud Console
- Enable Maps JavaScript API and Places API
- Add
VITE_GOOGLE_MAPS_API_KEY=your_keyto.env
The original UI was designed in Figma (Headspace cognitive bandwidth dashboard with bento-style cards, breathing orb, and mobile-first layout).
You can link your file here, for example:
- Figma prototype: add your Figma link here
The app is configured and live at https://shadowesu.github.io/Headspace_App/:
- Enable GitHub Pages: Settings → Pages → Source: GitHub Actions
- Push to
main— the workflow builds and deploys automatically
Or deploy manually:
npm run build
npm run deploy:gh- Import repo at vercel.com
- Build:
npm run build— Output:dist - Add env vars for Google Maps, OpenWeather, NewsAPI
- Deploy
- Import from Git at netlify.com
- Build:
npm run build— Publish:dist - Deploy
npm run build
npm run previewOpens at http://localhost:4173/Headspace_App/
React 18 · TypeScript · Vite · Tailwind CSS v4 · Motion · shadcn/ui · Recharts
MIT