Validate a theme with `theme check`

theme check proves that the authored theme follows Upstorr's public theme boundary before an upload.

Command

upstorr theme check my-brand-theme

The latest result is written to .upstorr-theme/check-result.json for tools and CI. Do not edit that generated result.

What is checked

The checker validates:

required theme identity and retail templates;
allowed folders and file names;
JSON and Liquid syntax;
section, block and control-pack schema;
template and section-group references;
supported browser imports;
required contract versions;
generated artifact integrity;
prohibited private platform access, direct API calls and server code.

A passing result means the package is structurally safe to compile and upload. It does not prove that the design looks good or that every shopper workflow has been tested.

Reading a failure

Fix the first real source error, then run the command again. One malformed file can create several later messages.

Never silence a check by moving forbidden code to another file. If a theme needs a platform action the public SDK does not provide, the SDK must be expanded for every theme.

Before uploading

After the check passes, inspect mobile and desktop in Workbench and complete the relevant commerce flows. Then run theme upload-version.