Forms SDK
Pre-built React component for rendering and submitting Healthie forms directly inside your own application, with automatic prefill from existing user data.
Built by Core Engineering
The problem it solves
Teams building a custom frontend still need to collect the same structured intake and charting data Healthie's native forms capture, but rebuilding form rendering, validation, and submission from scratch duplicates work that already exists in the platform.
What's included
- TypeScript React component library (@healthie/sdk on npm)
- Form component — renders any Custom Module Form template
- Automatic prefill from the current user's existing data
- Document and Folder field support, linking out to the Healthie web app
- Built on top of Apollo Client
How it works
Install @healthie/sdk alongside Apollo Client, @rails/actioncable, and graphql-ruby-client. Wrap your app in HealthieProvider with the authenticated user's ID, then render the Form component with the target form's ID. The component prefills existing data, handles Document/Folder field links, and submits the completed form on the user's behalf.
The Forms SDK is a TypeScript React component library that lets developers render and submit Healthie forms directly inside their own application. It's built for teams collecting intake, charting, or other structured data through a custom frontend rather than Healthie's native UI. The Form component renders a given form template in the context of the current user, automatically prefilling it with the user's existing data where applicable, and submits responses on the user's behalf. Authentication isn't included in the SDK — developers implement their own login flow and pass the resulting user ID and token into the HealthieProvider.
