diff --git a/changelog/ui/0.3.17.md b/changelog/ui/0.3.17.md
new file mode 100644
index 000000000..3870063f4
--- /dev/null
+++ b/changelog/ui/0.3.17.md
@@ -0,0 +1,19 @@
+---
+package: "@webjsdev/ui"
+version: 0.3.17
+date: 2026-10-07T11:13:32.305Z
+commit_count: 1
+---
+## Features
+
+- **add empty, spinner and field components** ([#1571](https://github.com/webjsdev/webjs/pull/1571)) [`128fadbb`](https://github.com/webjsdev/webjs/commit/128fadbb)
+  Three new Tier-1 components with shadcn parity. `empty` is the empty state
+  for a list or region (`emptyClass`, `emptyHeaderClass`,
+  `emptyMediaClass({ variant })`, `emptyTitleClass`, `emptyDescriptionClass`,
+  `emptyContentClass`). `spinner` is a busy indicator (`spinnerClass` plus
+  `spinner({ class, label, decorative })`, an inline SVG with `role="status"`).
+  `field` is the form-field layout system (`fieldSetClass`, `fieldLegendClass`,
+  `fieldGroupClass`, `fieldClass({ orientation })`, `fieldContentClass`,
+  `fieldLabelClass`, `fieldTitleClass`, `fieldDescriptionClass`,
+  `fieldErrorClass`, `fieldSeparatorClass`, `fieldSeparatorContentClass`). Add
+  them with `webjs ui add empty spinner field`.
diff --git a/package-lock.json b/package-lock.json
index acfb49666..23311987d 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -7086,7 +7086,7 @@
     },
     "packages/ui": {
       "name": "@webjsdev/ui",
-      "version": "0.3.16",
+      "version": "0.3.17",
       "license": "MIT",
       "dependencies": {
         "commander": "^14.0.0",
diff --git a/packages/ui/package.json b/packages/ui/package.json
index 34525ecd4..cb26f5f49 100644
--- a/packages/ui/package.json
+++ b/packages/ui/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@webjsdev/ui",
-  "version": "0.3.16",
+  "version": "0.3.17",
   "type": "module",
   "description": "The AI-first component library for WebJs, a full-stack JavaScript framework built on web components with server-side rendering and no build step. Class-helper functions for visuals, custom elements only where state matters, source-copied into your repo so you own it.",
   "bin": {