A collection of projects and libraries to help implement FHIR-based products and solutions.

Documentation: https://bonfhir.dev

• node/npm
• Docker

$ npm create bonfhir

The current starter templates are the following:

• playground: A simple playground to get started playing with bonFHIR core.
• vite: A Vite SPA project with BonFHIR UI and React-Router.
• lambda: An AWS Lambda serverless application connected to a FHIR Server.
• next: A Next.js app with BonFHIR UI & Subscription API, with NextAuth integration.
• monorepo: A Monorepo with a Web app (SPA), an AWS Lambda API, and supporting packages. This for more advanced projects.

Once you have an application up and running the next step is connecting to some data. Provided is a docker image you can run locally with some test data.

From within your new bonFHIR application
Start the FHIR backend
$ npm run fhir:start-server

Ensure the backend is running at localhost:8100

Authenticate with credentials [email protected] / medplum_admin / Use "Default Project"

Load some test data
npm run fhir:add-sample-data

Note: The following error occurs if using a version of Node prior to 18

ReferenceError: fetch is not defined

Using the provided bonFHIR utilities and components start building! Here is a simple React example to get you started

import { useFhirSearch } from "@bonfhir/query/r4b";
import { FhirTable, FhirValue } from "@bonfhir/react/r4b";
import { Paper } from "@mantine/core";

export default function Home() {
  const patientQuery = useFhirSearch("Patient");

  return (
    <Paper>
      <FhirTable
        {...patientQuery}
        columns={[
          {
            key: "name",
            title: "Name",
            render(patient) {
              return <FhirValue type="HumanName" value={patient.name} />;
            },
          },
        ]}
      />
    </Paper>
  );
}