A working web app that demonstrates the four steps of the Validic Inform API: provision a user, connect a device, retrieve health data, and stream real-time events — all with your own credentials.
Clone it, run it, then use it as the starting point for whatever you want to build.
- Node.js 22 or higher
- A Validic Inform account — free sandbox at api.dashboard.validic.com
1. Clone this repo
git clone https://github.com/validic/inform-quickstart.git
cd inform-quickstart
npm install2. Add your credentials
cp .env.example .envOpen .env and fill in two values:
ORG_ID=your_org_id_here
ORG_TOKEN=your_org_token_here
Both are available in your Validic dashboard.
3. Start the app
npm startOn startup, the app finds or creates a Validic user and stream for your org automatically. Open http://localhost:3000.
The app walks through the four-step Inform integration pattern:
| Section | What it demonstrates |
|---|---|
| Connect Your Device | GET /users/:id/apps — list connected sources; redirect to Marketplace |
| Your Data | GET /users/:id/:type — pull 30 days of normalized health data |
| Live Stream | SSE via /streams/:id/connect — real-time data as it arrives |
| Replay last 30 days | SSE via /replay — historical events through the same stream interface |
All Validic API calls happen in server.js. The frontend only talks to localhost.
- Add a database — swap
.envstate for SQLite or Postgres to support multiple users - Add a frontend framework — the
public/folder is plain HTML/JS; drop in React or Vue - Add alert rules — use the Rules API to trigger notifications when thresholds are crossed
- Full docs: developer.validic.com
- Agent/LLM reference: developer.validic.com/agents.txt
