Your licence key

Where to find your Candor UI licence key, how to set it, what it unlocks, what a refund does to it, and how to share a Team key. Free items need no key.

Where it is

Polar sells Candor UI and issues the key when you buy. It is in two places:

Your receipt email from Polar.
Polar's customer portal, at polar.sh/themethodic/portal. Sign in with the email you paid with; Polar emails you a code.

Set it

In your app's folder:

npx candor-ui key <your licence key>

This saves the key in .env.local (keep that file out of git), checks it with the registry and tells you the tier it found, then updates the @candor registry in components.json to send it. After that, npx candor-ui add <item> or npx shadcn add @candor/<item> installs paid items. npx candor-ui key --remove takes it out again, and npx candor-ui doctor says whether the key is set and accepted.

In CI and on your host, set CANDOR_LICENSE_KEY as a secret, so installs and candor-ui verify can read paid items. Installed code needs no key to run: the key is only for installing and updating from the registry.

What it covers

Which items each tier includes is in section 1 of the licence and on the pricing, which is where the counts are kept. In short:

Free items need no key.
A Pro key installs the Pro items.
A Premium or Team key installs those and the full-stack blocks and templates.

If you ask for an item above your tier, the registry says so ("This item is in Premium; your key is for Pro."). Your key covers every version of Candor UI we publish: major versions and earlier ones are included.

Refunds

You can ask for a full refund within 30 days of buying, through Polar or at info@themethodic.com. Refunding the order in Polar revokes the key. The registry remembers a good key for up to 10 minutes, so new installs and updates stop within about 10 minutes of the refund.

Code you already installed stays in your project, because it is source that was copied there. The licence ends with the refund, and section 5 of the licence says you remove the paid items from your projects within 30 days.

A Team licence covers up to ten people in one company, contractors included, and they all use the same key. The key is a secret, so:

Put it in your team's secrets manager and in your CI's secret store, and let each person read it from there.
Don't paste it in chat or email, commit it to a repository, put it in a shared components.json or a public package, or give it to anyone the licence doesn't cover. Section 3 of the licence rules that out.
npx candor-ui key writes to .env.local, which should stay out of git. If a key does get committed, tell us so the key can be revoked in Polar.

This site has no seat management. Polar's customer portal is where the order and key live. When the people on a Team licence change, email info@themethodic.com, as the licence asks.

When a key doesn't work

"This licence key isn't valid. It may be mistyped, refunded or expired." Copy it again from the receipt email or the portal. If the order was refunded, the key is gone.
"This item is in Premium; your key is for Pro." The key works; the item is in a higher tier. See the licence.
"Can't check licence keys right now. Try again shortly." Polar couldn't answer. Nothing is wrong with your key.
"This licence key isn't for Candor UI." The key is from another product.

Getting help

Email info@themethodic.com. Premium has best-effort email support and Team has a first reply within 2 business days. Pro has no email support; the docs and get started cover installing, and a refund request is answered at the same address. Support covers Candor UI's own code, not your application.