Open Source · SMART App Launch 2.2.0

Proxy Smart
Healthcare Auth,
Solved.

A stateless proxy that adds SMART on FHIR authorization to any FHIR server. Pair with BabelFHIR-TS for type-safe, profile-aware TypeScript — and go from zero to production-ready SMART app in minutes.

Scroll
Spec 2.2.0 SMART App Launch
Data Stored Zero Stateless proxy — no PHI
License AGPL-3 Commercial license available
Deploy 1 cmd Docker Compose included
01
Stateless FHIR Proxy
No clinical data touches the proxy. Requests pass through to your FHIR server — smaller attack surface, simpler HIPAA/GDPR compliance.
02
SMART App Launch 2.2.0
Full spec implementation: OAuth 2.0 + PKCE, JWT validation, scope-based access control, refresh token rotation, enterprise SSO.
03
Admin Dashboard
Built-in React UI to manage SMART apps, FHIR server connections, users, and scopes. No manual config editing required.
04
BabelFHIR-TS Integration
Generate type-safe TypeScript from any FHIR Implementation Guide. Profile-aware interfaces, runtime validation, and a type-safe FHIR client.
05
AI Assistant & MCP
Built-in AI assistant with RAG, plus an MCP server generated from the OpenAPI spec for programmatic AI-tool integration.
06
Docker-Ready
One-command dev and prod deployments. Mono-container and multi-container Docker Compose setups included.

Register, manage, and launch SMART on FHIR apps through a single admin interface. Every app gets OAuth 2.0 + PKCE, scope-based access control, and FHIR server routing out of the box.

🏪 Browse the App Store

The hardest part of building a healthcare app isn't the clinical logic — it's the authentication, authorization, and interoperability. We handle that.

Your App
SMART App
Proxy
Proxy Smart
Server
FHIR Server

Keycloak handles OAuth · Your FHIR server keeps all clinical data

Layer Technology
BackendBun, Elysia, TypeScript
FrontendReact 19, Vite, Tailwind CSS
IdentityKeycloak + PostgreSQL
FHIR TypesBabelFHIR-TS, @babelfhir-ts/client-r4
TestingVitest, Bun Test
InfraDocker, AWS CDK

Install any FHIR Implementation Guide as a node module. Get type-safe interfaces, runtime validation, and a generated FHIR client — all from a single command.

// Install US Core profiles into your project
$ npx babelfhir-ts install hl7.fhir.us.core@8.0.0

// Use the generated type-safe FHIR client
import { FhirClient } from "./output/fhir-client";

const client = new FhirClient("https://proxy-smart.example.com/fhir");

// Profile-specific methods — fully typed
const patient = await client.read().usCorePatient().read("123");
const bundle  = await client.read().usCoreCondition().search({ patient: "123" });

// Validate against profile constraints at runtime
const { errors, warnings } = await patient.validate();
01
Clone
git clone https://github.com/max-health-inc/proxy-smart.git
02
Start Services
bun docker:dev
03
Install & Run
bun install && bun run dev
04
Open Admin UI
http://localhost:3000