Building a Theme
You can start building a theme right now—no account required. A theme is a self-contained frontend package, so you download a starter, customize it on your own machine, and publish it to the marketplace when it's ready.
Download the Starter
Grab the starter template to get a complete, working theme you can run and edit immediately:
The starter includes every component the platform needs, already wired to the theme contract, plus the colors, typography, and styles you'll make your own.
Customize It
Unzip the starter, install its dependencies, and open it like any frontend project:
yarn install
yarn storybook
- Adjust the design tokens—colors, typography, spacing—to set the overall look.
- Edit the components in the components folder to change how they render.
- Leave the theme's entry exports in place. They are the contract the platform swaps your theme in through, so your theme drops in without any application code changing.
Prefer the CLI? devour theme create [name] scaffolds the same starter for you
and namespaces its styles automatically.
Build and Check It
Build the theme, then check it against the contract:
yarn build
devour theme validate
devour theme validate reports how many required components your theme
implements and lists the ones that fall back to the default theme.
Publish to the Marketplace
Every theme you upload starts out private: you can use it in your own projects
right away. Uploading checks your theme automatically and lists anything that
fails, so you can fix it before trying again. Upload from Themes > My
Themes > Upload theme in the dashboard, or with devour theme upload.
When it's ready, publish it to the marketplace from the theme's page with
Publish to Marketplace, or with devour theme publish. Offer it for free and
it goes live straight away, or set a price and it's reviewed first; you're paid
when others buy it. You also choose whether others may fork it as a starting
point. Uploading a new version doesn't change the published one until you
publish that version too, and people who bought your theme get every new
version for free. See the CLI Reference
for the options.