The Catalog project has been deprecated and is no longer under active development or maintenance. Existing users may continue to use it at their own discretion, but no further updates or support will be provided.

For new work, consider alternatives below (depending on your goals — component “playgrounds”, design-system docs, or UI documentation).

• Storybook — The most widely used UI component explorer with a rich ecosystem of addons. Great for React, Vue, and other frameworks.
• Ladle — Lightweight, fast alternative to Storybook built on Vite. Minimal configuration, simple setup.
• Zeroheight — Design-system documentation platform used by designers; integrates tightly with Figma and design tokens.
• Supernova — Professional design-system management platform combining docs, tokens, and code.
• GitBook — Hosted documentation platform with excellent UX and collaboration features. Great for design system and product documentation.
• Docusaurus — Open-source static site generator for documentation, built with React and Markdown. Excellent for technical or design system sites.

🚧 This is the currently in-development v4 branch. Stable code is in master.

Catalog lets you create beautiful living and fully interactive style guides using Markdown and React components.

Please read the Catalog documentation (built with Catalog!) for detailed installation and usage instructions.

yarn add catalog react react-dom

npm install catalog react react-dom --save

Please make sure that you have Node >= 6 and yarn installed.

Start the build process in watch mode:

make

To edit Catalog documentation, run:

make docs

Note: this uses the local Catalog build from dist/. Run make before/alongside make docs.

When developing Catalog you want to link it locally:

yarn link

You can then link to this version in your project (or one of the examples):

yarn link catalog

To run Jest tests in watch mode:

make test-watch

Bump Catalog's version:

make version

Then push including tags:

git push && git push --tags

The CI server will automatically run tests, build and publish the new version to npm

These usually run automatically on the CI server

make build

make build-docs

make publish

Catalog is developed by many people at Interactive Things, a User Experience and Data Visualization Studio based in Zürich.