Queek docs

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 dev

create 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.

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.

On this page