Skip to content

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

License

Notifications You must be signed in to change notification settings

alexwillingham/medplum

 
 

Repository files navigation

Medplum is a developer platform that enables flexible and rapid development of healthcare apps. In consists of 3 main components

  • Medplum Clinical Data Repository (CDR) - This is the the backend server that hosts your healthcare data in a secure, compliant, and standards based repository. The Medplum CDR also exposes a FHIR-based API for sending, receiving, and manipulating data
  • Medplum App - This is a web application where can you can view your data, perform basic editing tasks. You can also use the Medplum App to manage basic workflows.
  • UI Component Library - Medplum ships with a system of React components designed to help you quickly develop custom healthcare applications

Docs

Contributing

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

That being said, this codebase isn't your typical open source project because it's not a library or package with a limited scope -- it's our entire product.

Ground Rules

Contributions and discussion guidelines

By making a contribution to this project, 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 also applies to all conversations that happen within our contributor community here on GitHub. We expect discussions in issues and pull requests to stay positive, productive, and respectful. Remember: there are real people on the other side of that screen!

Reporting a bug or discussing a feature idea

If you found a technical bug on Medplum or have ideas for features we should implement, the issue tracker is the best place to share your ideas. Make sure to follow the issue template and you should be golden! (click here to open a new issue)

Fixing a bug or implementing a new feature

If you find a bug on Medplum and open a PR that fixes it we'll review it as soon as possible to ensure it matches our engineering standards.

If you want to implement a new feature, open an issue first to discuss what it'd look like and to ensure it fits in our roadmap and plans for the app.

If you want to contribute but are unsure to start, we have a "good first issue" label which is applied to newcomer-friendly issues. Take a look at the full list of good first issues and pick something you like!

Want to fix a bug or implement an agreed-upon feature? Great, jump to the local setup instructions!

Codebase

Technologies

With the ground rules out of the way, let's talk about the coarse architecture of this mono repo:

  • Full-stack TypeScript: We use Node.js to power our servers, and React to power our frontend apps. Almost all of the code you'll touch in this codebase will be TypeScript.

Here is a list of all the big technologies we use:

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

Folder structure

medplum/
├── packages
│   ├── app          # Frontend web app
│   ├── bot-layer    # AWS Lambda Layer for Bots
│   ├── cli          # Command line interface
│   ├── core         # Core shared library
│   ├── definitions  # Data definitions
│   ├── docs         # Documentation
│   ├── fhirtypes    # FHIR TypeScript definitions
│   ├── generator    # Code generator utilities
│   ├── graphiql     # Preconfigured GraphiQL
│   ├── infra        # Infra as code
│   ├── mock         # Mock FHIR data for testing
│   ├── react        # React component library
│   └── server       # Backend API server
└── scripts          # Helper bash scripts

First time setup

See developer setup documentation: https://docs.medplum.com/contributing

License

Apache 2.0

Copyright © Medplum 2022

FHIR ® is a registered trademark of HL7.

SNOMED ® is a registered trademark of the International Health Terminology Standards Development Organisation.

DICOM ® is the registered trademark of the National Electrical Manufacturers Association (NEMA).

About

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

Resources

License

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 97.2%
  • CSS 1.6%
  • Other 1.2%