Getting started

Use the builder. Pick identity providers, a form library, and a validation library. Preview the form, open Get Code, and run the command it gives you.

That command installs the composed form, the providers you picked, and any add-ons.

Use the CLI

If you already know what you want, register the registry, then list or search items:

npx shadcn@latest registry add @oidc=https://ui.shadcn.com/oidc/r/{name}.json

npx shadcn@latest list @oidc

npx shadcn@latest search @oidc -q github

Then add the items you chose. core is the default GitHub + Vercel starter form. Prefer the builder for other combinations.

npx shadcn@latest add @oidc/core @oidc/verify @oidc/page-actions

Provider item names encode the form library and validation. npx shadcn@latest list @oidc is the source of truth. See Providers.

Render the form

import { OidcPolicyForm } from "@/components/oidc/policy-form"

export default function Page() {
  return <OidcPolicyForm />
}

The file is yours. Add providers, swap the picker, and wire onSubmit to your storage.

Save and verify

Submit emits an OidcPolicy. Validate it with validateOidcPolicy on the server before you persist it, then check inbound tokens with verifyOidcToken. With the Page + actions add-on, the generated savePolicy action already runs that validation.

See Save and verify for the policy shape, the onSubmit wiring, and the verifier error codes.

Next steps

• Builder for what each control does
• Save and verify for persistence and token checks
• Providers for item names, fields, and validation