Quickstart

In a few minutes you’ll render Photon’s order card in your app, prescribe for a test patient, and send it. Everything here runs in Neutron, the sandbox, where nothing reaches a real pharmacy.

Get a sandbox

Sign up for Neutron. Your account is ready right away.In the dashboard, open Settings → Developers. Copy your Application client_id, and add your app’s URL (for example, http://localhost:5173) to its allowed URLs.

Install

npm install @photon-rx/react

⚠️ Not published to npm yet.

Render the order card

Pass a test patient. Photon finds them or adds them.

Prescribe.tsx

import { PhotonOrder, PhotonProvider } from "@photon-rx/react";
import "@photon-rx/react/styles.css";

export function Prescribe() {
  return (
    <PhotonProvider clientId="YOUR_CLIENT_ID" environment="neutron">
      <PhotonOrder
        patient={{
          demographic: {
            name: { first: "Paige", last: "Turner" },
            dateOfBirth: "1990-01-01",
            sex: "FEMALE",
            phone: "+13175550142",
          },
        }}
        onSent={(order) => console.log("Sent", order.id)}
      />
    </PhotonProvider>
  );
}

Prescribe

Click Sign in to Photon and sign in with your Neutron account.
Search for a drug, such as amlodipine, and fill in the sig and quantity. Screening runs as you go.
Click Sign, then Send.

In production, the patient would now get a text with their pharmacy options and prices. In Neutron, the order is created but never sent to a real pharmacy.

Not using React? The iframe does the same with a URL and needs no credentials.

Architecture

Patients, prescriptions and orders, and how Photon decides.

Choose an integration

From one component to backend-drafted and agent-drafted orders.

Authentication

User and machine tokens, and who can sign.

Environments

Neutron for building, Photon for production.

Get started

Integrations

Next

Architecture

Choose an integration

Authentication

Environments

​Next

Architecture

Choose an integration

Authentication

Environments

Next