Guideline Blocks

Local block development

Requirements:

• Node 26
• pnpm 11
• Access to a Frontify guideline

Setup

1. Clone this repository

   $ git clone git@github.com:Frontify/guideline-blocks.git
   

2. Install the dependencies

   $ pnpm install
   

3. Create a build of the utilities

   $ pnpm build
   

4. Serve a block

   $ cd packages/<block name>
   $ pnpm serve
   

5. Go to your Frontify guideline
6. Switch to edit mode
7. Click on the plus icon and add a "Local Block Development" block
8. Choose port (default is 5600) and click OK

Releasing

Merging to main publishes exactly the blocks that have a release entry in .releases, and nothing else. No entry, no release.

cd packages/audio-block && pnpm release   # this block
pnpm release                              # repo root: one changelog, every block
pnpm release:plan                         # preview what the next merge publishes

pnpm release asks for the changelog text and writes a small file to .releases, which you commit with your change. CI reads it on merge, deploys and publishes each block named, and deletes the file.

There are no version numbers to bump -- the marketplace assigns its own version per app on every deploy.