Skip to content

Ecosystem

fhir-capability-analyzer is one of three complementary FHIR developer tools built to cover the most common pain points in FHIR integration work.

The fhir-toolkit

ToolPurposenpm
fhir-capability-analyzerFetch, analyze, and compare FHIR server CapabilityStatementsnpm
fhir-resource-diffValidate, diff, and compare individual FHIR JSON resourcesnpm
fhir-test-dataGenerate valid FHIR test data with country-aware identifiersnpm

Together they cover three of the most common tasks in FHIR integration work:

  • Understanding what a server supports (fhir-capability-analyzer)
  • Working with individual resources during development (fhir-resource-diff)
  • Generating realistic test data (fhir-test-data)

These tools solve different but complementary problems:

ToolWhen to use instead
HL7 FHIR ValidatorFull profile conformance validation (requires Java)
@medplum/coreFHIRPath evaluation, full FHIR client
fhirXML ↔ JSON conversion

Common workflow

bash
# 1. Understand what the server supports
fhir-capability-analyzer analyze https://fhir.server.example.com

# 2. Generate test data matching the server's profiles
fhir-test-data generate patient --locale us --seed 42

# 3. Validate and diff resources during development
fhir-resource-diff validate patient.json --fhir-version R4
fhir-resource-diff compare expected.json actual.json

# 4. Assert server capabilities in CI
fhir-capability-analyzer compare ./fixtures/baseline.json https://staging.example.com --exit-on-diff

Released under the MIT License.