feat: Add Korean (ko) localization support

README_ko.md

@@ -0,0 +1 @@
+packages/stac/README_ko.md

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/

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: {

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