Brightspot CMS Developer Guide

Building a theme

To build a theme:

  1. Change to the theme directory you cloned from github.
    ├── _build/
    │   └──
    ├── babel.config.js
    ├── com/
    ├── etc/
    ├── gulpfile.js
    ├── node_modules/
    ├── package.json
    ├── postcss.config.js
    ├── styleguide/
    ├── webpack.*.js
    └── yarn.lock
    • Directory from which you run the build or start the server.
    • Built theme.
  2. Ensure you have version 12 or later of node installed: nvm ls. Install version 12 or later if necessary from
  3. Use a version 12 or later release of node: nvm use xx.x.x (use the version you discovered in step 2).
  4. If you want to build the theme and run the Styleguide server, run yarn server:styleguide.
  5. If you want to build the theme without running the Styleguide server—
    • For the first build, run yarn cache clean && yarn && yarn format && yarn build.
    • For subsequent builds, run yarn build.

The build job creates and zips the theme in the directory build/ (see previous illustration). You can apply the built theme to a site; for details, see Changing a site's theme.

Previous Topic
Next Topic
Advanced theming techniques
Was this topic helpful?
Thanks for your feedback.
The elements that get you up and running in a matter of days, from pre-built content types, to modules, to landing pages.

Content types
Landing pages
Everything you need to manage and administer content within Brightspot CMS.

Admin configurations
A guide for installing, supporting and administering code on the Brightspot platform.

Field types
Content modeling
Rich-text elements
A guide for configuring different integrations to support a multitude of use cases.

Google Analytics
Apple News