How to create a theme

Create and configure a theme in Built Studio

In the themes workspace of Built Studio, click the "Create Theme" button. Use the Theme Designer to define all the pages, sections, collections and other items for your theme.

Export the and set up the theme

Download and extract the theme zip file and follow the instructions in the README to create a Next.js project and set the configurations. This includes running npx create-built-app update to update the theme with the plugins specified in the theme.json file.

Update the theme's plugins

Run:

npx create-built-app update

Create your theme's templates (React components)

Go to the project's components/templates directory and design each template. The section data you defined (when creating the theme in Built Studio) will be available to use in the template.

Publish the theme

Publish your theme to your Built Studio workspace by running:

npx create-built-app publish

The studio will first validate the theme to make sure it meets the basic requirements.