Medplum is a healthcare platform that helps you quickly develop high-quality compliant applications.




Medplum is a developer platform that enables flexible and rapid development of healthcare apps.

Medplum Auth

End-to-end identity solution for easy user authentication, sign-in, and permissions using OAuth, OpenID, and SMART-on-FHIR.

Medplum Clinical Data Repository (CDR)

Backend server that hosts your healthcare data in a secure, compliant, and standards-based repository.

Medplum API

FHIR-based API for sending, receiving, and manipulating data.

Medplum SDK

Client libraries that simplify the process of interacting with the Medplum API.

Medplum App

Web application where you can view your data, perform basic editing tasks, and manage basic workflows.

Medplum Bots

Write and run application logic server-side without needing to set up your own server.

UI Component Library

React components designed to help you quickly develop custom healthcare applications.


  • Contributing
    • Ground Rules
    • Codebase
      • Technologies
      • Folder Structure
    • First time setup


We heartily welcome any and all contributions that match our engineering standards!

This codebase isn't your typical open source project because it's our entire product.

Ground Rules

Contributions and discussion guidelines:

  • By making a contribution, you are deemed to have accepted the Developer Certificate of Origin (DCO).
  • All conversations and communities on Medplum agree to GitHub's Community Guidelines and Acceptable Use Policies. This code of conduct applies to all conversations within our contributor community.

Reporting a bug or discussing a feature idea

If you found a technical bug or have ideas for features to implement, please use the issue tracker to share your ideas.

Fixing a bug or implementing a new feature

If you find a bug and open a pull request that fixes it, we'll review it as soon as possible. To implement a new feature, open an issue first to discuss it and ensure it fits our roadmap and plans for the app.

If you want to contribute but are unsure where to start, check out the "good first issue" label for newcomer-friendly issues.



Our mono repo architecture uses the following technologies:

  • PostgreSQL: Data storage
  • Redis: Background jobs and caching
  • Express: API server
  • TypeScript: Type-safe JavaScript
  • React: Frontend React app

Folder structure

├── packages
│   ├── agent        # On-premise agent
│   ├── app          # Frontend web app
│   ├── bot-layer    # AWS Lambda Layer for Bots
│   ├── cdk          # AWS CDK infra as code
│   ├── cli          # Command line interface
│   ├── core         # Core shared library
│   ├── definitions  # Data definitions
│   ├── docs         # Documentation
│   ├── examples     # Example code used in documentation
│   ├── fhir-router  # FHIR URL router
│   ├── fhirtypes    # FHIR TypeScript definitions
│   ├── generator    # Code generator utilities
│   ├── graphiql     # Preconfigured GraphiQL
│   ├── hl7          # HL7 client and server
│   ├── mock         # Mock FHIR data for testing
│   ├── react        # React component library
│   └── server       # Backend API server
Company Screenshot