diff --git a/README.md b/README.md
index f4b2120..da3101d 100644
--- a/README.md
+++ b/README.md
@@ -26,6 +26,20 @@ pnpm check
 
 `pnpm check`는 `pnpm lint`, `pnpm build`, `pnpm no-js:dist`를 순서대로 실행해 source와 build output 모두에서 런타임 JavaScript가 없는지 검사한다.
 
+## 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 발급은 인증 후 진행한다.
+
+## 최근 업데이트
+- 밝은 톤 스크롤 오디세이 디자인 시스템과 scroll-snap 장면 표현을 정리했다.
+- CSS-only 스크롤 챕터, 진행감, fallback 설명을 작은 PR 단위로 개선했다.
+- 중앙 maintainer bot은 스크롤 장면 전환 맥락과 최근 PR 이력을 기준으로 독립적인 개선 후보를 찾는다.
+
 ## 자가 개선
 이 저장소에는 자가 개선 엔진을 두지 않는다. 중앙 control plane인 `okorion/self-improving-maintainer-bot`이 `profiles/overtura/css-scroll-odyssey.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"
+}