nuxt · rdjanuar · Jul 16, 2025 · Jul 16, 2025 · Jul 16, 2025 · Jul 16, 2025
diff --git a/.github/labeler.yml b/.github/labeler.yml
@@ -6,9 +6,3 @@ v3:
 
 v4:
   - base-branch: 'v4'
-
-documentation:
-  - changed-files:
-    - any-glob-to-any-file:
-      - 'docs/**/*'
-      - '**/*.md'
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
diff --git a/.github/workflows/module.yml b/.github/workflows/module.yml
@@ -32,7 +32,7 @@ jobs:
         uses: pnpm/action-setup@v4
 
       - name: Install node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v5
         with:
           node-version: ${{ matrix.node }}
           cache: pnpm
@@ -99,7 +99,7 @@ jobs:
         uses: pnpm/action-setup@v4
 
       - name: Install node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v5
         with:
           node-version: 22
           cache: pnpm
@@ -144,7 +144,7 @@ jobs:
         uses: pnpm/action-setup@v4
 
       - name: Install node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v5
         with:
           node-version: 22
           cache: pnpm
@@ -189,7 +189,7 @@ jobs:
         uses: pnpm/action-setup@v4
 
       - name: Install node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v5
         with:
           node-version: 22
           cache: pnpm
@@ -241,7 +241,7 @@ jobs:
         uses: pnpm/action-setup@v4
 
       - name: Install node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v5
         with:
           node-version: 22
           cache: pnpm

diff --git a/.github/workflows/playground.yml b/.github/workflows/playground.yml
@@ -25,7 +25,7 @@ jobs:
         uses: pnpm/action-setup@v4
 
       - name: Install node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v5
         with:
           node-version: ${{ matrix.node }}
           cache: pnpm

diff --git a/.github/workflows/pr-labeler.yml b/.github/workflows/pr-labeler.yml
@@ -13,7 +13,7 @@ jobs:
 
     steps:
       - name: Label PRs based on base branch
-        uses: actions/labeler@v5
+        uses: actions/labeler@v6
         with:
           repo-token: "${{ secrets.GITHUB_TOKEN }}"
           configuration-path: .github/labeler.yml

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -25,7 +25,7 @@ jobs:
         uses: pnpm/action-setup@v4
 
       - name: Install node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v5
         with:
           node-version: ${{ matrix.node }}
           cache: pnpm

diff --git a/.github/workflows/reproduction.yml b/.github/workflows/reproduction.yml
@@ -14,7 +14,7 @@ jobs:
       issues: write
 
     steps:
-      - uses: actions/stale@v9
+      - uses: actions/stale@v10
         with:
           days-before-stale: -1 # Issues and PR will never be flagged stale automatically.
           stale-issue-label: 'needs reproduction' # Label that flags an issue as stale.

diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,14 @@
 # Changelog
 
+## [3.3.4](https://github.com/nuxt/ui/compare/v3.3.3...v3.3.4) (2025-09-15)
+
+### Bug Fixes
+
+* **FileUpload:** add missing `button` type ([91f86d9](https://github.com/nuxt/ui/commit/91f86d9da2a614bd37a12f2ece9ff3ce176e8cb2)), closes [#4935](https://github.com/nuxt/ui/issues/4935)
+* **Form:** handling race condition on `clear` function ([#4843](https://github.com/nuxt/ui/issues/4843)) ([0a8ead7](https://github.com/nuxt/ui/commit/0a8ead72b53019969cf28d91549b9495ccc89f02))
+* **InputMenu/Select/SelectMenu:** show falsy value when model value is falsy ([#4882](https://github.com/nuxt/ui/issues/4882)) ([5b9d9d8](https://github.com/nuxt/ui/commit/5b9d9d8135fe5b4c3f9298161dbd0c59c511897a))
+* **locale:** improve `id` name ([#4890](https://github.com/nuxt/ui/issues/4890)) ([e5cb55b](https://github.com/nuxt/ui/commit/e5cb55be7d5ac2690c95f05f56462b16d453670f))
+
 ## [3.3.3](https://github.com/nuxt/ui/compare/v3.3.2...v3.3.3) (2025-09-01)
 
 ### Features

diff --git a/README.md b/README.md
@@ -14,7 +14,7 @@
 Nuxt UI harnesses the combined strengths of [Reka UI](https://reka-ui.com/), [Tailwind CSS](https://tailwindcss.com/), and [Tailwind Variants](https://www.tailwind-variants.org/) to offer developers an unparalleled set of tools for creating sophisticated, accessible, and highly performant user interfaces.
 
 > [!NOTE]
-> You are on the `v3` development branch, check out the [v2 branch](https://github.com/nuxt/ui/tree/v2) for Nuxt UI v2.
+> You are on the `v3` branch, check out the [v4 branch](https://github.com/nuxt/ui/tree/v4) for Nuxt UI v4 or [v2 branch](https://github.com/nuxt/ui/tree/v2) for Nuxt UI v2.
 
 > [!TIP]
 > **Looking for more components ?**

diff --git a/docs/app/app.vue b/docs/app/app.vue
@@ -1,6 +1,7 @@
 <script setup lang="ts">
 import { withoutTrailingSlash } from 'ufo'
 import colors from 'tailwindcss/colors'
+import { Analytics } from '@vercel/analytics/nuxt'
 
 const route = useRoute()
 const appConfig = useAppConfig()
@@ -51,9 +52,10 @@ provide('navigation', mappedNavigation)
 <template>
   <UApp :toaster="appConfig.toaster">
     <NuxtLoadingIndicator color="var(--ui-primary)" :height="2" />
+    <Analytics />
 
     <template v-if="!route.path.startsWith('/examples')">
-      <Banner />
+      <!-- <Banner /> -->
 
       <Header :links="links" />
     </template>

diff --git a/docs/app/components/Footer.vue b/docs/app/components/Footer.vue
@@ -40,9 +40,9 @@ const links = [{
         size="sm"
       />
       <UButton
-        aria-label="Nuxt UI on Discord"
+        aria-label="Nuxt on Discord"
         icon="i-simple-icons-discord"
-        to="https://chat.nuxt.dev"
+        to="https://go.nuxt.com/discord"
         target="_blank"
         color="neutral"
         variant="ghost"
@@ -51,7 +51,7 @@ const links = [{
       <UButton
         aria-label="Nuxt on X"
         icon="i-simple-icons-x"
-        to="https://x.com/nuxt_js"
+        to="https://go.nuxt.com/x"
         target="_blank"
         color="neutral"
         variant="ghost"
@@ -60,7 +60,7 @@ const links = [{
       <UButton
         aria-label="Nuxt on BlueSky"
         icon="i-simple-icons-bluesky"
-        to="https://bsky.app/profile/nuxt.com"
+        to="https://go.nuxt.com/bluesky"
         target="_blank"
         color="neutral"
         variant="ghost"

diff --git a/docs/app/components/content/examples/avatar-group/AvatarGroupMaskExample.vue b/docs/app/components/content/examples/avatar-group/AvatarGroupMaskExample.vue
@@ -0,0 +1,30 @@
+<template>
+  <UAvatarGroup :ui="{ base: 'rounded-none squircle' }">
+    <UAvatar
+      src="https://github.com/benjamincanac.png"
+      alt="Benjamin Canac"
+      class="rounded-none squircle"
+    />
+
+    <UAvatar
+      src="https://github.com/romhml.png"
+      alt="Romain Hamel"
+      class="rounded-none squircle"
+    />
+
+    <UAvatar
+      src="https://github.com/noook.png"
+      alt="Neil Richter"
+      class="rounded-none squircle"
+    />
+  </UAvatarGroup>
+</template>
+
+<style>
+.squircle {
+  mask-image: url("data:image/svg+xml,%3csvg width='200' height='200' xmlns='http://www.w3.org/2000/svg'%3e%3cpath d='M100 0C20 0 0 20 0 100s20 100 100 100 100-20 100-100S180 0 100 0Z'/%3e%3c/svg%3e");
+  mask-size: contain;
+  mask-position: center;
+  mask-repeat: no-repeat;
+}
+</style>
diff --git a/docs/app/components/content/examples/avatar/AvatarMaskExample.vue b/docs/app/components/content/examples/avatar/AvatarMaskExample.vue
@@ -0,0 +1,12 @@
+<template>
+  <UAvatar class="rounded-none squircle" src="https://avatars.githubusercontent.com/u/739984?v=4" alt="Benjamin Canac" />
+</template>
+
+<style>
+.squircle {
+  mask-image: url("data:image/svg+xml,%3csvg width='200' height='200' xmlns='http://www.w3.org/2000/svg'%3e%3cpath d='M100 0C20 0 0 20 0 100s20 100 100 100 100-20 100-100S180 0 100 0Z'/%3e%3c/svg%3e");
+  mask-size: contain;
+  mask-position: center;
+  mask-repeat: no-repeat;
+}
+</style>
diff --git a/docs/app/error.vue b/docs/app/error.vue
@@ -59,7 +59,7 @@ provide('navigation', mappedNavigation)
   <UApp>
     <NuxtLoadingIndicator color="#FFF" />
 
-    <Banner />
+    <!-- <Banner /> -->
 
     <Header :links="links" />
 

diff --git a/docs/app/pages/figma/.figma.yml b/docs/app/pages/figma/.figma.yml
@@ -10,7 +10,7 @@ hero:
       to: 'https://nuxt.lemonsqueezy.com/buy/17213c49-621b-4c2c-9478-3a50a099003d'
       target: _blank
     - label: Free Figma Kit
-      to: 'https://go.nuxt.com/figma'
+      to: 'https://go.nuxt.com/figma-ui3'
       icon: i-logos-figma
       color: neutral
       variant: outline
@@ -28,9 +28,9 @@ features1:
       icon: i-lucide-files
 cta1:
   title: Everything you need in a [single file]{class="text-primary"}.
-  description: Design and development in perfect sync with our [Free](https://www.figma.com/community/file/1288455405058138934/nuxt-ui-v3-official-design-kit-free) and Pro files. Developers can implement designs faster, while designers work with production-ready components.
+  description: Design and development in perfect sync with our [Free](https://go.nuxt.com/figma-ui3) and Pro files. Developers can implement designs faster, while designers work with production-ready components.
 section1:
-  title: Customize in a few clicks to fit your needs
+  title: Customize in a few clicks to fit your needs
   description: Control your entire design system with Figma Variables. Update primitive tokens once and watch your changes spread across the entire system.
   reverse: true
   features:
@@ -53,7 +53,7 @@ section1:
       alt: Use color variables in the Nuxt UI Figma design kit
   links:
     - label: Preview UI Pro Design Kit
-      to: 'https://go.nuxt.com/figma-pro'
+      to: 'https://go.nuxt.com/figma-ui-pro3'
       target: _blank
       icon: i-logos-figma
       color: neutral
@@ -75,7 +75,7 @@ section2:
     alt: A component in the Nuxt UI Figma design kit
   links:
     - label: Preview UI Pro Design Kit
-      to: 'https://go.nuxt.com/figma-pro'
+      to: 'https://go.nuxt.com/figma-ui-pro3'
       target: _blank
       icon: i-logos-figma
       color: neutral
@@ -98,7 +98,7 @@ section3:
     alt: A screenshot of Nuxt UI Code & Figma Kit
   links:
     - label: Preview UI Pro Design Kit
-      to: 'https://go.nuxt.com/figma-pro'
+      to: 'https://go.nuxt.com/figma-ui-pro3'
       icon: i-logos-figma
       color: neutral
       variant: outline
@@ -121,7 +121,7 @@ section4:
     - label: Get access now
       to: 'https://nuxt.lemonsqueezy.com/buy/17213c49-621b-4c2c-9478-3a50a099003d'
     - label: Preview UI Pro Design Kit
-      to: 'https://go.nuxt.com/figma-pro'
+      to: 'https://go.nuxt.com/figma-ui-pro3'
       icon: i-logos-figma
       color: neutral
       variant: outline
@@ -172,7 +172,7 @@ pricing:
       button:
         label: Open in Figma
         icon: i-logos-figma
-        to: https://go.nuxt.com/figma
+        to: https://go.nuxt.com/figma-ui3
         color: neutral
       terms: Used by 17,000+ designers.
     - title: Solo License
@@ -194,7 +194,7 @@ pricing:
         to: https://nuxt.lemonsqueezy.com/buy/17213c49-621b-4c2c-9478-3a50a099003d
       extraButton:
         label: Preview in Figma
-        to: 'https://go.nuxt.com/figma-pro'
+        to: 'https://go.nuxt.com/figma-ui-pro3'
         target: _blank
         icon: i-logos-figma
     - title: Team License
@@ -216,7 +216,7 @@ pricing:
         to: https://nuxt.lemonsqueezy.com/buy/2979099c-b7a0-4ba1-90e0-a0d60509b92d
       extraButton:
         label: Preview in Figma
-        to: 'https://go.nuxt.com/figma-pro'
+        to: 'https://go.nuxt.com/figma-ui-pro3'
         target: _blank
         icon: i-logos-figma
 customers:
@@ -260,7 +260,7 @@ faq:
       content: Yes. You don't need Figma's paid plan to use our UI kits.
       defaultOpen: true
     - label: Do you have a free trial?
-      content: We don't offer a free trial for the Pro Figma Kit, you can [preview it](https://go.nuxt.com/figma-pro).
+      content: We don't offer a free trial for the Pro Figma Kit, you can [preview it](https://go.nuxt.com/figma-ui-pro3).
     - label: How do I access the files after purchasing?
       content: After purchasing, just extract the ZIP file and drag & drop it directly into Figma.
     - label: Can I upgrade my Solo license to the Team license?

diff --git a/docs/app/pages/pro/.content/pricing.yml b/docs/app/pages/pro/.content/pricing.yml
@@ -43,8 +43,8 @@ pricing:
       - 'Templates: Starter, Landing, Docs, SaaS and Dashboard'
       - Auto-layout & responsive ready
       - Tailwind CSS assets & icons included
-      - Free [preview available](https://www.figma.com/design/mxXR9binOSLU3rYKZZRPXs/PREVIEW---NuxtUIPro-V3-BETA?m=auto&t=c4598Wr0rZwKPs5M-1)
-      - Includes Nuxt UI [Figma Kit](https://www.figma.com/community/file/1288455405058138934)
+      - Free [preview available](https://go.nuxt.com/figma-ui-pro3)
+      - Includes Nuxt UI [Figma Kit](https://go.nuxt.com/figma-ui3)
     button:
       label: Buy Figma Kit
       to: 'https://nuxt.lemonsqueezy.com/buy/17213c49-621b-4c2c-9478-3a50a099003d'