Kaizen is Culture Amp's public design system. It accelerates Culture Amp's designers and engineers as they collaborate on creating world-class products. Visit cultureamp.design to learn more.
This repository is the source of truth for Culture Amp's design system documentation and hosts packages such as Kaizen Component Library, which are used across Culture Amp's products. It is structured as a multi-package repository, with a number of independently versioned projects sharing common tools, workflows and vision.
This document serves to orient you within the repository — to get you set up and acquainted, and then send you off in the right direction. For more information on any specific package, please refer to its README.
You can explore or create Issues to track ideas, enhancements, or bugs. Use issues to track:
- Changes to design documentation
- Missing documentation
To learn more, see the designer section of the Contributing guidelines.
You can edit Kaizen Site documentation using GitHub's interface.
To learn more, see the designer section of the Contributing guidelines.
Set up access to private Culture Amp packages on your laptop. You will need to update ~/.npmrc with a Github token linked to your account. Refer to the instructions here.
Ensure devbox is setup as per https://cultureamp.atlassian.net/wiki/spaces/DE/pages/3342434338/Devbox+setup
Install and start processes (this start an interactive UI in your terminal) devbox services up
The interactive terminal UI that pops up is called process-compose, see our Confluence page for tips on how to use it.
Please see the LDE Confluence page for more information [1]:https://cultureamp.atlassian.net/wiki/x/ZYGJyw [2]:https://cultureamp.atlassian.net/wiki/spaces/DE/pages/3342434338
(Having trouble running Storybook? Try running pnpm reset, which includes pnpm clean and pnpm install --force!)
While the main site is located at https://cultureamp.design, all branches in this repository are uploaded to Chromatic. Your branch will be updated with a comment containing a link when the upload has completed.
It's dangerous to go alone! Take these:
| Command | Summary |
|---|---|
pnpm storybook |
Develop components locally using Storybook |
STORIES=path/to/package pnpm storybook |
Develop just one package at a time using Storybook (builds faster!) |
pnpm compile |
Run all typechecks |
pnpm lint |
Run all linters |
pnpm lint:fix |
Run all linters, fixing violations |
pnpm plop |
Add a new component/subcomponent |
pnpm test |
Run all Jest tests |
pnpm storybook:test |
Run tests on all Storybook stories |
pnpm reset |
Reinstall all dependencies |
Please open a new GitHub Issue to report bugs or suggest changes.
Culture Amp employees can reach out to the Design Systems crew on Slack.