Themes
Build a storefront theme for Queek stores with React components and CSS. Create, preview, check and submit it with the queek CLI.
A Queek theme is the look of a store. It is React components and CSS. Queek runs the store itself (catalogue, cart, checkout and payment) and your theme decides how it all looks.
You build with three things:
- The starter: a complete theme with no design in it, created by one command.
- The kit (
@usequeek/theme-kit): data, cart, auth and checkout flows your components call through hooks. - The CLI (
queek theme …): preview, check, screenshot and package commands.
You need Node.js 22.12 or later and an editor. You do not configure Next.js, and you never call an API: the kit does both.
Build your first theme
npm create @usequeek/theme@latest my-theme
cd my-theme
npm run devcreate asks for the theme's name, the businesses its templates are for and a few tags, then
writes a working theme. npm run dev previews every page of every demo store at
http://localhost:7833. The quickstart takes it from there to a
submitted zip in six steps.
Quickstart
From zero to a submitted zip in six steps.
How themes work
The folder, the kit, templates and designs.
Templates and designs
Dress your theme as real businesses, each with its own demo store.
Requirements
What gets a theme rejected, grouped by area.
Translating your theme
Locale files, the t function and the rules that check them.
CLI and checks
Every command, flag and check rule.
How a theme reaches merchants
You submit a zip or a git URL. Queek reviews it against the theme requirements. Once it passes, the theme is listed for merchants to pick for their stores. If anything fails you are told exactly what, so you can fix it and resubmit. See Submit your theme.