@orion-ehr/cli

CLI for building, validating, and publishing apps to the Orion EMR marketplace.

Quick install

npm install -g @orion-ehr/cli
orion --version

Quick start

orion init my-app --client-id <your-oauth-client-id>
cd my-app
npm install
orion config host        # set your home tenant
orion login              # authorize the CLI
orion dev                # local Vite dev server + tunnel
orion validate           # static checks before publishing
orion publish            # ship to the marketplace

Documentation

Full documentation lives at orion-software-corp.github.io/orion-ehr-cli.

Guide

| | | |---|---| | What is an Orion app, and how do the pieces fit together? | Concepts | | Install through first publish | Getting Started | | End-to-end "build a Hello-Patient widget" walkthrough | Tutorial | | orion.config.ts Host vs Sandbox | Host vs Sandbox |

Commands

| | | |---|---| | init, config | Setup | | login, logout, auth status, auth whoami | Authentication | | dev, build, validate, doctor, generate | Development | | publish, apps, versions | Publishing | | upgrade, open, sandbox | Maintenance |

Recipes

| | | |---|---| | Publish from CI without an interactive terminal | Publish from CI | | Add a page that fetches FHIR data | Add a page with FHIR data | | Iterate without consuming version slots | Test without publishing |

Reference

| | | |---|---| | orion.config.ts and orion-app.json shapes | Configuration files | | Per-extension manifest fields | Manifest schema | | ORION_API_URL, ORION_NO_UPDATE_NOTIFIER, etc. | Environment variables |

Help

| | | |---|---| | Common errors with cause + fix | Troubleshooting | | Project-specific terminology | Glossary |

Contributing

• Issues + feature requests: GitHub Issues
• Docs are markdown under docs/. PRs welcome — there's an "Edit this page on GitHub" link on every doc page.
• Local docs preview: npm run docs:dev.

Requirements

• Node.js 20+
• An Orion EMR developer account with a registered OAuth client