diff --git a/src/content/docs/usage/animations.mdx b/src/content/docs/usage/animations.mdx
index 3f225cc3..5ac319df 100644
--- a/src/content/docs/usage/animations.mdx
+++ b/src/content/docs/usage/animations.mdx
@@ -3,4 +3,45 @@ title: Animations
description: Configuring animations
---
-TODO
+import KomorebicPlatformLink from '../../../components/KomorebicPlatformLink.astro';
+import KomorebiConfigPlatformLink from '../../../components/KomorebiConfigPlatformLink.astro';
+import { Tabs, TabItem, Steps } from '@astrojs/starlight/components';
+
+
+
+
+
+
+
+
+
+Animations are an experimental feature in both komorebi for Windows and komorebi for Mac.
+
+## Enable Animations
+
+Animations are in the configuration file.
+
+```json
+{
+ "animation": {
+ "enabled": true,
+ "duration": 250,
+ "fps": 120,
+ "style": "EaseOutSine"
+ }
+}
+```
+
+Animations can be enabled (and disabled) in realtime using the command.
+
+## Animation Duration
+
+The duration of animations can be and defaults to `250`.
+
+## Animation FPS
+
+The FPS of animations can be and defaults to `60`. Note that increasing this value will increase CPU usage.
+
+## Animation Style
+
+The Animation style can be configured using and defaults to `Linear`.