Repository navigation
Large enhancement
Vittorio Vittori edited this page Jul 8, 2026
·
1 revision
A change that goes beyond extending an existing capability — it requires deeper integration or a refactor of a specific component.
Use this when the change reshapes how a single component works internally. If it only adds a contained option, it's a Small enhancement; if it creates something entirely new, it's a New feature.
| Design | Code | Doc | Checkpoints | Typical release |
|---|---|---|---|---|
| ✓ | ✓ | ✓ | triage → design → review & merge | minor |
All three checkpoints apply.
- Check existing issues.
- Open a Feature request with a clear set of requirements (Must / Should / Could / Won't).
Checkpoint — Core team triage.
- Start from the Components Figma file (and Design Tokens if tokens change).
- Design the reworked behaviour; align with design tokens; annotate.
Checkpoint — Core team design validation (before any code).
- Create a branch (
feat/changetype incommitlint.config.js— usechangefor breaking API changes). - Draft and document the (possibly reshaped) component API.
- Implement; add a Storybook view (visual + a11y).
- Add unit and functional tests; verify browsers/devices.
- Update dependent packages; write the changelog.
- Open a Pull Request to
dev, linking the issue.
Checkpoint — Core team review & merge.
- Update the component documentation: intro, examples, and design / accessibility / content guidelines as needed.
- Handled by the core team — typically a minor release.
Step descriptions: Steps reference. Questions: Stack Overflow.
Magma Design System - Maggioli. This wiki is maintained by the community; spot something wrong? Open a Documentation issue.