Docs Themes Submitting a theme

Submitting a theme

What to run, what to send, and what a reviewer actually looks at.

Before you send anything

bash

pnpm theme:check   # contract conformance + originality
pnpm build         # must build standalone
pnpm lint

All three must be clean. A submission that fails its own checks does not reach a reviewer.

What reviewers check

Empty states. Every page with no data, and with one item.
Long content. A 90-character listing title. A merchant with 40 listings.
Accent range. Light, dark and saturated merchant accents.
Small screens. Real phones, not just a narrow window.
The hand-off. Links into /checkout and /account land correctly and look continuous.
Accessibility. Contrast, focus states, heading order, keyboard navigation.

Ship it with your own content. Include the fixture content you designed against. A reviewer seeing your intended composition judges the design; a reviewer seeing lorem ipsum judges the gaps.