Troubleshooting

Start with the area that matches the failing part of your project.

InstallationProject creation, dependency installation, and starting development.

Templates and assetsSource discovery, template definitions, and image files.

Generated registryGenerated modules, copied assets, and stale output.

StudioThe editor, brand catalog, uploads, preview, and PNG export.

AccessLogin, sessions, users, passwords, and API tokens.

RenderingServer-side image rendering, Chromium, jobs, and output.

DeploymentRuntime, persistence, reverse proxies, and production startup.

First checks

From the project root, run the command that matches the symptom:

pnpm framekit check
pnpm framekit generate

check validates template definitions and resolved content. generate refreshes generated modules and copied template assets. Fix maintained source under src/templates/ or src/brand/, then run the command again; do not edit generated output.

For setup instructions, see Create a project, Project structure, and Use Studio.