Troubleshooting
Errors and how to fix them
When an install fails
| What you see | What to do |
|---|---|
Registry "@divplate" requires the following environment variables: DIVPLATE_TOKEN | Your key is missing. Add it to .env.local, in the same folder as components.json. |
[token_required] | Your components.json is missing the headers part. Copy it again from Getting started. |
[token_invalid] | The key is wrong, often because the end got cut off. Copy it again from the email Polar sent you, or from Polar's customer portal. |
[token_revoked] | This key no longer works, usually because of a refund. If that surprises you, write to support@divplate.com. |
[registry_unavailable] | Something is wrong on our side. Try again in a minute. |
[setup_code_spent] | A setup prompt works once, for 60 minutes. Copy a fresh one. |
Installation cancelled. | Adding a theme, such as @divplate/tokens or a palette, asks a question first, and an agent cannot answer it. Run the command again with --yes at the end. |
The setup ran, but installs say [token_invalid] | An old key is still in .env.local. Delete the DIVPLATE_TOKEN line and copy a fresh setup prompt. |
Updating a block
Install it again to get the latest version:
npx shadcn@4.21.4 add @divplate/hero-04If you changed the file, the command asks before overwriting it. An agent
cannot answer that question, so the install stops. Run it yourself, or add
--overwrite to replace your changes.
Divplate is in early access, so blocks may still change. Anything you already installed stays as it is.