diff --git a/clarth/charcoal outline/README.md b/clarth/charcoal outline/README.md
index 1367c58..bb66abc 100644
--- a/clarth/charcoal outline/README.md	
+++ b/clarth/charcoal outline/README.md	
@@ -13,7 +13,8 @@ A clean, dark Fluxer theme with a solid charcoal background, transparent main pa
 - Distinct danger, warning, success, and presence colors.
 - Opaque menus, tooltips, and popouts for readability.
 - System fonts with no external assets or network dependencies.
-- No custom JavaScript, gradients, glow, or animations.
+- No custom JavaScript, gradients, or glow.
+- Animation-free by default, with an optional motion addon.
 
 ## Installation
 
@@ -54,7 +55,7 @@ Some secondary shades and mention backgrounds use explicit color values. Changin
 
 The theme avoids custom sidebar offsets, forced control sizes, clipping workarounds, and resize-handle changes. Native layout and scrolling behavior are left in place as far as practical.
 
-Keyboard-focus indicators remain separate from mouse-hover outlines. Existing selected-server outlines and semantic feature colors are preserved. No custom motion effects are added.
+Keyboard-focus indicators remain separate from mouse-hover outlines. Existing selected-server outlines and semantic feature colors are preserved. The base theme adds no custom motion effects. Optional animations are available through `charcoal-outline-motion.css`.
 
 ## Optional motion addon