Getting Started

SDKs

API Reference

Resources

GitHub Boilerplates

Don't start from scratch. Our engineering team maintains production-ready open-source boilerplates. Clone them, add your keys, and have a working healthcare integration in minutes.

Next.js Health Dashboard

A complete React frontend demonstrating how to render Nostavia's lab interpretations and wearable telemetry into beautiful Recharts graphs. Includes NextAuth for JWT authentication and TailwindCSS for styling.

Repository Structure

nostavia-nextjs-dashboard/
├── .env.example
├── package.json
├── src/
│   ├── app/
│   │   ├── api/
│   │   │   ├── auth/           # NextAuth route handlers
│   │   │   └── webhooks/       # HMAC webhook listeners
│   │   ├── dashboard/          # Protected dashboard routes
│   │   └── layout.tsx
│   ├── components/
│   │   ├── BiomarkerChart.tsx  # Recharts implementation
│   │   └── SOMAChatbox.tsx     # AI Concierge UI
│   └── lib/
│       └── nostaviaClient.ts   # SDK Initialization
└── tailwind.config.js

Local Setup

git clone https://github.com/nostavia/nextjs-dashboard.git
cd nextjs-dashboard
cp .env.example .env.local
npm install
npm run dev

.env.local Configuration

# Nostavia Sandbox Keys
NOSTAVIA_SECRET_KEY=nostavia_sk_test_51Mz...
NOSTAVIA_WEBHOOK_SECRET=whsec_9b83b...

# NextAuth Config
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=generate_a_random_jwt_secret_here

Python LIS Integration Node

A lightweight FastAPI server designed to sit behind an enterprise firewall. It securely accepts incoming HL7/FHIR payloads from an on-premise LIS (Laboratory Information System), strips all PII (names, SSNs), and pipes the completely anonymous data into the Nostavia Intelligence cloud.

Repository Structure

nostavia-fastapi-lis/
├── .env
├── requirements.txt
├── Dockerfile
├── docker-compose.yml
└── app/
    ├── main.py                 # FastAPI application
    ├── anonymizer.py           # Regex-based PII stripper
    ├── hl7_parser.py           # HL7 to JSON converter
    └── nostavia_router.py      # HTTPX client for SOMA engine

Local Setup via Docker

git clone https://github.com/nostavia/fastapi-lis.git
cd fastapi-lis
cp .env.example .env

# Build and run the isolated container
docker-compose up --build

The server will expose a local endpoint at http://localhost:8000/hl7-ingest ready to accept local hospital network traffic.