The Problem with No Exceptions
A drift tool that can't be told "I know" becomes a noise machine. Teams stop trusting the output. Real issues hide behind a wall of known exceptions. Ignore rules fix that.
Without Ignore Rules
- ✗ 47 drift signals — but 30 are in legacy code
- ✗ CI fails on code nobody plans to change
- ✗ Team ignores the report entirely
- ✗ Real drift slips through the noise
With Ignore Rules
- ✓ 17 drift signals — all actionable
- ✓ CI passes on known exceptions
- ✓ Team trusts the output
- ✓ Real drift gets caught immediately
Add an Ignore Rule
One command. Targeted filters. The noise disappears.
Four Ways to Filter
Target exactly what you want to ignore. Combine flags for precision.
--file
Ignore drift in matching files or directories. Perfect for legacy code you won't be touching.
--type
Ignore an entire drift type. Useful when a category doesn't apply to your project.
--component
Ignore drift from a specific component. For intentional one-offs or third-party wrappers.
--value
Ignore a specific hardcoded value. When a particular value is intentional and shouldn't be a token.
How It Works
Detect
Run buoy drift check to see all drift signals in your codebase.
Ignore Intentional
Add ignore rules for legacy code, known exceptions, and intentional deviations.
Focus on Real Drift
Future checks only surface actionable issues. CI stays green for known exceptions.
See What's Ignored
Full visibility into every rule. Nothing is hidden from you.
Combine Filters for Precision
Stack flags to create targeted rules that match exactly what you need.
<div class=""># Ignore hardcoded colors in legacy files</div><div class="">buoy drift ignore add --file "src/legacy/**" --type hardcoded-color</div><div class=""></div><div class=""># Ignore a specific value in a specific component</div><div class="">buoy drift ignore add --component "OldButton" --value "#333"</div><div class=""></div><div class=""># Ignore all drift in vendor code</div><div class="">buoy drift ignore add --file "vendor/**"</div><div class=""></div><div class=""># View your rules anytime</div><div class="">buoy drift ignore show</div>