Smart Forms

An open source FHIR powered forms app built in React

Powered by SMART on FHIR and Structured Data Capture, Smart Forms allow you to easily integrate forms into your existing healthcare system.

Show me the app ➡️

Check out the documentation 📚

---

Smart Forms is a Typescript-based React forms web application currently ongoing development by CSIRO's Australian e-Health Research Centre as part of the Primary Care Data Quality project funded by the Australian Government Department of Health.

The web app is intended to demonstrate the use of HL7 FHIR specifications, such as the Questionnaire and QuestionnaireResponse resources, the Structured Data Capture (SDC) implementation guide, and most notably it leverages SMART on FHIR capabilities that allows the app to be launched by a primary care Clinical Management System (CMS) and capture standardised health check information for healthcare clients.

This project was bootstrapped with Vite.

If you are interested in using the form renderer in your React app, a standalone package is published on NPM as @aehrc/smart-forms-renderer.

Functionalities

Smart Forms app

| Functionality | Description | Resources | Showcase 🖼️ (Right click -> Open link in new tab) | |----------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------| | Form population | Populate FHIR clinical data into forms, removing the need to re-enter generic information every time a new form is created, allows reusability of data. | SDC Populate | Population of patient details
Population of patient medical history | | Conditional rendering | Render form items conditionally based on user decisions or pre-determined data. | Questionnaire EnableWhen | Form tabs and items presented differently for patients of different age groups | | Built-in calculations | Perform calculations based on form item answers to produce a calculated result, e.g. BMI, CVD Risk Score. | SDC Calculations | Calculated BMI based on height and weight values | | ValueSet expansion | Perform expansion of ValueSet resources via the Ontoserver $expand operation API within autocomplete, dropdown, radio button and checkbox fields. | ValueSet expand
Ontoserver ValueSet API | Ontoserver ValueSet Expansion in an Autocomplete component | | QuestionnaireResponse write-back | A form can either be saved as a draft or as final, which will compile the form answers into a QuestionnaireResponse resource and store it on the CMS's FHIR server via REST API. | FHIR RESTful API | List of responses in context of a patient | | Form preview | Generate a human-readable preview of the QuestionnaireResponse which can be viewed while filling in the form or after the form is saved. |

| Human-readable form preview | | | Generic form implementation | The app tries its best to render any Questionnaire as long as it conforms to the FHIR specification! | Questionnaire
SDC | Rendering of an Australian absolute CVD Risk calculator questionnaire |

NOTE: The patients featured in the screenshots are synthetic and do not represent any real people.

Forms Server API

| Functionality | Description | Resources | |------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------| | Modular questionnaires | Allows a questionnaire to be composed of sub-questionnaires which allows for reusability of questionnaire components i.e. a single tab within a form with multiple tabs. Subquestionnaires can be "assembled" to form a complete questionnaire with the $assemble operation. | SDC Modular questionnaires |

Contents

1. The Smart Forms web app. Try it out here: smartforms.csiro.au
2. Implemented operations from the Structured Data Capture (SDC) specification:
   • $populate
   • $assemble
3. A standalone component of the questionnaire renderer published on NPM as @aehrc/smart-forms-renderer.

Conformance

Here's the Structured Data Capture (SDC) conformance sheet for the Smart Forms app: https://github.com/aehrc/smart-forms/blob/main/Conformance.md

Usage

Running on a SMART CMS client (the preferred way)

1. Open https://launch.smarthealthit.org/ (or your own SMART on FHIR enabled CMS) in a browser.
2. Set the App Launch URL at the bottom of the page as https://smartforms.csiro.au/launch and launch app.

Running in an unlaunched state

This method of running the app does not allow you to save responses as it is not connected to a CMS client.

1. Open https://smartforms.csiro.au in a browser.
2. You would have access to some pre-defined local questionnaires

NOTE: The app will not be able to view or save responses as it is not connected to a CMS client.

Local Development

Refer to LOCAL_DEVELOPMENT.md for instructions on local development and running.

Feature requests and bug reports

If you find any bugs, feel free to create an issue and we will try our best to get it fixed.

If you have any feature suggestions, feel free to also create an issue. However, we will try to prioritise more general rather than use-case specific features due to resourcing constraints.

We are also accepting contributions to make the product better! Please read CONTRIBUTING or discuss on zulip.

Discussions

We encourage having discussions on chat.fhir.org.

Smart Forms-related discussions can be raised in the Smart Forms's stream: https://chat.fhir.org/#narrow/stream/425534-smart-forms.

Any questionnnaire/SDC-related discussion can be raised in the questionnaire stream: https://chat.fhir.org/#narrow/stream/179255-questionnaire.

Licensing and attribution

Smart Forms is copyright © 2022-2024, Commonwealth Scientific and Industrial Research Organisation (CSIRO) ABN 41 687 119 230. Licensed under the Apache License, version 2.0.

This means that you are free to use, modify and redistribute the software as you wish, even for commercial purposes.

Smart Forms is experimental software at the moment, use it at your own risk!