Release candidates

The React components and the JavaScript client are on npm as release candidates of 2.0.0. They’re the packages the Prescribe app is built on, and you can build with them before the stable release.

Package	What it is	Docs
`@photonhealth/react`	`PhotonProvider` and the `PhotonOrder`, `PhotonPatient` and `PhotonPrescription` cards. The cards render through building blocks you can swap for your own components.	README on npm
`@photonhealth/client`	`photon({ environment, auth })`: patients, prescriptions and orders as live objects, with `get`, `sync` and `update`. It has no dependencies and runs in browsers and Node.	README on npm

Install

Release candidates are published under npm’s rc tag, as 2.0.0-rc.N.

npm install @photonhealth/react@rc

npm install @photonhealth/client@rc

@photonhealth/react includes the matching @photonhealth/client, so you don’t install that separately. Include @rc until 2.0.0 is released. The latest release candidate is 2.0.0-rc.1, for both packages. The next release candidate adds:

Machine credentials for the JavaScript client, so your backend can call it with its own client id and secret. See On your backend.
Sig options: rx.loadSigs() in the client, and suggested sigs in PhotonPrescription. See Sig options.

Start in the sandbox

Use neutron while you build. See Environments.

import { PhotonOrder, PhotonProvider } from "@photonhealth/react";
import "@photonhealth/react/styles.css";

<PhotonProvider clientId="YOUR_CLIENT_ID" environment="neutron">
  <PhotonOrder patient="pat_…" onSent={() => closeDialog()} />
</PhotonProvider>;

import { photon } from "@photonhealth/client";

const ph = photon({ environment: "neutron", auth: { clientId: "YOUR_CLIENT_ID" } });
const patient = await ph.patient.get("pat_…");

The READMEs cover the rest: sign-in, live objects, errors, each card’s props and mapping your own components. These docs cover the same packages in React components, JavaScript client and Styling.

What a release candidate means

Each 2.0.0-rc.N can change before 2.0.0. Pin an exact version, such as 2.0.0-rc.1, to choose when you take changes.
2.0.0 will be published under npm’s latest tag. Then you can drop @rc.
@photonhealth/client/testing, the helpers for your own tests, may change before 2.0.0.

@photonhealth/react 1.x is an earlier, unrelated package with a different API. 2.0.0 isn’t an upgrade from it. If you use 1.x, see the migration guide.

Prescribe

App

Embed

Release candidates

Install

Start in the sandbox

What a release candidate means

​Install

​Start in the sandbox

​What a release candidate means

Install

Start in the sandbox

What a release candidate means