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
When your theme is ready, you can publish it to the marketplace—offer it for free, or set a price and earn payouts when others build on your work. You choose whether each theme is private to your own projects or public for everyone, and whether others may fork it as a starting point. Uploading checks your theme automatically and tells you if anything is missing before it goes live.
Publish from Themes > My Themes > Upload theme in the dashboard, or
with devour theme upload. See the
CLI Reference for the upload options.