https://github.com/metabrainz/design-system

A Storybook project for UI development of React components for the MetaBrainz projects
https://github.com/metabrainz/design-system

metabrainz musicbrainz react storybook ui-components

Last synced: about 1 month ago
JSON representation

A Storybook project for UI development of React components for the MetaBrainz projects

• Host: GitHub
• URL: https://github.com/metabrainz/design-system
• Owner: metabrainz
• Created: 2018-02-10T04:09:02.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2025-07-22T10:24:48.000Z (3 months ago)
• Last Synced: 2025-07-28T00:21:39.931Z (3 months ago)
• Topics: metabrainz, musicbrainz, react, storybook, ui-components
• Language: JavaScript
• Homepage: https://metabrainz.github.io/design-system
• Size: 92.1 MB
• Stars: 28
• Watchers: 14
• Forks: 10
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          


  


  

  

  

  

  

  

  

  

  



MetaBrainz Design System

      



  About •

  Guidelines •

  Contributing •

  Issues •

  Support



---

## About

This design system is a living, breathing document that contains all of the building blocks (React components, colors, icons, layout, etc) of the MetaBrainz projects. It aims to be single source of truth for developers and designers. Still a work in progress, always will be. 

## Quick Links

- [Logo folder](./brand/logos)

- [Storybook project](https://metabrainz.github.io/design-system/)

- Figma mockups: [MetaBrainz](https://www.figma.com/file/L0qNv3z5vSkNDoiX7BzaY5/MetaBrainz-redesign), [MusicBrainz](https://www.figma.com/file/ln8XiFLit634KC3YkUW2RS/MusicBrainz-redesign), [CritiqueBrainz](https://www.figma.com/file/nSqrbsMcVARmj52kyXYqwb/CritiqueBrainz-redesign), [ListenBrainz](https://www.figma.com/file/YRbCOtFHBez8XmMdCKbGta/ListenBrainz-redesign), [ListenBrainz App](https://www.figma.com/file/tFLTQiq7QlA1oGRTJVtXml/ListenBrainz-Android)

- [Marketing/Comms request form](https://docs.google.com/forms/d/e/1FAIpQLSdX2824Mv-VW9x5LlX26t669y1Ft5u5xX1l6qmYSNaIz_xbQA/viewform?usp=sharing)

## Guidelines

- [Design](./guidelines/design-guidelines.md)

- [Components](./guidelines/component-usage.md)

- [Contributing](./guidelines/component-usage.md)

- [Logos](./guidelines/design-guidelines.md)

- [Writing Styleguide](./guidelines/style-guidelines.md)

## Tech stack

Building components

- 📚 [Storybook](https://storybook.js.org) for UI component development and auto-generated docs

- ⚛️ [React](https://reactjs.org/) declarative component-centric UI

Maintaining the system

- 📦 [NPM](https://www.npmjs.com/) for packaging and distribution

- 🚥 [GitHub Actions](https://docs.github.com/en/actions/automating-builds-and-tests/about-continuous-integration) Continuous integration

## Why

The MetaBrainz design system codifies existing UI components into a central, well-maintained repository. It is built to address having to paste the same components into multiple projects again and again. This simplifies building UI's with MetaBrainz's design patterns.

#### What we're doing

- Build and maintain a design system in the open

- Share UI components between multiple apps

- Welcome contributors of all levels and backgrounds

#### What we're not doing

- Rewrite all new components from scratch

- Overhaul the visual design of components

- Typescript (the consumer apps don't use it)

- Compete with more general design systems like ANT or Material.

## Install

```bash

yarn add @metabrainz/design-system

```

or

```bash

npm install --save @metabrainz/design-system

```

Everytime a GitHub release is made, a new version of the package is automatically available at [@metabrainz/design-system](https://www.npmjs.com/package/@metabrainz/design-system)

## Contributing

	  

Got **something interesting** you'd like to **ask or share**? Start a discussion at `#metabrainz` IRC channel on libera.chat.

	    

## Issues

	  

If you think you have found a bug, please report it on the [issue tracker](https://tickets.metabrainz.org/).

Also, we highly suggest you start a discussion on our [community forum](https://community.metabrainz.org/) for any design requests or discussions.

	    

## Support

Reach out to the developers at one of the following places:

- MetaBrainz Community: https://community.metabrainz.org/

- Development IRC Channel: `#metabrainz`

- E-Mail: **support@metabrainz.org**