Embed - Photon

Embed Prescribe and prescribers never leave your product. You place it on your page and give it the records you already have.

Choose how

	React components	iframe	JavaScript client
What it is	`<PhotonOrder />` and friends, rendered in your page	The Prescribe app’s page inside yours	`@photon-rx/core`, the client both are built on
Looks like	Your app: it uses your styles and components	Photon, on a transparent background	Whatever you render
Sign-in	Your Application `client_id`	Your Application `client_id`, in a URL built by `frame()`	Your Application `client_id`, or your own tokens
Events	Callbacks with live objects	`postMessage` with ids	Live objects you subscribe to
Best for	React apps	Other frameworks, or the fastest start	Other frameworks, Node, and building links
Try it	In /integrate	In /integrate	In /integrate

All of them show the same cards and follow the same rules, because the Prescribe app is built from them too. See How Prescribe is built. To start with a complete example, follow Prescribe embed.

The cards

Card	Shows	Use it for
`PhotonOrder`	The patient, a card for each prescription, then the send button	Prescribing. Most integrations need only this card.
`PhotonPatient`	Find or add a patient, and edit their details	Patient intake on its own
`PhotonPrescription`	One prescription: drug, sig, dispense, screening, Sign	A single prescription inside your own flow

Giving it records

Each card takes its records (patient, prescription, order) the same way, and so do frame() for the iframe and url() for deep links. Pass whatever you have:

You pass	Example	Prescribe
An id	`"pat_01M3WQ…"`	Opens that record (get)
Fields, no id	`{ demographic: { name, dateOfBirth, sex } }`	Finds, matches or adds it (sync)
An id with fields	`{ id: "pat_01M3WQ…", demographic: { phone } }`	Updates only those fields (update)

These are the same get, sync and update calls the API uses, with the same field names. An order can also take prescriptions, either drafts by id ({ id: "rx_…" }) or new ones from a template ({ templateId }).

Environments

Embedded Prescribe runs against https://rx.neutron.health in the sandbox and https://rx.new in production, which is in private preview. The React components and the JavaScript client choose one with environment. See Environments.

Make it yours

Styling

Make the React components look like the rest of your app.

Migrate from Elements

Using <photon-prescribe-workflow>? Move to Prescribe.

​Choose how

​The cards

​Giving it records

​Environments

​Make it yours