Skip to content

Commit f8ce900

Browse files
authored
Merge pull request #15 from 1mb-dev/docs/when-to-use
docs: add When to Use This section
2 parents 0d9ef4a + d2040d6 commit f8ce900

1 file changed

Lines changed: 14 additions & 0 deletions

File tree

README.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,20 @@ Deterministic percentage-based bucketing for feature flags and A/B testing.
1818
- Dual module (ESM + CommonJS)
1919
- Lightweight (< 5KB minified)
2020

21+
## When to Use This
22+
23+
Use rollout-bucket when you need deterministic percentage-based bucketing without a feature flag service.
24+
25+
**Choose rollout-bucket over [LaunchDarkly](https://launchdarkly.com) / [Unleash](https://www.getunleash.io) when:**
26+
- You want stateless, client-side bucketing with no external service or API calls
27+
- You need deterministic assignment (same user always gets the same bucket, no database needed)
28+
- You're building a lightweight rollout system and don't need targeting rules, analytics, or a management UI
29+
30+
**Choose a feature flag service instead when:**
31+
- You need user targeting by attributes (country, plan, segment)
32+
- You need a management dashboard for non-engineers to toggle features
33+
- You need event tracking and experiment analytics
34+
2135
## Installation
2236

2337
```bash

0 commit comments

Comments
 (0)