Guides

How to create a theme bootstrapped theme with custom schemas and data

If you need more control over the schcemas you can manually create them using the Built Studio Theme Designer

It's easy to create a reusable theme with custom schemas using Built Studio.

Create and configure a theme in Built Studio

In the themes workspace of Built Studio, click the "Create Theme" button. You can choose to create a theme using the Built.js CLI, which requires an OpenAI API Key, but this guide focusses on creating one manually through Built Studio. Select the "Manual Creation" option, give your theme a name and 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 --plugins

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.

You can also use AI to create the templates by running npx create-built-app design --templates. This will create fully styled React components using the description for each template in public/data/templates.json in the AI prompt.

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.

Learn more about a theme's lifecycle.

On this page