diff --git a/CLAUDE.md b/CLAUDE.md
index 0810b7b6..8cb4d32b 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -669,4 +669,10 @@ And **never** do this:
 - `Phoenix.View` no longer is needed or included with Phoenix, don't use it
 
 <!-- phoenix:phoenix-end -->
+<!-- fluxon-start -->
+## fluxon usage
+_Fluxon UI Components_
+
+[fluxon usage rules](deps/fluxon/usage-rules.md)
+<!-- fluxon-end -->
 <!-- usage-rules-end -->
diff --git a/mix.exs b/mix.exs
index ff86fe5c..b8a257da 100644
--- a/mix.exs
+++ b/mix.exs
@@ -66,7 +66,7 @@ defmodule MusicLibrary.MixProject do
        app: false,
        compile: false,
        depth: 1},
-      {:fluxon, "~> 2.0.0", repo: :fluxon},
+      {:fluxon, "~> 2.1.0", repo: :fluxon},
       {:flagmojis, "~> 1.0"},
       {:live_toast, "~> 0.8.0"},
 
diff --git a/mix.lock b/mix.lock
index 149b71da..dd6505b4 100644
--- a/mix.lock
+++ b/mix.lock
@@ -23,7 +23,7 @@
   "fine": {:hex, :fine, "0.1.4", "b19a89c1476c7c57afb5f9314aed5960b5bc95d5277de4cb5ee8e1d1616ce379", [:mix], [], "hexpm", "be3324cc454a42d80951cf6023b9954e9ff27c6daa255483b3e8d608670303f5"},
   "flagmojis": {:hex, :flagmojis, "1.0.0", "d2b411d9d2c150180103a4d605ee394cabc23c2b6ddf7a0011a9a55a23575281", [:mix], [], "hexpm", "9d9916575cf9dcbe6f0199b410994bec9d19d47971f70089eb7f210f823cd293"},
   "floki": {:hex, :floki, "0.38.0", "62b642386fa3f2f90713f6e231da0fa3256e41ef1089f83b6ceac7a3fd3abf33", [:mix], [], "hexpm", "a5943ee91e93fb2d635b612caf5508e36d37548e84928463ef9dd986f0d1abd9"},
-  "fluxon": {:hex, :fluxon, "2.0.0", "6a4bff70261584b45a112618a44a1eda8118cdc40fd015cbe6d10ebe83e179c6", [:mix], [{:phoenix_live_view, ">= 1.0.0", [hex: :phoenix_live_view, repo: "hexpm", optional: false]}], "fluxon", "e12c57b3e7c7a35f5ca18d575f70900899185ca1e27bc6f42ded345366ee45fe"},
+  "fluxon": {:hex, :fluxon, "2.1.0", "ba62db5c5c39cf68fd5ca197d72da4d48f57c9c93ddc9a57ebdbd584f238bfec", [:mix], [{:phoenix_live_view, ">= 1.0.0", [hex: :phoenix_live_view, repo: "hexpm", optional: false]}], "fluxon", "c9b09a132d53f3dae9d74845a0c8d6d29e01bb0c9f7a6312730c8bcbd83c0df6"},
   "gettext": {:hex, :gettext, "0.26.2", "5978aa7b21fada6deabf1f6341ddba50bc69c999e812211903b169799208f2a8", [:mix], [{:expo, "~> 0.5.1 or ~> 1.0", [hex: :expo, repo: "hexpm", optional: false]}], "hexpm", "aa978504bcf76511efdc22d580ba08e2279caab1066b76bb9aa81c4a1e0a32a5"},
   "glob_ex": {:hex, :glob_ex, "0.1.11", "cb50d3f1ef53f6ca04d6252c7fde09fd7a1cf63387714fe96f340a1349e62c93", [:mix], [], "hexpm", "342729363056e3145e61766b416769984c329e4378f1d558b63e341020525de4"},
   "heroicons": {:git, "https://github.com/tailwindlabs/heroicons.git", "0435d4ca364a608cc75e2f8683d374e55abbae26", [tag: "v2.2.0", sparse: "optimized", depth: 1]},