Storybook GitLab
Updated Jan 22, 2026

Contributing

There are many ways to contribute to the EBRAINS Design System. Whether you’re a researcher, developer, designer, or product expert, your expertise can make a significant impact.

How to Contribute

1. Identify an Issue

Start by checking our open issues or propose a new one. Make sure your contribution aligns with the design system principles.

2. Submit a Proposal

For significant changes, submit a proposal or design mock-up before starting work. This helps ensure your contribution aligns with the direction of the project.

3. Make Your Contribution

Once approved, work on your contribution and submit a merge request. Provide detailed notes about your changes and reference any related issues.

Types of Contributions

  • New Components — Propose missing elements that align with design principles and meet accessibility standards
  • Component Enhancements — Suggest improvements to boost functionality, accessibility, or performance
  • UI/UX Refinements — Contribute design refinements for better usability and visual consistency
  • Design Tokens — Add or update tokens for uniform styling across applications
  • Documentation — Expand or refine guidelines, examples, and best practices
  • Bug Reports — Report bugs or inconsistencies via GitLab Issues
  • Bug Fixes — Fix issues to ensure error-free components and documentation