diff --git a/CHANGELOG.md b/CHANGELOG.md
index f5373d4..22983ba 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,14 @@ This project follows [Semantic Versioning 2.0.0](https://semver.org/spec/v2.0.0.
---
+## [Unreleased]
+
+### Fixed
+
+- `doc/interactivity/animation.md`: removed the Arbitrary Values section that claimed `animate-[...]` bracket syntax works; `AnimationParser` only resolves theme-map keys, so the example silently no-ops. Use the Customizing Theme section to register custom animations. (#83)
+
+---
+
## [1.0.0] - 2026-05-21
The first stable release. Wind ships a complete utility-first styling layer for Flutter with className syntax, theming, responsive breakpoints, dark mode, dynamic JSON rendering, and a contracts-based debug bridge for external tooling. All public APIs in this release are considered stable; the surface follows Semantic Versioning from this point on.
diff --git a/doc/interactivity/animation.md b/doc/interactivity/animation.md
index b245a30..b649d5b 100644
--- a/doc/interactivity/animation.md
+++ b/doc/interactivity/animation.md
@@ -11,7 +11,6 @@ Utilities for animating elements with CSS-like animation classes. Whether you're
- [Bounce](#bounce)
- [Responsive Design](#responsive-design)
- [Dark Mode](#dark-mode)
-- [Arbitrary Values](#arbitrary-values)
- [Customizing Theme](#customizing-theme)
- [Related Documentation](#related-documentation)
@@ -114,15 +113,6 @@ Animations work seamlessly with dark mode. You'll typically just change the colo
WDiv(className: 'animate-pulse bg-gray-200 dark:bg-gray-700')
```
-
-## Arbitrary Values
-
-If the built-in animations don't quite fit, you can use arbitrary values to specify custom animation strings.
-
-```dart
-WDiv(className: 'animate-[wiggle_1s_ease-in-out_infinite]')
-```
-
## Customizing Theme