PrescriptionWidget

A quick-entry widget for creating medication records. For full prescription creation with dosage, priority, and category, use PrescriptionForm.

Usage

import { PrescriptionWidget } from '@clinikapi/react';

<PrescriptionWidget
  proxyUrl="/api/clinik"
  patientId="pt_abc123"
  theme="light"
/>

Props

Prop	Type	Required	Description
`proxyUrl`	`string`	Yes	Backend proxy URL
`patientId`	`string`	Yes	Patient ID
`prescriberId`	`string`	No	Prescribing practitioner ID
`theme`	`'light' \| 'dark'`	No	Color theme

Features

Quick medication name entry
Creates a prescription (MedicationRequest) linked to the patient
Supports free-text medication names and RxNorm codes
Dosage, refills and priority available via PrescriptionForm or the SDK

PrescriptionWidget vs PrescriptionForm

Widget	Use Case
PrescriptionWidget	Quick one-field prescribing — medication name only
PrescriptionForm	Full prescription with dosage, priority, category, refills

Both write a MedicationRequest. To add to the medication catalog instead, call medications.create from your own backend — no widget does that.

Proxy Action

The widget sends prescriptions.create with:

{
  "action": "prescriptions.create",
  "data": {
    "patientId": "pt_abc123",
    "prescriberId": "prac_def456",
    "medication": "Amoxicillin 500mg",
    "status": "active",
    "intent": "order"
  }
}

When prescriberId isn’t supplied the widget sends "unknown", so allowlist the action and fill in the real prescriber from your session in the proxy.