Skip to content
Go to file

Latest commit


Git stats


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

Wonder Blocks

CircleCI codecov

The Khan Academy Wonder Blocks design system. This is work-in-progress and a lot of things are still in motion.

More information:

Getting started



To install Wonder Blocks, you need to run the following commands:

yarn install

Installs project dependencies

yarn start

Runs the docs in dev mode

Now you can open http://localhost:6060 to view the docs. This page will automatically update as you make changes to components.


Note for external contributors: We are not accepting external contributions at this time. We are working to make this happen in the future, and we will let you know when this is possible!

For a more detailed explanation about how to develop Wonder Blocks components, please refer to the internal documentation

Please note – before contributing ensure that any design changes you are wanting to make are reflected in the Wonder Blocks project in Figma or Zeplin. We previously used Zeplin, but have since moved to Figma. Please check Figma first — if a design isn't there please check Zeplin. Moving forward we will be transitioning away from Zeplin, but in the interim you may need to check both.


Thanks to Chromatic for providing the visual testing platform that helps us catch unexpected changes on time.

You can’t perform that action at this time.