Skip to main content

Creating a Project

A project holds one design system: its tokens, themes, versions, and the repo it's linked to. Create one from the projects list.

The fields​

Project Name — what you'll see in the projects list. Names have to be unique across your account.

Starter Repo — the GitHub repo this project links to. Two options, covered below.

Preview URL — the site the preview panel loads. Defaults to https://radium.style and is changeable later from the preview panel. See Preview URL.

Starter Repo​

Every project links to a public GitHub repo, which is what the Code tab shows.

Radium is the default and needs no configuration. It's an open-source component library already wired to Bezel, so your tokens have somewhere real to land. See radium.

Custom takes a public GitHub repo URL. Bezel validates it as you enter it, and there are two ways it can fail:

  • The repo isn't public, or doesn't exist. Bezel reads repos anonymously, so private repos won't work.
  • There's no design-tokens.json at the repo root. The filename and location are fixed. A file nested in a subdirectory won't be found.

If your repo doesn't have that file yet, add one. Even {"$schema": "https://www.designtokens.org/schemas/2025.10/format.json"} is enough to pass, and Bezel will fill it in as you work.

Read access only

Linking a repo doesn't give Bezel write access. There's no push, commit, or pull request from the editor. See The design-tokens.json File for how tokens get into your repo.

How would you like to start?​

Three ways in:

Blank — an empty project. Best if you're importing tokens later or building up from the Design guides.

Generate — describe what you want and the AI builds a starting token system. There are suggested prompts if you'd rather not write one. Generation takes a few minutes on larger systems.

Upload — bring an existing token library as JSON. Requires Foundation or higher; on lower plans the tab shows an upgrade link instead. Imports also take a few minutes.

After you create it​

You land in the Tokens tab with your groups in the side nav. From here, The Editor covers the workspace, and Quick Start covers wiring the tokens into a codebase.

Project counts are limited per plan.