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 rendering engine in your projects, a standalone package is published on NPM as @aehrc/smart-forms-renderer.

Smart Forms app

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

Forms Server API

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-rendering engine published on NPM as @aehrc/smart-forms-renderer.

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

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.

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.

The default configuration is set to:

# Ontoserver endpoint for $expand operations
# To run your own Ontoserver instance, contact us at https://ontoserver.csiro.au/site/contact-us/ontoserver-contact-form/
VITE_ONTOSERVER_URL=https://r4.ontoserver.csiro.au/fhir

# Questionnaire-hosting FHIR server
VITE_FORMS_SERVER_URL=https://smartforms.csiro.au/api/fhir

# Debug mode - set to true in dev mode
VITE_SHOW_DEBUG_MODE=false

# SMART App Launch scopes and launch contexts
# It will be necessary to tweak these variables if you are connecting the app to your own SMART on FHIR enabled CMS/EHR
VITE_LAUNCH_SCOPE=launch/patient patient/*.read offline_access openid fhirUser
VITE_LAUNCH_CLIENT_ID=smart-forms

In development mode, create a .env.local file in the apps/smart-forms-app directory and tweak the environment variables as needed.

1. Clone this Git source repository onto your local machine from https://github.com/aehrc/smart-forms.

2. Install dependencies.

npm install

3. Change directory into the directory containing the Smart Forms app.

cd apps/smart-forms-app

4. Start the local server.

npm start

5. Follow the instructions here but replace https://smartforms.csiro.au/launch with http://localhost:5173/launch

Report it to us! Create an issue within the repo and we will try our best to get it fixed as soon as possible. If you do have any feedback on the app's behaviour/user experience or anything else, feel free to also create an issue!

Smart Forms is copyright © 2022-2023, 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!