Troubleshooting Install & Download

CLI install issues

Pro command returns auth errors

Symptoms:

• 401/403 when running tokenized shadcn add command.

Checks:

1. Re-copy command from the pattern page.
2. Run immediately (token may be short-lived).
3. Confirm your account has access to that pattern.

Installed files compile with missing deps

Checks:

1. Install suggested npm dependencies.
2. Re-run pnpm install.
3. Re-run type check and lint.

Download-as-app issues

Zip downloads but app fails on first run

Most common root causes:

• missing .env.local values
• missing provider keys
• external service configuration not completed

Download denied

• Free/pro access checks run before zip creation.
• Confirm you are authenticated and entitled to the selected template.

Runtime issues after import

API route mismatch

For pro app downloads, internal preview paths are rewritten to /api/*. If calls still fail:

1. inspect generated API path references
2. verify route files exist in generated app
3. confirm dev server restarted after env updates

AI/tool behavior differs from preview

Preview and local environments can diverge due to:

• different model/provider keys
• rate limits
• absent external services

Fast debug checklist

Copypnpm install
pnpm lint
pnpm typecheck
pnpm dev

Then verify:

• env vars loaded
• route resolves
• network request status and payload shape
• provider-side logs/errors