Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

⚠️ This version of Waffles Design System was deprecated at the end of 2022. It's main repository is archived. Please migrate your app to the New Waffles.

This repository holds all of the code for the waffles design system. This includes but is not limited to the documentation site, design tokens and a react component library. Full details on usage can be found on

Running Locally

Waffles uses Yarn and Lerna to manage dependencies. Follow the following steps to work with the code on a local machine:

  • Clone the repository
  • Execute yarn install in the root directory
  • Execute yarn bootstrap to install and link all subdependencies

In order to view and work with components locally, check out the storybook package.

Repository Structure

This repository is a mono-repo powered by lerna. All the source code can be found in the /packages directory. This is split into 3 directories to organise different types of packages:

  • docs contains all packages relating to documentation
  • other contains published packages that do are neither react-components or stylesheets
  • react-components contains styled react components
  • stylesheets contains scss stylesheets
  • tools contains private packages that are used within this repo as dev dependencies. They are not published to the registry.

This separation is purely organisational, and does not affect the contents of each package. Every package.json should represent its dependencies as if they will be installed from the registry instead of as relative file paths. Lerna will link these packages locally when running the bootstrap command. Check the Readme files in each directory for more information.


For guidelines around ci, deployment and anything else you may need to contribute to this project, check out the contribution guidelines