About the Site

Envs Links:

GitHub Repo:

Doc: https://atlassian-bacardi.atlassian.net/wiki/spaces/BWD/pages/1669169153


This site is the central hub for all our work with the WordPress block editor and the Full Site Editing approach. It combines documentation, a testing environment, and a showcase of all solutions we build for the Bacardi ecosystem within FSE. The Agnostic FSE Site serves as the single source of truth for our design system, as well as for the structure and behavior of all available blocks and patterns.

Main Purposes of the Site

Design System Documentation

The site stores and describes our design system, including:

  • semantic tokens (colors, typography, spacing, sizing, etc.)
  • global styling rules
  • structural UI principles

Every design system element is presented visually and explained in the context of WordPress FSE and theme.json.

Self Documentation for Blocks and Patterns

Every custom block developed for Bacardi projects has its own dedicated page. Each page includes:

  • visual examples of the block
  • layout and style variations
  • examples of nesting inside or around the block
  • configuration options and available modifications

This allows designers, developers, and QA to clearly understand how a block should look and behave in an ideal state.

Testing and Fallback Regression

The block pages also act as a regression testing environment.

Whenever new functionality is added to a block, the page helps verify:

  • whether existing variations remain functional
  • whether nesting scenarios still work as expected
  • whether spacing, colors, and styles continue to render correctly

Each block is shown in various configurations so that potential regressions can be detected early.

Single Source of Truth for All Projects

When developing new Bacardi websites or updating existing ones:

  • any new block
  • any modification to an existing block
  • any update to the design system

must be reflected on the Agnostic FSE Site.

This ensures consistency between teams, sites, and block versions, since this site acts as the canonical reference for our entire FSE infrastructure.

A Sandbox for Experiments

The site also provides a safe environment for testing:

  • new ideas
  • alternative visual treatments
  • new block parameters and settings
  • design system updates

Because it is not tied to any specific brand, it allows experimentation before features are implemented in real production environments.

Summary

The Agnostic FSE Site is the foundation of our entire FSE architecture. It ensures consistency, transparency, and stability across the Bacardi design system and block ecosystem, serving as the place where we document, demonstrate, and test everything we build.