diff --git a/.changeset/wet-tigers-argue.md b/.changeset/wet-tigers-argue.md
new file mode 100644
index 0000000000..55da59b022
--- /dev/null
+++ b/.changeset/wet-tigers-argue.md
@@ -0,0 +1,6 @@
+---
+"@heroui/system-rsc": patch
+"@heroui/theme": patch
+---
+
+chore: bump tailwind-variants version
diff --git a/apps/docs/package.json b/apps/docs/package.json
index 67a3e54c5d..f032b660f3 100644
--- a/apps/docs/package.json
+++ b/apps/docs/package.json
@@ -81,7 +81,7 @@
     "sharp": "^0.32.1",
     "shelljs": "^0.8.4",
     "swr": "2.2.5",
-    "tailwind-variants": "2.0.1",
+    "tailwind-variants": "3.1.0",
     "tailwind-merge": "3.3.1",
     "unified": "^11.0.5",
     "unist-util-visit": "5.0.0",
diff --git a/packages/core/system-rsc/package.json b/packages/core/system-rsc/package.json
index 6aa64efbbd..632d3e49b5 100644
--- a/packages/core/system-rsc/package.json
+++ b/packages/core/system-rsc/package.json
@@ -42,7 +42,7 @@
     "@heroui/react-utils": "workspace:*",
     "@heroui/shared-utils": "workspace:*",
     "react": "18.3.0",
-    "tailwind-variants": "2.0.1",
+    "tailwind-variants": "3.1.0",
     "tailwind-merge": "3.3.1",
     "clean-package": "2.2.0"
   },
diff --git a/packages/core/theme/package.json b/packages/core/theme/package.json
index 2d06b72e90..aff5980006 100644
--- a/packages/core/theme/package.json
+++ b/packages/core/theme/package.json
@@ -51,7 +51,7 @@
     "deepmerge": "4.3.1",
     "flat": "^5.0.2",
     "clsx": "^1.2.1",
-    "tailwind-variants": "2.0.1",
+    "tailwind-variants": "3.1.0",
     "tailwind-merge": "3.3.1",
     "@heroui/shared-utils": "workspace:*"
   },
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 46cd8a0a06..d8a5128a77 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -473,8 +473,8 @@ importers:
         specifier: 3.3.1
         version: 3.3.1
       tailwind-variants:
-        specifier: 2.0.1
-        version: 2.0.1(tailwind-merge@3.3.1)(tailwindcss@4.1.12)
+        specifier: 3.1.0
+        version: 3.1.0(tailwind-merge@3.3.1)(tailwindcss@4.1.12)
       unified:
         specifier: ^11.0.5
         version: 11.0.5
@@ -3217,8 +3217,8 @@ importers:
         specifier: 3.3.1
         version: 3.3.1
       tailwind-variants:
-        specifier: 2.0.1
-        version: 2.0.1(tailwind-merge@3.3.1)(tailwindcss@4.1.12)
+        specifier: 3.1.0
+        version: 3.1.0(tailwind-merge@3.3.1)(tailwindcss@4.1.12)
 
   packages/core/theme:
     dependencies:
@@ -3244,8 +3244,8 @@ importers:
         specifier: 3.3.1
         version: 3.3.1
       tailwind-variants:
-        specifier: 2.0.1
-        version: 2.0.1(tailwind-merge@3.3.1)(tailwindcss@4.1.12)
+        specifier: 3.1.0
+        version: 3.1.0(tailwind-merge@3.3.1)(tailwindcss@4.1.12)
     devDependencies:
       '@types/color':
         specifier: ^4.2.0
@@ -14296,8 +14296,8 @@ packages:
   tailwind-merge@3.3.1:
     resolution: {integrity: sha512-gBXpgUm/3rp1lMZZrM/w7D8GKqshif0zAymAhbCyIt8KMe+0v9DQ7cdYLR4FHH/cKpdTXb+A/tKKU3eolfsI+g==}
 
-  tailwind-variants@2.0.1:
-    resolution: {integrity: sha512-1wt8c4PWO3jbZcKGBrjIV8cehWarREw1C2os0k8Mcq0nof/CbafNhUUjb0LRWiiRfAvDK6v1deswtHLsygKglw==}
+  tailwind-variants@3.1.0:
+    resolution: {integrity: sha512-ieiYaEfUr+sNhw/k++dosmZfVA4VIG5bV+G1eGdJSC4FcflqQv0iSIlOLj/RbzRuTu/VrIiNSlwh1esBM3BXUg==}
     engines: {node: '>=16.x', pnpm: '>=7.x'}
     peerDependencies:
       tailwind-merge: '>=3.0.0'
@@ -28267,7 +28267,7 @@ snapshots:
 
   tailwind-merge@3.3.1: {}
 
-  tailwind-variants@2.0.1(tailwind-merge@3.3.1)(tailwindcss@4.1.12):
+  tailwind-variants@3.1.0(tailwind-merge@3.3.1)(tailwindcss@4.1.12):
     dependencies:
       tailwindcss: 4.1.12
     optionalDependencies: