From fbac3169915c8a866e49bf7dda54a8faa6786105 Mon Sep 17 00:00:00 2001 From: Florian Duros Date: Fri, 16 Jan 2026 16:13:26 +0100 Subject: [PATCH] doc: add shared component mention in `CONTRIBUTING.md` (#31772) --- CONTRIBUTING.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 3ec59b2eff..e269853d7f 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -184,6 +184,16 @@ Please ensure your changes match the cosmetic style of the existing project, and **_never_** mix cosmetic and functional changes in the same commit, as it makes it horribly hard to review otherwise. +## Shared Components + +When creating new UI components, consider whether they should be added to the shared components package (`packages/shared-components`) rather than directly in the main `src/` directory. Components should be placed in shared components if they: + +- Are reusable across different parts of the application +- Could potentially be used by other Element projects (Element Desktop, Aurora, Element modules...) +- Follow established patterns and don't have tight coupling to specific application logic + +For more details, see the [shared components README](./packages/shared-components/README.md). + ## Attribution Everyone who contributes anything to Matrix is welcome to be listed in the