@swasthya-bridge/react

Headless React components and TypeScript primitives for ABHA/ABDM frontend flows.

Part of the SwasthyaBridge monorepo.

Installation

pnpm add @swasthya-bridge/react

Peer dependencies: React 18 or 19.

Usage

import {
  AbhaProvider,
  useAbhaEnrollment,
  AbhaOtpInput,
  AbhaErrorMessage,
} from "@swasthya-bridge/react";

function App() {
  return (
    <AbhaProvider proxyBaseUrl="/api/abdm" environment="sandbox">
      <EnrollmentFlow />
    </AbhaProvider>
  );
}

See the root README for the full Quick Start guide.

What Is Included

• Headless components — unstyled, composable, accessible
• React hooks — enrollment, OTP, address, login flows
• TypeScript types — all ABDM V3 request/response shapes
• Zod schemas — runtime validation for API responses
• Utilities — error normalisation, environment URL resolution, mock fixtures

What Is NOT Included

• Any CSS or styling
• Any direct ABDM API calls
• Any backend or proxy code
• Any Aadhaar encryption logic

Security Boundary

This package never contacts ABDM APIs directly. Configure your backend proxy URL:

<AbhaProvider proxyBaseUrl="/api/abdm" environment="production">

Your backend is responsible for: ABDM authentication, Aadhaar RSA encryption, session token management.

Compliance

See COMPLIANCE_DISCLAIMER.md.

License

MIT