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

Hono export issues

For an unavailable Hono action, Node startup failure, CORS error, or broken stream, use the dedicated Hono troubleshooting guide.

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