Practitioner Directory

Installation

pnpm dlx shadcn@latest add @cleverui/practitioner-directory

Requires the @cleverui registry in your components.json, a one-off, two-line setup.

Usage

tsx

import { PractitionerDirectory } from '@/components/blocks/practitioner-directory'

Exampletsx

'use client'

import { PractitionerDirectory } from '@/components/blocks/practitioner-directory'

export default function PractitionerDirectoryDemo() {
  return (
    <PractitionerDirectory
      heading="Our practitioners"
      intro="Every doctor here is accepting new patients. Choose someone whose interests match what you need, or book with the first available."
      practitioners={[
        {
          name: 'Dr Amara Chen',
          credentials: ['MBBS', 'FRACGP'],
          role: 'General practitioner',
          interests: ["Women's health", 'Mental health', 'Preventive care'],
          nextAvailable: 'Tomorrow 9:40 am',
          bookHref: '#book-chen',
        },
        {
          name: 'Dr James Okonkwo',
          credentials: ['MBBS', 'FRACGP', 'DCH'],
          role: 'General practitioner',
          interests: ["Children's health", 'Asthma', 'Travel medicine'],
          nextAvailable: 'Thu 11:20 am',
          bookHref: '#book-okonkwo',
        },
        {
          name: 'Dr Priya Nair',
          credentials: ['MBBS', 'MD', 'FRACGP'],
          role: 'General practitioner',
          interests: ['Skin checks', 'Diabetes', 'Aged care'],
          nextAvailable: 'Today 4:15 pm',
          bookHref: '#book-nair',
        },
        {
          name: 'Sam Rivera',
          credentials: ['BPhysio'],
          role: 'Physiotherapist',
          interests: ['Sports injuries', 'Back pain', 'Post-op rehab'],
          nextAvailable: 'Wed 2:00 pm',
          bookHref: '#book-rivera',
        },
      ]}
      bookLabel="Book appointment"
    />
  )
}

API reference

PractitionerDirectory accepts the following props.

Prop	Type	Default	Description
`heading`	`string`	`'Our practitioners'`	–
`intro`	`string`	–	one reassuring plain-language sentence under the heading
`practitioners`*	`Practitioner[]`	–	–
`bookLabel`	`string`	`'Book appointment'`	–
`credentialLegend`	`Record<string, string>`	–	extends the built-in post-nominal legend used for sr-only expansions

…plus everything from React.HTMLAttributes<HTMLElement>: className, event handlers, aria attributes and the rest pass straight through.

Referenced types

Typestsx

export interface Practitioner {
  name: string
  /** post-nominals like MBBS, FRACGP */
  credentials?: string[]
  role: string
  interests?: string[]
  /** preformatted next slot, e.g. 'Tomorrow 9:40 am', never derived from Date */
  nextAvailable?: string
  bookHref?: string
}

Related components

Which Appointment Should I Book?

Consult types compared in plain language, length and fee in quiet figures, an honest best-for line each, and a calm not-sure fallback. A React and Tailwind decision aid for clinics.

How Booking Works

How booking works in three or four numbered steps, plain reassuring language, near-still motion, and practical notes like bring your Medicare card. Calm from first click to consult.

Who You'll See

A who-you'll-see panel pairing practitioner roles, GP, practice nurse, physio, with plain one-line explanations of what each actually does, demystifying the visit before it happens.

Clinic Locations Strip

Multi-location clinic strip, suburb name, plain street address, a practical parking note, and an hours snippet in quiet mono per location, closed by one gentle closest-to-you hint.

Services & Fees

Clinic services set with menu discipline, plain-language descriptions, consult length and fee in tabular figures, and quiet notes like GP referral required. Zero jargon, high clarity.

Before Your First Visit

First-visit checklist for new patients, what to bring and what to do beforehand in two calm columns, with an arrive-early aside. Plain-language React and Tailwind onboarding for clinics.

Frequently asked questions

How do I install the Practitioner Directory component?

Register the @cleverui registry in your components.json ("@cleverui": "https://cleverops.com.au/r/{name}.json"), then run `npx shadcn@latest add @cleverui/practitioner-directory`. The shadcn CLI copies the source into your project, you own the code from that point. You can also copy the source directly from this page.

What dependencies does Practitioner Directory require?

Practitioner Directory uses motion and lucide-react on top of React and Tailwind CSS. You don't need to install them manually, the shadcn CLI resolves and installs npm dependencies automatically when you add the component.

Can I theme Practitioner Directory to match my brand?

Yes. The component is styled entirely with Tailwind utilities over standard design tokens (primary, background, muted, border), so it inherits your existing shadcn/ui theme automatically. Change your CSS variables and the component follows, no source edits needed for palette, radius, or fonts.

Preview & code