Home

Magma Design System - Contributor Wiki

Welcome! 👋 This wiki is the starting point for anyone who wants to contribute to Magma, the Maggioli Design System. Whether you want to report a bug, propose a new component, or improve the documentation, you will find here how to do it and where to start.

Magma is moving from a model maintained by a small core team to a community-based model. That means contributions are open to everyone - and the core team is here to support you along the way.

---

🚀 I want to…

Goal	Start here
Report something that does not work	Create a Bug Report
Suggest an idea without building it	Open a Feature Request
Build a contribution myself	Open a Contribution Proposal → read Creating an issue
Understand how a contribution gets released	Contribution flow
Learn the roles and how the community works	Contribution model
Ask a usage question	Stack Overflow channel

---

📖 Wiki pages

• Creating an issue - when to open an issue, which type to choose, and how to write it well.
• Label system - what each tag means and how issues are classified.
• Contribution flow - the development phases from issue to release (Dev → Doc → Release).
• Contribution model - roles (core team, contributor) and the shift from core team to community.

---

🔗 Resources

• Repository - https://github.com/magma-design-system/magma
• Documentation site - https://magma.maggiolicloud.it/ (beta, being rebuilt)
• Storybook (components) - https://magma.maggiolicloud.it/storybook/
• Stack Overflow (questions & answers) - https://stackoverflowteams.com/c/magma-design-system/questions

---

🧭 New here? Start in three steps

1. Read Creating an issue to understand how the entry point works.
2. Browse the open issues labelled good first issue for a gentle start.
3. When in doubt, open a Feature Request or ask on Stack Overflow - the core team will point you in the right direction.

This wiki is a living document. If you find something unclear or outdated, open a Documentation issue

• improving the docs is a contribution too.