diff --git a/README.md b/README.md
index 73d2fca..5ac33fd 100644
--- a/README.md
+++ b/README.md
@@ -26,6 +26,20 @@ pnpm check
 `pnpm check`는 source와 build output 모두에서 런타임 JavaScript가 없는지 검사한다.
 `scripts/no-js-lint.mjs`는 `<script>` 태그와 inline event handler를 모두 실패로 처리한다.
 
+## Vercel 배포
+- 배포 설정: `vercel.json`
+- framework: Vite
+- build command: `pnpm build`
+- output directory: `dist`
+- production deploy: Vercel CLI 로그인 또는 `VERCEL_TOKEN` 설정 후 `npx vercel --prod --yes`
+
+현재 저장소는 Vercel 정적 배포 설정까지 준비되어 있다. 이 Codex 실행 환경에서는 Vercel CLI/커넥터 인증이 확인되지 않아 production URL 발급은 인증 후 진행한다.
+
+## 최근 업데이트
+- 밝은 톤 네이티브 HTML UI kit 디자인 시스템을 정리했다.
+- details, dialog, popover, form 상태를 JavaScript 없이 보여주는 컴포넌트 예시를 확장했다.
+- 중앙 maintainer bot은 네이티브 HTML 컴포넌트 맥락과 최근 PR 이력을 기준으로 독립적인 개선 후보를 찾는다.
+
 ## 자가 개선
 이 저장소에는 자가 개선 엔진을 두지 않는다. 중앙 control plane인 `okorion/self-improving-maintainer-bot`이 `profiles/overtura/native-html-ui-kit.json` profile로 이 저장소를 target repo로 다룬다.
 
diff --git a/vercel.json b/vercel.json
new file mode 100644
index 0000000..6739215
--- /dev/null
+++ b/vercel.json
@@ -0,0 +1,6 @@
+{
+  "framework": "vite",
+  "installCommand": "pnpm install --frozen-lockfile || pnpm install",
+  "buildCommand": "pnpm build",
+  "outputDirectory": "dist"
+}