StacDev · curogom · Oct 20, 2025 · Oct 20, 2025 · Oct 20, 2025 · Oct 20, 2025
diff --git a/README_ko.md b/README_ko.md
@@ -0,0 +1 @@
+packages/stac/README_ko.md
diff --git a/packages/stac/README_ko.md b/packages/stac/README_ko.md
@@ -0,0 +1,81 @@
+<p>
+  <img src="https://raw.githubusercontent.com/StacDev/stac/refs/heads/dev/assets/stac_banner.png" width="100%" alt="Stac: Server-Driven UI Framework for Flutter" />
+</p>
+
+<p align="center">
+  <a href="https://pub.dev/packages/stac"><img src="https://img.shields.io/pub/v/stac?label=pub.dev&labelColor=0F172A&logo=dart&logoColor=fff&color=0EA5E9&style=flat" alt="pub"></a>
+  <a href="https://github.com/StacDev/stac"><img src="https://img.shields.io/github/stars/StacDev/stac?style=flat&label=stars&labelColor=0F172A&color=8B5CF6&logo=github&logoColor=fff" alt="github"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-22C55E.svg?labelColor=0F172A&style=flat" alt="license"></a>
+  <a href="https://discord.com/invite/vTGsVRK86V"><img src="https://img.shields.io/discord/1326481685579173888?logo=discord&logoColor=fff&labelColor=0F172A&color=5865F2&style=flat" alt="discord"></a>
+  <a href="https://github.com/StacDev/stac"><img src="https://img.shields.io/github/contributors/StacDev/stac?logo=github&logoColor=fff&labelColor=0F172A&color=F59E0B&style=flat" alt="contributors"></a>
+  <a href="https://github.com/invertase/melos"><img src="https://img.shields.io/badge/maintained%20with-melos-F472B6.svg?labelColor=0F172A&style=flat" alt="melos"></a>
+</p>
+
+<p align="center">
+  <a href="https://stac.dev/">웹사이트</a> •
+  <a href="https://console.stac.dev/">콘솔</a> •
+  <a href="https://docs.stac.dev/quickstart">빠른 시작</a> •
+  <a href="https://docs.stac.dev/">문서</a> •
+  <a href="https://discord.com/invite/vTGsVRK86V">커뮤니티 & 지원</a> •
+  <a href="https://github.com/StacDev/stac">GitHub</a>
+</p>
+
+# Stac
+
+**Stac**은 **Flutter를 위한 Server-Driven UI (SDUI) 프레임워크**로, 앱을 재배포하지 않고도 동적 사용자 인터페이스를 구축, 업데이트 및 제공할 수 있습니다.
+Flutter에서 모든 위젯을 하드코딩하는 대신, JSON에서 런타임에 렌더링되는 **Stac Widgets**으로 UI를 정의합니다.
+
+이 접근 방식은 앱의 프레젠테이션 레이어와 비즈니스 로직을 분리하여 팀이 다음을 수행할 수 있도록 합니다:
+
+- **즉시 업데이트 배포.** StacWidgets를 업데이트하고 Stac Cloud에 푸시하기만 하면 됩니다.
+- **기능 실험** (A/B 테스팅, 개인화 등)을 새로운 릴리스 없이 수행할 수 있습니다.
+- 통합 스키마를 사용하여 **플랫폼 간 일관성 유지**가 가능합니다.
+- 디자이너나 PM과 같은 **비개발자도 레이아웃과 콘텐츠를 관리**할 수 있습니다.
+
+## 주요 기능
+
+- 🚀 즉시 업데이트: 앱 스토어 릴리스 없이 UI 배포
+- 🧩 JSON 기반 UI: JSON으로 위젯을 정의하고 네이티브로 렌더링
+- 📦 Dart에서 JSON으로: Dart로 Stac 위젯을 작성하고 Stac Cloud에 배포
+- 🎛 액션 & 내비게이션: 백엔드에서 라우트와 API 호출 제어
+- 📝 폼 & 검증: 내장된 폼 상태 및 검증 규칙
+- 🎨 테마: Stac Theme을 통한 JSON 기반 브랜드 및 레이아웃
+- 🔌 확장 가능: 커스텀 위젯, 액션 및 네이티브 통합 추가 가능
+
+## 문서
+
+- 📚 **[전체 문서](https://docs.stac.dev/)** – 완전한 가이드 및 API 레퍼런스
+- 🚀 **[빠른 시작](https://docs.stac.dev/quickstart)** – 몇 분 안에 시작하기
+- 🛠️ **[Stac CLI](https://docs.stac.dev/cli)** – 개발을 위한 커맨드라인 도구
+- 🎛️ **[Stac Console](https://console.stac.dev/)** – 앱 관리를 위한 웹 인터페이스
+- 🤝 **[기여하기](https://github.com/StacDev/stac/blob/dev/CONTRIBUTING.md)** – Stac 구축에 참여하기
+
+## 라이선스
+
+이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 [LICENSE](/LICENSE) 파일을 참조하세요.
+
+## 커뮤니티 참여
+
+- 💬 **[Discord](https://discord.com/invite/vTGsVRK86V)** – 커뮤니티와 채팅하고 도움 받기
+- 🐙 **[GitHub](https://github.com/StacDev/stac)** – 이슈 보고 및 기여
+- 🐦 **[X](https://x.com/stac_dev)** – 업데이트 팔로우
+
+---
+
+<p align="center">Stac 팀과 멋진 커뮤니티가 💙로 개발했습니다</p>
+
+<p align="center">
+<a href="https://github.com/StacDev/stac/graphs/contributors">
+  <img src="https://raw.githubusercontent.com/StacDev/stac/refs/heads/dev/assets/contributor_banner.png" alt="Stac Contributors"/>
+</a>
+</p>
+
+[github_stars]: https://img.shields.io/github/stars/StacDev/stac
+[github_stars_link]: https://github.com/StacDev/stac/stargazers
+[license_badge]: https://img.shields.io/badge/license-MIT-blue.png
+[license_link]: https://opensource.org/licenses/MIT
+[stac_banner]: https://raw.githubusercontent.com/StacDev/stac/refs/heads/dev/assets/stac_banner.png
+[form_screen]: https://raw.githubusercontent.com/StacDev/stac/refs/heads/dev/assets/form_screen_image.png
+[divyanshu_github]: https://github.com/divyanshub024
+[rahul_linkedin]: https://www.linkedin.com/in/bybisht
+[stac_website]: https://stac.dev/
diff --git a/website/docs/actions/dialog..md → website/docs/actions/dialog.md b/website/docs/actions/dialog..md → website/docs/actions/dialog.md
diff --git a/website/docs/widgets/gesture_detector.md b/website/docs/widgets/gesture_detector.md
@@ -205,4 +205,4 @@ To use a GestureDetector in your Stac JSON, specify the widget type as "gestureD
 
 Each gesture callback in Stac GestureDetector accepts an action object that defines what should happen when the gesture is detected. This can be a navigation action, showing a dialog, executing a custom function, or any other action supported by your Stac application.
 
-For more information on actions, see the [Actions documentation](../actions/overview.md).
+For more information on actions, see the [Actions documentation](../actions/).
diff --git a/website/docusaurus.config.ts b/website/docusaurus.config.ts
@@ -28,7 +28,17 @@ const config: Config = {
   // may want to replace "en" with "zh-Hans".
   i18n: {
     defaultLocale: 'en',
-    locales: ['en'],
+    locales: ['en', 'ko'],
+    localeConfigs: {
+      en: {
+        label: 'English',
+        direction: 'ltr',
+      },
+      ko: {
+        label: '한국어',
+        direction: 'ltr',
+      },
+    },
   },
 
   presets: [
@@ -84,6 +94,10 @@ const config: Config = {
           label: 'GitHub',
           position: 'right',
         },
+        {
+          type: 'localeDropdown',
+          position: 'right',
+        },
       ],
     },
     footer: {

diff --git a/website/i18n/TRANSLATION_GUIDE.md b/website/i18n/TRANSLATION_GUIDE.md
@@ -0,0 +1,132 @@
+# Stac Documentation Translation Guide (Korean)
+
+## Translation Principles
+
+1. **Technical Accuracy**: Maintain technical precision in all translations
+2. **Consistency**: Use the same Korean terms for the same English concepts
+3. **Natural Korean**: Write in natural, fluent Korean while preserving technical meaning
+4. **Code Preservation**: Keep all code examples, JSON, and syntax unchanged
+
+## Terminology Glossary
+
+### Core Concepts
+- **Widget** → **위젯** (keep as-is, commonly used in Korean dev community)
+- **Action** → **액션** (keep as-is)
+- **Parser** → **파서** (keep as-is)
+- **Server-Driven UI** → **서버 주도 UI** or **SDUI** (use SDUI for brevity)
+- **Framework** → **프레임워크**
+- **Package** → **패키지**
+- **Playground** → **플레이그라운드**
+
+### UI Components
+- **Button** → **버튼**
+- **Container** → **컨테이너**
+- **Text** → **텍스트**
+- **Image** → **이미지**
+- **Icon** → **아이콘**
+- **Dialog** → **다이얼로그**
+- **Modal** → **모달**
+- **Snackbar** → **스낵바**
+- **App Bar** → **앱 바**
+- **Navigation** → **내비게이션**
+- **Drawer** → **드로어**
+- **Scaffold** → **스캐폴드**
+- **Column** → **칼럼**
+- **Row** → **로우**
+- **Stack** → **스택**
+- **Grid** → **그리드**
+- **List** → **리스트**
+
+### Actions & Events
+- **Navigate** → **이동** or **내비게이트**
+- **Network Request** → **네트워크 요청**
+- **Form Validation** → **폼 검증**
+- **Delay** → **지연**
+- **Multi Action** → **멀티 액션**
+- **Tap** → **탭** or **터치**
+- **Click** → **클릭**
+- **Swipe** → **스와이프**
+
+### Styles & Properties
+- **Border** → **테두리**
+- **Radius** → **반경**
+- **Padding** → **패딩**
+- **Margin** → **마진**
+- **Alignment** → **정렬**
+- **Color** → **색상**
+- **Opacity** → **불투명도**
+- **Clip** → **클립**
+
+### Development Terms
+- **Property** → **속성**
+- **Parameter** → **매개변수** or **파라미터**
+- **Attribute** → **속성**
+- **Value** → **값**
+- **Type** → **타입** or **유형**
+- **String** → **문자열**
+- **Boolean** → **불린** or **불리언**
+- **Integer** → **정수**
+- **Double** → **실수**
+- **Object** → **객체**
+- **Array** → **배열**
+- **Null** → **null** (keep as-is)
+- **Optional** → **선택 사항** or **옵션**
+- **Required** → **필수**
+- **Default** → **기본값**
+
+### Actions
+- **Install** → **설치하다**
+- **Import** → **가져오다** or **임포트하다**
+- **Add** → **추가하다**
+- **Remove** → **제거하다**
+- **Update** → **업데이트하다**
+- **Build** → **빌드하다**
+- **Run** → **실행하다**
+- **Deploy** → **배포하다**
+
+### Common Phrases
+- **Get Started** → **시작하기**
+- **Learn more** → **자세히 알아보기**
+- **Note** → **참고**
+- **Warning** → **경고**
+- **Example** → **예제**
+- **Usage** → **사용법**
+- **Description** → **설명**
+- **See also** → **참고**
+
+## Style Guidelines
+
+### Tone
+- Use **반말 (informal)** style for consistency with most Korean tech documentation
+- Example: "이 위젯은..." not "이 위젯은...입니다"
+- Exception: Use formal tone for warnings, notes, and important notices
+
+### Sentence Structure
+- Prefer active voice
+- Keep sentences concise and clear
+- Break long sentences into shorter ones for readability
+
+### Code Comments
+- Translate comments in code examples to Korean
+- Keep variable names and function names in English
+- Translate string values when they represent user-facing text
+
+### Links and URLs
+- Keep all URLs unchanged
+- Translate link text to Korean
+
+### Markdown Formatting
+- Preserve all markdown formatting (headers, lists, code blocks, etc.)
+- Keep admonitions (:::note, :::warning, etc.) in English
+- Translate the content inside admonitions
+
+## Quality Checklist
+
+Before submitting translation:
+- [ ] All technical terms use consistent Korean translations
+- [ ] Code examples are unchanged
+- [ ] Links work correctly
+- [ ] Markdown formatting is preserved
+- [ ] No English sentences remain (except in code/URLs)
+- [ ] Natural Korean flow and readability
+- [ ] Technical accuracy verified
Original file line number	Diff line number	Diff line change
Expand Up		@@ -205,4 +205,4 @@ To use a GestureDetector in your Stac JSON, specify the widget type as "gestureD

		Each gesture callback in Stac GestureDetector accepts an action object that defines what should happen when the gesture is detected. This can be a navigation action, showing a dialog, executing a custom function, or any other action supported by your Stac application.

		For more information on actions, see the [Actions documentation](../actions/overview.md).
		For more information on actions, see the [Actions documentation](../actions/).