跳到正文
DEV Community· Shreyash Baba Payasam·· 9 小時前AI 評分40

Aurae:以同意為先,平靜查看心跳與呼吸

Aurae – a calm, consent-first look at your heart and breath

AI 導讀

Aurae 是一款使用 Presage SmartSpectra SDK 的桌面應用程式,透過網絡攝影機即時測量脈搏、呼吸率及心率變異度,無須穿戴裝置,也不會儲存資料。應用程式須先取得用戶同意才會啟動鏡頭,並以「等待讀數」、「穩定中」及「訊號穩定」顯示讀數狀態;它明確聲明並非醫療工具。

正文

This is a submission for the Presage SmartSpectra SDK Challenge

What I Built

Aurae is a desktop app that gives you a quiet moment to check in with your body. Sit in front of your webcam and Aurae shows your pulse, breathing rate and heart-rate
variability
, live, measured by the Presage SmartSpectra SDK from tiny changes in your face.
No wearable, and nothing is saved.

Most health apps look like a hospital monitor: red numbers, alarms, charts that make you more anxious, not less. I wanted the opposite: a warm, slow, almost paper-like screen that treats
your readings as something to reflect on, not something to worry about. Aurae is explicitly not a medical tool. It says so on every screen.

Aurae's consent screen

What it does:

  • Asks before anything happens. The camera stays off until you've read what Aurae reads, sends and keeps, and ticked a consent box. "Not now" really means not now.
  • Shows three live readings, each with an honest status: Waiting for a reading, Settling or Steady signal.
  • Guides you with the SDK's own positioning hints, such as holding still, moving closer or finding better light.
  • Keeps the camera view soft: mirrored, greyscale and faded at the edges, so you're not staring at a harsh video of yourself.
  • Stops cleanly. One button releases the camera, clears every reading and takes you back to the start.

Demo

The video shows the consent screen, turning on the camera, the live readings settling into a steady signal, and stopping the camera.

Code

Aurae: Calm Camera-Based Vitals

Aurae

A calm, camera-based view of your heart and breath. Sit in front of your camera and Aurae shows your pulse, breathing rate and heart-rate variability, live, measured by the Presage SmartSpectra SDK from small changes in your face No wearable, and nothing is saved.

Aurae is a desktop app (Electron, Vue 3, TypeScript) built for the Presage SmartSpectra SDK Challenge.

Aurae's consent screen: a dotted "Heart & Breath" panel, three reading cards waiting for the camera, and the camera consent panel

Readings are for reflection and play. They are not medical advice and cannot diagnose anything.

What it does

  • Asks first. The camera stays off until you read what Aurae does and tick a consent box "Not now" keeps it off.
  • Live readings. Pulse (bpm), breathing rate (breaths per minute) and heart-rate variability (RMSSD, in ms) update in real time. Each card says whether its reading is Waiting, Settling or a Steady signal, based on the SDK's own stability flag.
  • Guides you. The SDK's positioning hints (such…

Setup takes a few minutes: clone, npm install, put your SmartSpectra API key in .env.local and run npm run dev. Full instructions are in the README.

I built Aurae with Claude Code as a pair programmer: design prototypes, accessibility and UX audits with Playwright, the SDK integration, and tracking down the quit crash and the packaging
bug.

How It Responds to Human Signals

Aurae uses three live Presage signals: pulse rate, breathing rate and heart-rate variability (RMSSD). As the SDK streams new values, the experience responds in real time:

  • The readings update live on three cards: pulse in bpm, breathing in breaths per minute, HRV in milliseconds.
  • Each card shows how much to trust its number. The SDK marks every reading as stable or not, and Aurae turns that into a plain status chip: Waiting for a reading, then Settling, then Steady signal. You know when to just breathe and wait.
  • The screen coaches you. The SDK's validation hints (face not centred, too dark, too much movement and so on) appear in plain words under your camera view, and screen readers announce them.
  • Problems are explained, not hidden. Camera errors and SDK error codes become specific messages: camera permission refused, camera in use by another app, API key problem, no connection.

How I integrated the SmartSpectra SDK

Aurae is built with Electron, Vue 3 and TypeScript, using @smartspectra/node-sdk. The SDK splits into two halves, and so does the app:

  • Renderer (the UI). A Vue composable, useVitals.ts, creates SmartSpectraSDK and asks for only the three metrics Aurae shows (PULSE_RATE, BREATHING_RATE, HRV), with telemetry turned off. It listens for metrics events, decodes each protobuf payload with decodeMetrics, and keeps the latest value plus its stable flag in reactive state. It also listens for validationStatus hints and error events.
  • Main process (the native engine). bindSmartSpectraIpc(window) connects the window to the native SmartSpectra engine over a message port. The SDK's preload bridge sets that port up.

Requesting only three metrics mattered. My first version asked for the SDK's full cardio and breathing groups (11 metric types). That also pulled in a model Aurae never uses, fetched remotely at start-up, plus metrics I'd have had to disclose but didn't show.

Two things I had to solve along the way:

  1. A crash on quit. If you quit while the SDK was (or had been) running, the native engine finished tearing down on a worker thread after Node had started shutting down, and the app aborted. Aurae now waits for every SDK teardown to finish before it exits. I verified this with Playwright tests that quit in different ways.
  2. Packaging. In a packaged Electron app, the SDK's native library ended up inside the app.asar archive, where macOS can't load it, so the app couldn't start. Following the SDK README's packaging guidance, the native folder now ships next to the archive, and the app points the SDK at it with the documented SMARTSPECTRA_CAPI_PATH setting. As a bonus, each platform's build only includes its own native libraries, which took the macOS app from 625 MB to 417 MB.

Prize Categories

Best Thoughtful Real-World Use

The need: Checking in with your
body during a stressful day usually means a smartwatch, or an app that makes your heart rate feel like a warning sign. Aurae needs nothing but the webcam you already have. It turns "how am I doing?" into a calm, thirty-second pause.

Who it's for: people who want a moment of awareness, not a diagnosis. For example, someone who wants to see their breathing slow down after a hard meeting, or anyone curious about what their camera can sense, who'd rather not wear a device.

How I designed it to be usable for them:

  • Calm by default. Warm, paper-like colours; slow, gentle motion; no red numbers, alarms or scores. Readings come with "Settling" and "Steady signal", never "good" or "bad".
  • Plain language everywhere. The consent screen explains in four short sections what Aurae reads, what leaves the device, what it keeps and how to stop. Errors say what happened and what to do.
  • Accessible. Hints and errors are announced to screen readers. Animations respect the system's "reduce motion" setting. Layouts reserve space so nothing jumps when messages appear. The design adapts from a phone-sized window up to a wide desktop.
  • In control. One clear button turns the camera off at any time. Nothing carries over between sessions.

Consent and Data Handling

  • Camera consent. The camera never turns on automatically. Aurae opens on a consent screen that explains, in plain language, what it reads (pulse, breathing rate, heart-rate variability), what leaves the device, and what it keeps. You must tick a consent box and press Turn on camera. "Not now" keeps the camera off. macOS then asks for its own camera permission, and the app only grants camera access to its own page, nothing else.
  • What is shared. Data from the camera is sent to Presage's SmartSpectra service, which calculates the readings. Aurae sends nothing else.
  • SDK telemetry. Off. Aurae sets enableTelemetry: false, so the SDK doesn't send Presage usage statistics.
  • Storage and retention. None. Readings exist only on screen while the camera is on and are cleared as soon as you stop it. Aurae saves no readings, video or images to disk, and has no history, accounts or analytics.
  • Deletion. There is nothing stored to delete. Stopping the camera or closing the app clears everything.
  • AI services. None. Aurae doesn't use the SDK's optional AI features or any other AI service.
  • No medical claims. Every screen says: "Readings are for reflection and play. They are not medical advice and cannot diagnose anything." Aurae makes no diagnosis or treatment claims and isn't for medical decisions.

來源:DEV Community · dev.to