What I Built
VITALFLOW — Your body. Your rhythm. Your world. 🌱
VITALFLOW is an interactive ambient digital garden desktop application powered by real-time, contactless human sensing.
What if your body could interact with a digital environment without wearing a smartwatch, fitness band, or any external sensor?
That's the idea behind VITALFLOW. Instead of presenting physiological readings through a traditional clinical dashboard, VITALFLOW transforms subtle optical signals captured through a standard webcam into a beautiful, living HTML5 Canvas environment.
Users can explore three synchronized generative worlds:
Living Garden: Organic rings and natural elements that expand and contract in response to breathing patterns.
Cosmic Waves: Flowing waves and glowing particles that respond to physiological rhythms.
Breathing Mandala: A symmetrical, evolving visual experience driven by breathing and cardiovascular signals.
How It Works
VITALFLOW integrates the official Presage SmartSpectra SDK to process optical signals captured through a webcam.
The application translates physiological measurements into visual interactions:
Breathing Rate: Controls the expansion and contraction of garden rings, horizon waves, and mandala petals.
Pulse Rate: Influences particle movement and triggers visual ripples synchronized with heartbeat peaks.
Heart Rate Variability (HRV): Modulates visual complexity and symmetry only when valid HRV measurements are available.
Signal Quality: Detects unsuitable lighting, framing, distance, and motion conditions, providing real-time calibration guidance.
The application guides users through a welcome screen, explicit camera consent, calibration, an interactive measurement environment, and a session reflection summary.
Privacy and Responsible Design
Privacy was a core consideration throughout development.
Camera frames are processed transiently in memory.
No video is recorded, saved to disk, or uploaded to external AI services.
Session readings remain in volatile memory.
Users can stop a session and clear all session data with one click.
SDK telemetry can be disabled through the application's privacy settings.
The application is designed strictly for wellness and self-awareness, not medical diagnosis or treatment.
My goal was simple: make invisible human signals visible through an experience that feels calming, intuitive, and delightful.
Demo
🚀 Published Interactive Preview:
https://vitalflow-1.ai.studio
💻 GitHub Repository:
https://github.com/JNAbhishek27/VitalFlow
The repository includes:
React + TypeScript frontend.
Electron desktop application architecture.
Presage SmartSpectra SDK integration.
HTML5 Canvas generative animation engine.
Signal processing and smoothing services.
Privacy-conscious camera and session management.
Setup instructions and environment configuration.
Runtime Note: In standard web browsers, including the hosted preview, VITALFLOW runs with optional webcam framing and an explicitly labeled DEMO DATA signal pipeline. Actual Presage SmartSpectra C++ signal processing runs inside the Electron desktop runtime using npm run electron:start.
Partner Technologies
Presage SmartSpectra SDK
The primary partner technology behind VITALFLOW is the official @smartspectra/node-sdk.
Integrating this SDK was one of the most interesting parts of the project because it required connecting native signal processing with a modern web-based visual experience.
I implemented Presage's recommended Electron three-process architecture.
- Electron Main Process (electron/main.ts)
Integrated bindSmartSpectraIpc(mainWindow) from @smartspectra/node-sdk/main.
API credentials are resolved securely through main-process environment variables or volatile session memory rather than being exposed in the renderer.
- Electron Preload Bridge (electron/preload.ts)
Integrated @smartspectra/node-sdk/preload with contextIsolation: true and sandbox: true, maintaining a secure communication boundary between Electron processes.
- Renderer SDK Integration (src/services/smartSpectraService.ts)
Initialized SmartSpectraSDK from @smartspectra/node-sdk/renderer, requesting both breathing and cardiovascular metrics.
I also integrated:
streamAvailable for camera preview handling.
processingStatus for tracking SDK lifecycle.
error for processing error handling.
decodeMetrics from @smartspectra/node-sdk/messages for decoding binary Protocol Buffer packets.
- Signal Processing and Visualization
I developed separate signal-processing and Canvas rendering services.
signalProcessor.ts handles signal smoothing.
gardenEngine.ts translates processed measurements into visual animations.
Breathing rate drives organic expansion and contraction, pulse rate influences particle movement and heartbeat ripples, and valid HRV readings modulate visual complexity.
Raw SDK readings remain separate from smoothed animation state, ensuring that the visuals remain stable and responsive.
Signal validation also helps the application identify lighting, framing, distance, and motion issues and guide users through calibration.
What I Learned
Working with the SmartSpectra SDK helped me understand the challenges of:
Integrating native processing into an Electron application.
Handling asynchronous sensor data.
Decoding binary Protocol Buffer messages.
Managing camera permissions and application security.
Separating raw physiological measurements from visual rendering logic.
Designing privacy-conscious, real-time interactive experiences.
Most importantly, I learned that good technology integration is not just about retrieving data. It's about transforming that data into something genuinely useful and meaningful.
Hackathon Experience
I built VITALFLOW as my entry for the Presage SmartSpectra SDK Challenge.
The challenge encouraged me to explore a different direction for contactless human sensing.
Rather than building another health dashboard or displaying numbers on a screen, I wanted to experiment with how physiological signals could influence an interactive digital environment.
One of the most rewarding parts was bringing together several technologies: React, TypeScript, Electron, HTML5 Canvas, and the Presage SmartSpectra SDK.
The project also challenged me to think beyond functionality and consider onboarding, camera consent, privacy, accessibility, and the overall user experience.
My biggest takeaway was that an SDK can be much more than a technical dependency. With the right idea, it can become the foundation of an entirely different user experience.
VITALFLOW represents my exploration of the intersection of human signals, creative coding, and thoughtful software engineering.
Built with curiosity, creativity, and a little bit of nature. 🌱

