diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000000..662f3331fd
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,6 @@
+# FNXC:RepoAssets 2026-06-25-09:00:
+# Demo reel GIFs dominate repo size (the same captures get re-shot and re-committed,
+# and git keeps every old blob forever). Route them through Git LFS so the binaries
+# live outside the packfile and future regenerations stop bloating .git.
+# Scoped to demo/assets/*.gif (track-forward only — existing history was left intact).
+demo/assets/*.gif filter=lfs diff=lfs merge=lfs -text
diff --git a/demo/assets/agent-chat.gif b/demo/assets/agent-chat.gif
index 26e5b61d4c..1dad2c8e79 100644
Binary files a/demo/assets/agent-chat.gif and b/demo/assets/agent-chat.gif differ
diff --git a/demo/assets/agent-mail-ember.gif b/demo/assets/agent-mail-ember.gif
index 243df37a5a..15e4fc6dfb 100644
Binary files a/demo/assets/agent-mail-ember.gif and b/demo/assets/agent-mail-ember.gif differ
diff --git a/demo/assets/agent-mail-gray.gif b/demo/assets/agent-mail-gray.gif
index 693f402217..f49385fe8b 100644
Binary files a/demo/assets/agent-mail-gray.gif and b/demo/assets/agent-mail-gray.gif differ
diff --git a/demo/assets/agent-mail-light.gif b/demo/assets/agent-mail-light.gif
index 5cd7c6f655..4940b6f295 100644
Binary files a/demo/assets/agent-mail-light.gif and b/demo/assets/agent-mail-light.gif differ
diff --git a/demo/assets/agent-mail.gif b/demo/assets/agent-mail.gif
index 7f23d14dab..242c8903fe 100644
Binary files a/demo/assets/agent-mail.gif and b/demo/assets/agent-mail.gif differ
diff --git a/demo/assets/chat-rooms-ember.gif b/demo/assets/chat-rooms-ember.gif
index da0305aec4..0114b79d14 100644
Binary files a/demo/assets/chat-rooms-ember.gif and b/demo/assets/chat-rooms-ember.gif differ
diff --git a/demo/assets/chat-rooms-gray.gif b/demo/assets/chat-rooms-gray.gif
index 0083fd3ca7..83a775bfb9 100644
Binary files a/demo/assets/chat-rooms-gray.gif and b/demo/assets/chat-rooms-gray.gif differ
diff --git a/demo/assets/chat-rooms-light.gif b/demo/assets/chat-rooms-light.gif
index b52a08d028..a3d16fe993 100644
Binary files a/demo/assets/chat-rooms-light.gif and b/demo/assets/chat-rooms-light.gif differ
diff --git a/demo/assets/chat-rooms.gif b/demo/assets/chat-rooms.gif
index 78dfbf7808..b18d982a94 100644
Binary files a/demo/assets/chat-rooms.gif and b/demo/assets/chat-rooms.gif differ
diff --git a/demo/assets/command-center-ember.gif b/demo/assets/command-center-ember.gif
index 1d4cc6f826..f1cd3cdc9f 100644
Binary files a/demo/assets/command-center-ember.gif and b/demo/assets/command-center-ember.gif differ
diff --git a/demo/assets/command-center-gray.gif b/demo/assets/command-center-gray.gif
index 6e49b6e460..2c1517fd63 100644
Binary files a/demo/assets/command-center-gray.gif and b/demo/assets/command-center-gray.gif differ
diff --git a/demo/assets/command-center-light.gif b/demo/assets/command-center-light.gif
index 5138cd5db7..15c153b59c 100644
Binary files a/demo/assets/command-center-light.gif and b/demo/assets/command-center-light.gif differ
diff --git a/demo/assets/command-center.gif b/demo/assets/command-center.gif
index 79e41f6c9a..49eba8e5ff 100644
Binary files a/demo/assets/command-center.gif and b/demo/assets/command-center.gif differ
diff --git a/demo/assets/fusion-company-reel.gif b/demo/assets/fusion-company-reel.gif
index 780dc01f17..c2d5ddd842 100644
Binary files a/demo/assets/fusion-company-reel.gif and b/demo/assets/fusion-company-reel.gif differ
diff --git a/demo/assets/fusion-mesh.gif b/demo/assets/fusion-mesh.gif
index 91b7e9ab24..b9d9c8368e 100644
Binary files a/demo/assets/fusion-mesh.gif and b/demo/assets/fusion-mesh.gif differ
diff --git a/demo/assets/fusion-reel.gif b/demo/assets/fusion-reel.gif
index 3c69405db7..666cfb4836 100644
Binary files a/demo/assets/fusion-reel.gif and b/demo/assets/fusion-reel.gif differ
diff --git a/demo/assets/workflows-ember.gif b/demo/assets/workflows-ember.gif
index 2f15088d1b..696b769f7f 100644
Binary files a/demo/assets/workflows-ember.gif and b/demo/assets/workflows-ember.gif differ
diff --git a/demo/assets/workflows-gray.gif b/demo/assets/workflows-gray.gif
index 212e667b10..be5f0d9d7e 100644
Binary files a/demo/assets/workflows-gray.gif and b/demo/assets/workflows-gray.gif differ
diff --git a/demo/assets/workflows-light.gif b/demo/assets/workflows-light.gif
index cea22cc18d..d0d586e1a0 100644
Binary files a/demo/assets/workflows-light.gif and b/demo/assets/workflows-light.gif differ
diff --git a/demo/assets/workflows.gif b/demo/assets/workflows.gif
index 691f449fcd..0d514a0311 100644
Binary files a/demo/assets/workflows.gif and b/demo/assets/workflows.gif differ
diff --git a/docs/contributing.md b/docs/contributing.md
index 396a649485..2fa192ff44 100644
--- a/docs/contributing.md
+++ b/docs/contributing.md
@@ -40,6 +40,19 @@ pnpm build      # default build (excludes desktop/mobile)
 pnpm build:all  # full recursive build including desktop/mobile
 ```
 
+### Git LFS (demo reel GIFs)
+
+The demo reel GIFs in `demo/assets/*.gif` are stored via [Git LFS](https://git-lfs.com) so the binaries live outside the packfile and re-shot captures stop bloating `.git` (see `.gitattributes`).
+
+Install Git LFS **before** cloning or pulling, otherwise these files arrive as small text pointer stubs instead of real GIFs:
+
+```bash
+# macOS: brew install git-lfs   (or your platform's package manager)
+git lfs install        # one-time, per machine
+```
+
+If you already cloned without LFS, run `git lfs install` then `git lfs pull` to hydrate the GIFs. New GIFs added under `demo/assets/` are routed to LFS automatically by the `.gitattributes` filter — no extra steps.
+
 ## Workspace Package Overview
 
 | Package | Purpose |