Skip to content

Commit 896067f

Browse files
authored
docs: add topology-based project structure decision tree (#7517)
1 parent bbe9c91 commit 896067f

1 file changed

Lines changed: 13 additions & 0 deletions

File tree

docs/docs/best-practices/structuring-your-projects.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,19 @@ Before diving into recommendations, it's helpful to understand how Flagsmith org
1616

1717
For more details, see the [Data Model](/flagsmith-concepts/data-model) documentation.
1818

19+
## Decision tree: pick a structure by topology
20+
21+
Most decisions land cleanly when you look at how your business products and teams map to Flagsmith.
22+
23+
| Your topology | Recommended structure |
24+
|---|---|
25+
| Single business product, multiple surfaces (web + mobile + backend) | **Single project** — one shared source of truth across surfaces. Use tags, naming conventions, and tag-based RBAC to manage scope within it. |
26+
| Multiple distinct business products under one organisation | **One project per business product.** Each product gets its own list of features and its own access boundary. |
27+
| Independent service teams with no shared product context | **Split by team ownership.** Easy to refactor later via flag export between projects. |
28+
| Default when uncertain | **Bias toward fewer projects.** Expand as needed if you experience friction or confusion. |
29+
30+
The sections below explore the trade-offs in more depth.
31+
1932
## When to create separate projects
2033

2134
Consider creating separate projects when:

0 commit comments

Comments
 (0)