The patient-facing surface of the HealthClaw platform.
v1.2.0 — now reads wearable signals (Garmin, Oura, Polar, Suunto, Whoop, Fitbit, Strava) sourced from HealthClaw Guardrails v1.3.0. Still routes through the Compiled Truth engine from v1.1.0.
When HealthClaw's OPEN_WEARABLES_URL is configured, wearable data arrives as FHIR Observations with LOINC codes and device Provenance. The existing healthy-habits, diet-exercise, and medication-refills skills read them through the same fhir_search they already use — no new tools in this repo. Each skill's SKILL.md now lists the LOINC codes worth knowing.
SmartHealthConnect does not own data, policy, or the canonical record.
- Engine — HealthClaw Guardrails owns the FHIR store, PHI redaction, audit trail, step-up auth, tenant isolation, and the Compiled Truth primitive (current state + Provenance timeline for every resource).
- Surface — this repo owns the 6 patient skills (
healthy-habits,care-completion,medication-refills,diet-exercise,kids-health,research-monitor), the React client, and the conversational patterns.
Every skill that makes a resource-specific claim to the patient must call the get_compiled_truth MCP tool first — it proxies to HealthClaw's fhir_compiled_truth and returns the current redacted resource + an append-only evidence timeline. See each skill's SKILL.md for the rule. Configure with HEALTHCLAW_MCP_URL=http://localhost:3001/mcp/rpc (or your deployed URL).
.health-context.yaml at the repo root declares role: surface and names HealthClaw as the engine. Mirrored in the engine repo.
SmartHealthConnect enables patients to connect their healthcare providers and view their complete health records in one secure platform. The application uses SMART on FHIR standards for interoperability and delegates guardrail enforcement to HealthClaw.
- SMART on FHIR Integration - Connect to Epic, Cerner, and other FHIR-enabled healthcare systems
- Unified Health Dashboard - View conditions, medications, lab results, and vital signs in one place
- AI Health Insights - Get personalized health recommendations and care gap identification
- Trend Visualization - Track vital signs over time with interactive charts
- White-Label Ready - Enterprise solution with customizable branding
- Frontend: React 18, TypeScript, Vite, Tailwind CSS, shadcn/ui
- Backend: Express.js, TypeScript
- Database: PostgreSQL with Drizzle ORM
- Authentication: Passport.js with session management
- FHIR: SMART on FHIR R4 protocol
- Node.js 18+
- PostgreSQL database
# Install dependencies
npm install
# Set up environment variables
cp .env.example .env
# Edit .env with your DATABASE_URL and other config
# Push database schema
npm run db:push
# Start development server
npm run devDATABASE_URL- PostgreSQL connection stringOPENAI_API_KEY- OpenAI API key for AI features (optional)
# Run development server
npm run dev
# Type check
npm run check
# Build for production
npm run build
# Start production server
npm startThe application can be deployed to any Node.js hosting platform:
# Build production assets
npm run build
# Set environment variables
export DATABASE_URL="postgresql://..."
export OPENAI_API_KEY="sk-..." # Optional
export NODE_ENV="production"
# Start server
npm startThe server runs on port 5000 by default and serves both the API and static frontend assets.
├── client/ # React frontend
│ └── src/
│ ├── components/ # UI components by feature
│ ├── pages/ # Route components
│ ├── hooks/ # Custom React hooks
│ └── lib/ # Utilities and config
├── server/ # Express backend
│ ├── routes.ts # API routes
│ ├── fhir-client.ts # SMART on FHIR integration
│ └── ai-service.ts # OpenAI integration
├── shared/ # Shared types and schemas
└── migrations/ # Database migrations
We're actively looking for:
- Beta Testers - Help us refine the user experience
- Collaborators - Developers, designers, and healthcare professionals
- Health System Partners - Enterprise deployments and integrations
Proprietary - All rights reserved.
For partnership inquiries or to join the beta program, please reach out through the platform.