@intlayer/docs 8.11.2 → 8.11.3

package/docs/ko/interest_of_intlayer.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2024-08-14
-updatedAt: 2025-09-27
+updatedAt: 2026-05-31
 title: Intlayer의 장점
-description: 프로젝트에서 Intlayer를 사용할 때의 이점과 장점을 알아보세요. Intlayer가 다른 프레임워크와 차별화되는 이유를 이해해 보세요.
+description: 프로젝트에서 Intlayer를 사용할 때의 이점과 장점을 알아보세요. 다른 프레임워크 중에서 Intlayer가 왜 뛰어난지 이해해보세요.
 keywords:
   - 이점
   - 장점
@@ -13,28 +13,78 @@ slugs:
   - doc
   - why
 history:
+  - version: 8.11.2
+    date: 2026-05-31
+    changes: "다른 대안 대신 Intlayer인 이유 섹션 추가"
   - version: 7.3.1
     date: 2025-11-27
-    changes: "컴파일러 릴리스"
+    changes: "컴파일러 출시"
   - version: 5.8.0
     date: 2025-08-19
-    changes: "비교 표 업데이트"
+    changes: "비교표 업데이트"
   - version: 5.5.10
     date: 2025-06-29
-    changes: "초기 기록"
+    changes: "기록 초기화"
 ---
 
-# 왜 Intlayer를 고려해야 하나요?
+# 왜 Intlayer를 고려해야 할까요?
 
 ## Intlayer란 무엇인가요?
 
-**Intlayer**는 JavaScript 개발자를 위해 특별히 설계된 국제화 라이브러리입니다. 코드의 모든 곳에서 콘텐츠를 선언할 수 있게 해줍니다. 다국어 콘텐츠 선언을 구조화된 사전으로 변환하여 코드에 쉽게 통합할 수 있도록 합니다. TypeScript를 사용하여 **Intlayer**는 개발을 더 강력하고 효율적으로 만듭니다.
+**Intlayer**는 JavaScript 개발자를 위해 특별히 설계된 국제화(i18n) 라이브러리입니다. 코드 내 어디에서나 콘텐츠를 선언할 수 있도록 해줍니다. 다국어 콘텐츠 선언을 구조화된 사전(dictionaries)으로 변환하여 코드에 쉽게 통합할 수 있게 돕습니다. TypeScript를 활용함으로써, **Intlayer**는 개발 프로세스를 더욱 강력하고 효율적으로 만들어 줍니다.
 
-## Intlayer는 왜 만들어졌나요?
+## 왜 다른 대안 대신 Intlayer인가요?
 
-Intlayer는 `next-intl`, `react-i18next`, `react-intl`, `next-i18next`, `react-intl`, 그리고 `vue-i18n`과 같은 모든 일반적인 i18n 라이브러리에 영향을 미치는 공통적인 문제를 해결하기 위해 만들어졌습니다.
+`next-intl`이나 `i18next`와 같은 주요 솔루션과 비교할 때, Intlayer는 다음과 같은 통합된 최적화를 제공합니다:
 
-이 모든 솔루션은 콘텐츠를 나열하고 관리하기 위해 중앙 집중식 접근 방식을 채택합니다. 예를 들어:
+<AccordionGroup>
+<Accordion header="번들 크기">
+
+페이지에 대용량 JSON 파일을 로드하는 대신, 꼭 필요한 콘텐츠만 로드합니다. Intlayer는 **번들 및 페이지 크기를 최대 50%까지 줄이는 데** 기여합니다.
+
+</Accordion>
+<Accordion header="유지보수성">
+
+애플리케이션 콘텐츠의 범위를 컴포넌트 단위로 분할하여 **대규모 애플리케이션의 유지보수를 원활하게** 합니다. 전체 콘텐츠 코드베이스를 전부 검토해야 하는 인지적 부담 없이 단일 기능 폴더를 간편하게 복제하거나 삭제할 수 있습니다. 또한, Intlayer는 **완전한 타입 지원**을 통해 콘텐츠 선언의 정확성을 보장합니다.
+
+</Accordion>
+<Accordion header="AI 에이전트">
+
+콘텐츠 선언을 컴포넌트와 동일한 위치에 두는 것(Co-location)은 대형 언어 모델(LLM)에 필요한 **콘텍스트 크기를 크게 줄여줍니다**. Intlayer는 번역 누락을 테스트하기 위한 **CLI**, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/mcp_server.md)** 및 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/agent_skills.md)** 등 일련의 도구를 지원하여 AI 에이전트를 위한 개발자 경험(DX)을 더욱 매끄럽게 만듭니다.
+
+</Accordion>
+<Accordion header="기능성">
+
+Intlayer는 다른 i18n 솔루션에는 없는 [Markdown 지원](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/markdown.md), [외부 콘텐츠 가져오기](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/function_fetching.md), [파일 콘텐츠 로드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/file.md), [실시간 콘텐츠 업데이트](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/live.md), [비주얼 에디터](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md) 등 폭넓은 추가 기능을 제공합니다.
+
+</Accordion>
+<Accordion header="자동화">
+
+CI/CD 파이프라인에서 원하는 LLM을 사용하여 AI 제공업체의 직접 비용 수준으로 손쉽게 자동 번역을 적용할 수 있습니다. Intlayer는 콘텐츠 추출을 자동화하는 **컴파일러**와 함께 **백그라운드에서 편리하게 번역할 수 있는** [웹 플랫폼](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)도 제공합니다.
+
+</Accordion>
+<Accordion header="성능">
+
+대규모 JSON 파일을 컴포넌트에 직접 연결하는 작업은 성능 저하와 반응성 문제를 초래할 수 있습니다. Intlayer는 빌드 시점에 콘텐츠 로드를 최적화하여 이를 해결합니다.
+
+</Accordion>
+<Accordion header="비개발 팀과의 협업 확장">
+
+단순한 i18n 솔루션 이상의 가치를 제공하기 위해, Intlayer는 직접 호스팅 가능한 **[비주얼 에디터](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)**와 **[전체 기능을 제공하는 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)**를 지원합니다. 이를 통해 번역가, 카피라이터 및 기타 협업 부서와 **실시간**으로 다국어 콘텐츠를 매끄럽게 관리할 수 있습니다. 콘텐츠는 로컬 또는 원격으로 유연하게 저장될 수 있습니다.
+
+</Accordion>
+<Accordion header="크로스 프레임워크 디자인">
+
+애플리케이션의 여러 영역에서 서로 다른 프레임워크를 사용하고 있는 경우(예: React, React-native, Vue, Angular, Svelte 등), Intlayer는 **모든 주요 프론트엔드 프레임워크에서 범용 구문과 구현을 사용하는 방법**을 제공합니다. 디자인 시스템, 모바일 앱, 백엔드 서비스 전반에 걸쳐 콘텐츠 선언을 손쉽게 공유할 수 있습니다.
+
+</Accordion>
+</AccordionGroup>
+
+## 왜 Intlayer가 만들어졌나요?
+
+Intlayer는 `next-intl`, `react-i18next`, `react-intl`, `next-i18next`, `react-intl` 및 `vue-i18n` 등 기존의 모든 대중적인 i18n 라이브러리들이 공유하고 있는 구조적 고충을 해결하기 위해 개발되었습니다.
+
+이러한 솔루션들은 모두 하나의 중앙 공간에서 다국어 콘텐츠를 나열하고 관리하는 방식을 채택하고 있습니다. 예를 들면 다음과 같습니다:
 
 ```bash
 .
@@ -49,7 +99,7 @@ Intlayer는 `next-intl`, `react-i18next`, `react-intl`, `next-i18next`, `react-i
             └── index.tsx
 ```
 
-또는 네임스페이스를 사용하는 경우:
+또는 아래와 같이 네임스페이스(namespaces)를 구성하기도 합니다:
 
 ```bash
 .
@@ -70,23 +120,23 @@ Intlayer는 `next-intl`, `react-i18next`, `react-intl`, `next-i18next`, `react-i
             └── index.tsx
 ```
 
-이러한 유형의 아키텍처는 개발 프로세스를 늦추고 다음과 같은 여러 이유로 코드베이스를 유지 관리하기 복잡하게 만듭니다.
+이와 같은 설계 방식은 아래와 같은 여러 요인으로 인해 개발 속도를 저하시키고 유지보수를 복잡하게 만듭니다:
 
-1. **새로운 컴포넌트를 생성할 때마다 다음을 수행해야 합니다.**
-   - `locales` 폴더에 새로운 리소스/네임스페이스 생성
-   - 페이지에서 새로운 네임스페이스를 가져오는 것을 잊지 않기
-   - 콘텐츠 번역(종종 AI 제공업체로부터 복사/붙여넣기를 통해 수동으로 수행됨)
+1. **새로운 컴포넌트를 생성할 때마다 개발자가 매번 수행해야 할 작업:**
+   - `locales` 폴더에 새로운 리소스/네임스페이스 파일 생성
+   - 해당 네임스페이스를 페이지나 컴포넌트에 직접 임포트
+   - 수동으로 콘텐츠 번역 적용 (대개 번역기나 AI 도구에서 수작업으로 복사/붙여넣기)
 
-2. **컴포넌트를 변경할 때마다 다음을 수행해야 합니다.**
-   - 관련 리소스/네임스페이스 검색(컴포넌트에서 멀리 떨어져 있음)
-   - 콘텐츠 번역
-   - 모든 로케일에 대해 콘텐츠가 최신 상태인지 확인
-   - 네임스페이스에 사용되지 않는 키/값이 포함되어 있지 않은지 확인
-   - 모든 로케일에 대해 JSON 파일 구조가 동일한지 확인
+2. **기존 컴포넌트에 사소한 수정을 가할 때마다 수행해야 할 작업:**
+   - 컴포넌트 파일과 멀리 떨어진 해당 리소스/네임스페이스 파일을 탐색
+   - 수정 사항 번역
+   - 모든 지원 언어에 변경 사항이 일관되게 최신 상태인지 수동 검증
+   - 네임스페이스 파일 내에 사용하지 않는 키/값이 방치되어 있는지 확인
+   - 모든 언어별 JSON 파일의 구조가 서로 완벽히 대칭을 이루고 있는지 체크
 
-이러한 솔루션을 사용하는 전문 프로젝트에서는 콘텐츠 번역 관리를 돕기 위해 종종 로컬라이제이션 플랫폼이 사용됩니다. 그러나 대규모 프로젝트의 경우 이는 빠르게 비용이 많이 들 수 있습니다.
+전문적인 프로덕션 환경에서는 이러한 솔루션의 한계를 보완하기 위해 대개 유료 로컬라이제이션 플랫폼을 연동하곤 합니다. 그러나 이는 대규모 프로젝트에서 장기적으로 상당한 비용 부담이 될 수 있습니다.
 
-이 문제를 해결하기 위해 Intlayer는 콘텐츠를 컴포넌트별로 범위를 지정하고, 우리가 종종 CSS(`styled-components`), 타입, 문서(`storybook`), 또는 유닛 테스트(`jest`)에서 하듯이 콘텐츠를 컴포넌트 근처에 유지하는 접근 방식을 채택합니다.
+이를 명쾌하게 해결하기 위해, Intlayer는 스타일시트(`styled-components`), 타입 선언, 문서화(`storybook`) 또는 단위 테스트(`jest`)가 지향하는 것처럼 **각 컴포넌트 내에 관련 다국어 콘텐츠 선언을 귀속시키고 컴포넌트 파일 바로 옆에 배치**하는 컴포넌트별 스코프 중심의 접근 방식을 채택합니다.
 
 ```bash codeFormat="typescript"
 .
@@ -145,84 +195,82 @@ export const ComponentExample = () => {
 };
 ```
 
-이 접근 방식은 다음과 같은 이점을 제공합니다.
+이러한 방식을 적용하면 다음과 같은 혁신적인 효과를 얻을 수 있습니다:
 
-1. **개발 속도 향상**
-   - VSCode 확장 프로그램을 사용하여 `.content.{{ts|mjs|cjs|json}}` 파일을 생성할 수 있습니다.
-   - IDE의 자동 완성 AI 도구(예: GitHub Copilot)가 콘텐츠 선언을 도와 복사/붙여넣기를 줄여줍니다.
+1. **개발 생산성의 대폭 향상**
+   - `.content.{{ts|mjs|cjs|json}}` 파일 선언을 돕는 VSCode 공식 확장 프로그램 지원
+   - IDE의 AI 자동완성 도구(예: GitHub Copilot)가 문맥을 정확히 파악하여 콘텐츠 선언을 도와 복사/붙여넣기 수작업이 극적으로 축소됨
 
-2. **코드베이스 정리**
-   - 복잡성 감소
-   - 유지 관리 용이성 향상
+2. **청결한 코드베이스 유지**
+   - 개발 복잡성을 최소화
+   - 구조 유지보수성을 극대화
 
-3. **컴포넌트 및 관련 콘텐츠를 더 쉽게 복제(예: 로그인/가입 컴포넌트 등)**
-   - 다른 컴포넌트의 콘텐츠에 영향을 줄 위험 제한
-   - 외부 종속성 없이 한 애플리케이션에서 다른 애플리케이션으로 콘텐츠를 복사/붙여넣기
+3. **컴포넌트 및 관련 다국어 콘텐츠 복제의 편리성 (예: 로그인/회원가입 기능 모듈 복사 등)**
+   - 다른 컴포넌트나 글로벌 리소스와의 충돌 위험 배제
+   - 외부 의존성 걱정 없이, 개발된 개별 컴포넌트 단위를 손쉽게 복사/붙여넣기하여 다른 애플리케이션으로 마이그레이션 가능
 
-4. **사용되지 않는 컴포넌트에 대해 사용되지 않는 키/값으로 코드베이스가 오염되는 것을 방지**
-   - 컴포넌트를 사용하지 않으면 Intlayer는 관련 콘텐츠를 가져오지 않습니다.
-   - 컴포넌트를 삭제하면 같은 폴더에 있으므로 관련 콘텐츠를 삭제하는 것을 더 쉽게 기억할 수 있습니다.
+4. **더 이상 사용하지 않는 컴포넌트의 유령 키/값 잔존 원천 차단**
+   - 해당 컴포넌트를 임포트하지 않으면 관련 리소스가 앱 빌드 번들에 전혀 로드되지 않음
+   - 컴포넌트를 삭제할 때 동일 폴더 내의 콘텐츠 정의가 같이 정리되어 쓰레기 코드가 방치되지 않음
 
-5. **AI 에이전트가 다국어 콘텐츠를 선언하기 위한 추론 비용 감소**
-   - AI 에이전트는 콘텐츠를 구현할 위치를 알기 위해 전체 코드베이스를 스캔할 필요가 없습니다.
-   - IDE의 자동 완성 AI 도구(예: GitHub Copilot)를 통해 번역을 쉽게 수행할 수 있습니다.
+5. **AI 에이전트의 다국어 콘텐츠 구현을 위한 추론(Reasoning) 비용 극대화 축소**
+   - AI 개발 에이전트가 코드를 이식하거나 수정하기 위해 코드베이스 전체를 불필요하게 검토하지 않아도 됨
+   - IDE 내 AI 보조 도구들이 컴포넌트의 문맥을 토대로 손쉽게 다국어 선언 및 자동 번역을 제안함
 
-6. **로드 성능 최적화**
-   - 컴포넌트가 지연 로드(lazy-load)되는 경우 관련 콘텐츠도 동시에 로드됩니다.
+6. **로딩 성능 최적화**
+   - 컴포넌트가 지연 로딩(lazy-loading)되면 해당 컴포넌트에 매핑된 다국어 사전 콘텐츠도 완벽히 동기화되어 필요한 시점에 함께 지연 로드됨
 
 ## Intlayer의 추가 기능
 
-| 기능                                                                                                                      | 설명                                                                                                                                                                                                                                                                                                                                                                        |
-| ------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| ![기능](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true)                             | **교차 프레임워크 지원**<br><br>Intlayer는 Next.js, React, Vite, Vue.js, Nuxt, Preact, Express 등을 포함한 모든 주요 프레임워크 및 라이브러리와 호환됩니다.                                                                                                                                                                                                                 |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true)       | **JavaScript 기반 콘텐츠 관리**<br><br>JavaScript의 유연성을 활용하여 콘텐츠를 효율적으로 정의하고 관리하세요. <br><br> - [콘텐츠 선언](https://intlayer.org/doc/concept/content)                                                                                                                                                                                           |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="기능" width="700">     | **컴파일러**<br><br>Intlayer 컴파일러는 컴포넌트에서 콘텐츠를 자동으로 추출하고 사전 파일을 생성합니다.<br><br> - [컴파일러](https://intlayer.org/doc/compiler)                                                                                                                                                                                                             |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true) | **로케일별 콘텐츠 선언 파일**<br><br>자동 생성 전 콘텐츠를 한 번 선언하여 개발 속도를 높이세요.<br><br> - [로케일별 콘텐츠 선언 파일](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                                     |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)                      | **타입 안전 환경**<br><br>TypeScript를 활용하여 콘텐츠 정의와 코드가 오류가 없는지 확인하고 IDE 자동 완성의 이점을 누리세요.<br><br> - [TypeScript 구성](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                          |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true)                         | **간소화된 설정**<br><br>최소한의 구성으로 신속하게 시작하고 실행하세요. 국제화, 라우팅, AI, 빌드 및 콘텐츠 처리 설정을 쉽게 조정하세요. <br><br> - [Next.js 통합 알아보기](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                    |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true)                   | **간소화된 콘텐츠 검색**<br><br>각 콘텐츠 항목에 대해 `t` 함수를 호출할 필요가 없습니다. 단일 후크를 사용하여 모든 콘텐츠를 직접 검색하세요.<br><br> - [React 통합](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                                  |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true)                    | **일관된 서버 컴포넌트 구현**<br><br>Next.js 서버 컴포넌트에 완벽하게 적합하며, 클라이언트 및 서버 컴포넌트 모두에 동일한 구현을 사용하므로 각 서버 컴포넌트에 `t` 함수를 전달할 필요가 없습니다. <br><br> - [서버 컴포넌트](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                                               |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true)                           | **정리된 코드베이스**<br><br>코드베이스를 더 체계적으로 유지하세요: 1 컴포넌트 = 동일한 폴더 내 1 사전. 각 컴포넌트와 가까운 번역은 유지 관리성과 명확성을 향상시킵니다. <br><br> - [Intlayer 작동 방식](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                               |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true)                         | **향상된 라우팅**<br><br>앱 라우팅을 완벽하게 지원하여 Next.js, React, Vite, Vue.js 등의 복잡한 애플리케이션 구조에 원활하게 적응합니다.<br><br> - [Next.js 통합 알아보기](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                     |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true)                            | **Markdown 지원**<br><br>개인정보 보호정책, 문서 등과 같은 다국어 콘텐츠를 위해 로케일 파일 및 원격 Markdown을 가져오고 해석합니다. Markdown 메타데이터를 해석하고 코드에서 액세스할 수 있도록 합니다.<br><br> - [콘텐츠 파일](https://intlayer.org/doc/concept/content/file)                                                                                               |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true)                       | **무료 비주얼 에디터 및 CMS**<br><br>콘텐츠 작성자를 위해 무료 비주얼 에디터와 CMS가 제공되므로 로컬라이제이션 플랫폼이 필요하지 않습니다. Git을 사용하여 콘텐츠를 동기화하거나 CMS를 사용하여 전체 또는 일부를 외부화하세요.<br><br> - [Intlayer 에디터](https://intlayer.org/doc/concept/editor) <br> - [Intlayer CMS](https://intlayer.org/doc/concept/cms)              |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true)                              | **Tree-shakable 콘텐츠**<br><br>최종 번들 크기를 줄여주는 Tree-shakable 콘텐츠입니다. 컴포넌트당 콘텐츠를 로드하여 번들에서 사용되지 않는 콘텐츠를 제외합니다. 앱 로딩 효율성을 높이기 위해 지연 로드를 지원합니다. <br><br> - [앱 빌드 최적화](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)                                                 |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true)                    | **정적 렌더링**<br><br>정적 렌더링을 차단하지 않습니다. <br><br> - [Next.js 통합](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                              |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true)                      | **AI 기반 번역**<br><br>자체 AI 제공업체/API 키를 사용하여 Intlayer의 고급 AI 기반 번역 도구로 단 한 번의 클릭으로 웹사이트를 231개 언어로 변환하세요. <br><br> - [CI/CD 통합](https://intlayer.org/doc/concept/ci-cd) <br> - [Intlayer CLI](https://intlayer.org/doc/concept/cli) <br> - [자동 채우기](https://intlayer.org/doc/concept/auto-fill)                         |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true)                                 | **MCP 서버 통합**<br><br>IDE 자동화를 위한 MCP(Model Context Protocol) 서버를 제공하여 개발 환경 내에서 원활한 콘텐츠 관리 및 i18n 워크플로우를 가능하게 합니다. <br><br> - [MCP 서버](https://github.com/aymericzip/intlayer/blob/main/docs/ko/mcp_server.md)                                                                                                              |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true)                    | **VSCode 확장 프로그램**<br><br>Intlayer는 콘텐츠 및 번역 관리, 사전 구축, 콘텐츠 번역 등을 돕는 VSCode 확장 프로그램을 제공합니다. <br><br> - [VSCode 확장 프로그램](https://intlayer.org/doc/vs-code-extension)                                                                                                                                                           |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true)                    | **상호 운용성**<br><br>react-i18next, next-i18next, next-intl 및 react-intl과의 상호 운용성을 지원합니다. <br><br> - [Intlayer 및 react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer 및 next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer 및 next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next) |
-| 누락된 번역 테스트 (CLI/CI)                                                                                               | ✅ CLI: npx intlayer content test (CI 친화적 감사)                                                                                                                                                                                                                                                                                                                          |
+| 기능                                                                                                                      | 설명                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true)                          | **크로스 프레임워크 범용 지원**<br><br>Intlayer는 Next.js, React, Vite, Vue.js, Nuxt, Preact, Express 등 다양한 대중적인 프레임워크 및 라이브러리와 완벽하게 호환됩니다.                                                                                                                                                                                                                                                 |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true)       | **JavaScript 구문 기반의 동적 콘텐츠 관리**<br><br>JavaScript/TypeScript의 높은 유연성을 활용하여 복잡하고 세련된 콘텐츠 구조를 효율적으로 구성할 수 있습니다. <br><br> - [콘텐츠 선언 가이드](https://intlayer.org/doc/concept/content)                                                                                                                                                                                 |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="Feature" width="700">  | **지능형 컴파일러**<br><br>Intlayer 컴파일러는 프로젝트 소스 코드에서 다국어 콘텐츠를 자동으로 분석 및 추출하여 최적화된 사전 파일을 빌드합니다.<br><br> - [컴파일러 기술 문서](https://intlayer.org/doc/compiler)                                                                                                                                                                                                       |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true) | **언어별 독립 선언 파일 기능**<br><br>각 언어별 콘텐츠 선언을 분리함으로써 정밀하고 깔끔하게 파일 구조를 분할 및 확장할 수 있습니다.<br><br> - [언어별 파일 가이드](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                                                    |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)                      | **엄격한 타입 안전성 보장**<br><br>TypeScript의 강력한 타입 체크를 활용해 휴먼 에러를 완전 차단하고, IDE에서 제공하는 최적의 사전 키 자동완성 힌트를 활용해 보세요.<br><br> - [TypeScript 설정 가이드](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                         |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true)                         | **직관적인 설정 및 시작**<br><br>최소한의 기본 구문 설정으로 앱을 신속히 배포해 보세요. 라우팅, 국제화, 빌드 및 콘텐츠 분석과 관련된 전반적인 제어가 편리합니다. <br><br> - [Next.js 통합 알아보기](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                         |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true)                   | **간편한 콘텐츠 조회**<br><br>자잘한 구문마다 매번 수동으로 `t` 번역 헬퍼를 결합하지 않아도 됩니다. 통합 훅(Hook)을 결합해 필요한 범위의 콘텐츠 딕셔너리를 단번에 인출할 수 있습니다.<br><br> - [React 통합 레퍼런스](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                             |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true)                    | **일관된 서버 컴포넌트 설계**<br><br>Next.js 서버 컴포넌트(RSC)에 최적화된 아키텍처로, 클라이언트 사이드와 서버 사이드 모두 동일한 훅과 구문 형태를 적용할 수 있어 번거롭게 `t` 함수를 컴포넌트 트리에 수동 전달할 필요가 없습니다. <br><br> - [서버 컴포넌트 가이드](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                                                   |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true)                           | **고도로 조직화된 코드베이스**<br><br>코드 설계를 간결하게 분리합니다: 1 기능 컴포넌트 폴더 내에 해당 사전 딕셔너리가 결합되어 높은 가독성을 유도합니다. <br><br> - [Intlayer 작동 개념](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                                                                                            |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true)                         | **강력한 로컬라이즈 라우팅**<br><br>경로 다국어 처리를 기본 탑재하여 Next.js, React, Vite, Vue.js 등을 활용해 복잡하게 얽힌 하위 페이지 주소를 정교하게 분리해 줍니다.<br><br> - [Next.js 통합 가이드](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                      |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true)                            | **Markdown 기본 연동**<br><br>서비스 약관, 법적 공지, 테크니컬 가이드 등 텍스트 서식이 가미된 Markdown 파일 처리를 기본 제공하여, 프론트 코드 내에서 서식 및 메타데이터를 정밀히 매핑할 수 있습니다.<br><br> - [Markdown 활용 가이드](https://intlayer.org/doc/concept/content/file)                                                                                                                                     |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true)                       | **무료 비주얼 에디터 & 헤드리스 CMS**<br><br>마케터, 기획자, 번역가 등 비개발 협업자가 직관적으로 텍스트를 고칠 수 있는 비주얼 편집 도구와 CMS를 무료 제공합니다. Git 동기화 또는 CMS 원격 결합 방식을 유연하게 설정할 수 있습니다.<br><br> - [비주얼 에디터 문서](https://intlayer.org/doc/concept/editor) <br> - [헤드리스 CMS 문서](https://intlayer.org/doc/concept/cms)                                             |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true)                              | **Tree-shaking 지원을 통한 초경량 배포**<br><br>빌드 시점에 사용하지 않는 언어와 사전을 완벽히 배포 대상에서 쳐내어 최종 번들 용량을 획기적으로 낮춥니다. 모듈별 레이지 로딩을 원활하게 수행합니다. <br><br> - [빌드 최적화 알아보기](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)                                                                                                        |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true)                    | **정적 정밀 렌더링(SSG) 최적화**<br><br>정적 생성(Static Rendering) 모듈 작동을 방해하지 않고 부드럽게 작동합니다. <br><br> - [Next.js 정적 빌드](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                           |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true)                      | **원클릭 지능형 AI 번역**<br><br>개발자가 직접 등록한 AI 프로바이더 구성을 바탕으로, CLI 한 번으로 최대 231개 이상의 전 세계 로케일 번역을 자동으로 일괄 적용해 줍니다. <br><br> - [CI/CD 자동 번역](https://intlayer.org/doc/concept/ci-cd) <br> - [Intlayer CLI 연동](https://intlayer.org/doc/concept/cli) <br> - [자동 채우기](https://intlayer.org/doc/concept/auto-fill)                                           |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true)                                 | **MCP 서버 연동**<br><br>에디터 자동화 표준 프로토콜인 MCP(Model Context Protocol) 서버를 탑재하여, IDE 개발 보조 인공지능이 코드 번역 작업을 훨씬 능동적이고 정확하게 제어하도록 지원합니다. <br><br> - [MCP 서버 정보](https://github.com/aymericzip/intlayer/blob/main/docs/ko/mcp_server.md)                                                                                                                         |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true)                    | **VSCode 공식 확장 프로그램**<br><br>사전 딕셔너리 관리, 자동 번역 결합 및 사전 빌드 상태 확인 등을 돕는 전용 에디터 확장을 연동해 보세요. <br><br> - [에디터 확장 프로그램](https://intlayer.org/doc/vs-code-extension)                                                                                                                                                                                                 |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true)                    | **높은 상호 운용성**<br><br>기존 react-i18next, next-i18next, next-intl, react-intl 등 기존 모듈 규격에서 손쉽게 마이그레이션하거나 공존할 수 있는 통합 API를 구축했습니다. <br><br> - [react-intl 연동](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [next-intl 연동](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [next-i18next 연동](https://intlayer.org/blog/intlayer-with-next-i18next) |
+| 번역 누락 테스트(CLI/CI)                                                                                                  | ✅ CLI: npx intlayer content test (CI 친화적인 자동 진단)                                                                                                                                                                                                                                                                                                                                                                |
 
 ## Intlayer와 다른 솔루션 비교
 
-| 기능                                      | `intlayer`                                                                                                 | `react-i18next`                                                                         | `react-intl` (FormatJS)                                                                               | `lingui`                                                | `next-intl`                                                                             | `next-i18next`                                                                          | `vue-i18n`                                                       |
-| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| **컴포넌트 근처의 번역**                  | ✅ 예, 콘텐츠가 각 컴포넌트와 동일한 위치에 있음                                                           | ❌ 아니요                                                                               | ❌ 아니요                                                                                             | ❌ 아니요                                               | ❌ 아니요                                                                               | ❌ 아니요                                                                               | ✅ 예 - `Single File Components`(SFC) 사용 시                    |
-| **TypeScript 통합**                       | ✅ 고급, 자동 생성된 엄격한 타입                                                                           | ⚠️ 기본; 안전을 위해 추가 구성 필요                                                     | ✅ 좋음, 하지만 덜 엄격함                                                                             | ⚠️ 타이핑, 구성 필요                                    | ✅ 좋음                                                                                 | ⚠️ 기본                                                                                 | ✅ 좋음 (타입 사용 가능; 키 안전에는 설정 필요)                  |
-| **누락된 번역 감지**                      | ✅ TypeScript 오류 강조 표시 및 빌드 시 오류/경고                                                          | ⚠️ 주로 런타임 시 폴백(fallback) 문자열                                                 | ⚠️ 폴백 문자열                                                                                        | ⚠️ 추가 구성 필요                                       | ⚠️ 런타임 폴백                                                                          | ⚠️ 런타임 폴백                                                                          | ⚠️ 런타임 폴백/경고 (구성 가능)                                  |
-| **풍부한 콘텐츠 (JSX/Markdown/컴포넌트)** | ✅ 직접 지원                                                                                               | ⚠️ 제한적 / 보간만 가능                                                                 | ⚠️ ICU 구문, 실제 JSX 아님                                                                            | ⚠️ 제한적                                               | ❌ 풍부한 노드용으로 설계되지 않음                                                      | ⚠️ 제한적                                                                               | ⚠️ 제한적 (`<i18n-t>`를 통한 컴포넌트, 플러그인을 통한 Markdown) |
-| **AI 기반 번역**                          | ✅ 예, 여러 AI 제공업체 지원. 자체 API 키를 사용하여 사용 가능. 애플리케이션의 문맥과 콘텐츠 범위를 고려함 | ❌ 아니요                                                                               | ❌ 아니요                                                                                             | ❌ 아니요                                               | ❌ 아니요                                                                               | ❌ 아니요                                                                               | ❌ 아니요                                                        |
-| **비주얼 에디터**                         | ✅ 예, 로컬 비주얼 에디터 + 선택적 CMS; 코드베이스 콘텐츠 외부화 가능; 임베드 가능                         | ❌ 아니요 / 외부 로컬라이제이션 플랫폼을 통해 사용 가능                                 | ❌ 아니요 / 외부 로컬라이제이션 플랫폼을 통해 사용 가능                                               | ❌ 아니요 / 외부 로컬라이제이션 플랫폼을 통해 사용 가능 | ❌ 아니요 / 외부 로컬라이제이션 플랫폼을 통해 사용 가능                                 | ❌ 아니요 / 외부 로컬라이제이션 플랫폼을 통해 사용 가능                                 | ❌ 아니요 / 외부 로컬라이제이션 플랫폼을 통해 사용 가능          |
-| **로컬라이즈드 라우팅**                   | ✅ 예, 기본적으로 로컬라이즈드 경로 지원 (Next.js 및 Vite와 작동)                                          | ⚠️ 내장 기능 없음, 플러그인(예: `next-i18next`) 또는 커스텀 라우터 구성 필요            | ❌ 아니요, 메시지 포맷팅만 제공, 라우팅은 수동이어야 함                                               | ⚠️ 내장 기능 없음, 플러그인 또는 수동 구성 필요         | ✅ 내장, App Router는 `[locale]` 세그먼트 지원                                          | ✅ 내장                                                                                 | ✅ 내장                                                          |
-| **동적 경로 생성**                        | ✅ 예                                                                                                      | ⚠️ 플러그인/에코시스템 또는 수동 설정                                                   | ❌ 제공되지 않음                                                                                      | ⚠️ 플러그인/수동                                        | ✅ 예                                                                                   | ✅ 예                                                                                   | ❌ 제공되지 않음 (Nuxt i18n에서 제공)                            |
-| **복수형화**                              | ✅ 열거형 기반 패턴                                                                                        | ✅ 구성 가능 (i18next-icu와 같은 플러그인)                                              | ✅ (ICU)                                                                                              | ✅ (ICU/messageformat)                                  | ✅ 좋음                                                                                 | ✅ 좋음                                                                                 | ✅ 내장 복수형 규칙                                              |
-| **포맷팅 (날짜, 숫자, 통화)**             | ✅ 최적화된 포맷터 (내부적으로 Intl 사용)                                                                  | ⚠️ 플러그인 또는 커스텀 Intl 사용을 통해                                                | ✅ ICU 포맷터                                                                                         | ✅ ICU/CLI 헬퍼                                         | ✅ 좋음 (Intl 헬퍼)                                                                     | ✅ 좋음 (Intl 헬퍼)                                                                     | ✅ 내장 날짜/숫자 포맷터 (Intl)                                  |
-| **콘텐츠 형식**                           | ✅ .tsx, .ts, .js, .json, .md, .txt, (.yaml 작업 중)                                                       | ⚠️ .json                                                                                | ✅ .json, .js                                                                                         | ⚠️ .po, .json                                           | ✅ .json, .js, .ts                                                                      | ⚠️ .json                                                                                | ✅ .json, .js                                                    |
-| **ICU 지원**                              | ⚠️ 작업 중                                                                                                 | ⚠️ 플러그인(i18next-icu)을 통해                                                         | ✅ 예                                                                                                 | ✅ 예                                                   | ✅ 예                                                                                   | ⚠️ 플러그인(`i18next-icu`)을 통해                                                       | ⚠️ 커스텀 포맷터/컴파일러를 통해                                 |
-| **SEO 헬퍼 (hreflang, sitemap)**          | ✅ 내장 도구: sitemap, robots.txt, 메타데이터용 헬퍼                                                       | ⚠️ 커뮤니티 플러그인/수동                                                               | ❌ 핵심 기능 아님                                                                                     | ❌ 핵심 기능 아님                                       | ✅ 좋음                                                                                 | ✅ 좋음                                                                                 | ❌ 핵심 기능 아님 (Nuxt i18n에서 헬퍼 제공)                      |
-| **에코시스템 / 커뮤니티**                 | ⚠️ 규모는 작지만 빠르게 성장 중이며 반응이 빠름                                                            | ✅ 가장 크고 성숙함                                                                     | ✅ 큼                                                                                                 | ⚠️ 작음                                                 | ✅ 중간 규모, Next.js 중심                                                              | ✅ 중간 규모, Next.js 중심                                                              | ✅ Vue 에코시스템에서 큼                                         |
-| **서버 사이드 렌더링 및 서버 컴포넌트**   | ✅ 예, SSR / React 서버 컴포넌트에 최적화됨                                                                | ⚠️ 페이지 레벨에서 지원되지만 하위 서버 컴포넌트의 컴포넌트 트리에 t-함수를 전달해야 함 | ⚠️ 추가 설정으로 페이지 레벨에서 지원되지만 하위 서버 컴포넌트의 컴포넌트 트리에 t-함수를 전달해야 함 | ✅ 지원, 설정 필요                                      | ⚠️ 페이지 레벨에서 지원되지만 하위 서버 컴포넌트의 컴포넌트 트리에 t-함수를 전달해야 함 | ⚠️ 페이지 레벨에서 지원되지만 하위 서버 컴포넌트의 컴포넌트 트리에 t-함수를 전달해야 함 | ✅ Nuxt/Vue SSR을 통한 SSR (RSC 없음)                            |
-| **Tree-shaking (사용된 콘텐츠만 로드)**   | ✅ 예, Babel/SWC 플러그인을 통해 빌드 시 컴포넌트별로 수행                                                 | ⚠️ 일반적으로 모두 로드 (네임스페이스/코드 분할로 개선 가능)                            | ⚠️ 일반적으로 모두 로드                                                                               | ❌ 기본 아님                                            | ⚠️ 부분적                                                                               | ⚠️ 부분적                                                                               | ⚠️ 부분적 (코드 분할/수동 설정 사용 시)                          |
-| **지연 로딩**                             | ✅ 예, 로케일별 / 사전별                                                                                   | ✅ 예 (예: 온디맨드 백엔드/네임스페이스)                                                | ✅ 예 (로케일 번들 분할)                                                                              | ✅ 예 (동적 카탈로그 가져오기)                          | ✅ 예 (경로별/로케일별), 네임스페이스 관리 필요                                         | ✅ 예 (경로별/로케일별), 네임스페이스 관리 필요                                         | ✅ 예 (비동기 로케일 메시지)                                     |
-| **사용되지 않는 콘텐츠 삭제**             | ✅ 예, 빌드 시 사전별로 수행                                                                               | ❌ 아니요, 수동 네임스페이스 분할을 통해서만 가능                                       | ❌ 아니요, 선언된 모든 메시지가 번들링됨                                                              | ✅ 예, 사용되지 않는 키가 감지되어 빌드 시 삭제됨       | ❌ 아니요, 네임스페이스 관리를 통해 수동으로 관리 가능                                  | ❌ 아니요, 네임스페이스 관리를 통해 수동으로 관리 가능                                  | ❌ 아니요, 수동 지연 로딩을 통해서만 가능                        |
-| **대규모 프로젝트 관리**                  | ✅ 모듈화를 장려하며 디자인 시스템에 적합함                                                                | ⚠️ 양호한 파일 규율 필요                                                                | ⚠️ 중앙 카탈로그가 커질 수 있음                                                                       | ⚠️ 복잡해질 수 있음                                     | ✅ 구성을 통한 모듈화                                                                   | ✅ 구성을 통한 모듈화                                                                   | ✅ Vue Router/Nuxt i18n 구성을 통한 모듈화                       |
-
----
-
-## GitHub 스타
-
-GitHub 스타는 프로젝트의 인기, 커뮤니티 신뢰 및 장기적인 관련성을 나타내는 강력한 지표입니다. 기술적 품질을 직접적으로 측정하는 것은 아니지만, 얼마나 많은 개발자가 프로젝트가 유용하다고 생각하고 진행 상황을 팔로우하며 채택할 가능성이 있는지를 반영합니다. 프로젝트의 가치를 평가할 때 스타는 대안 간의 견인력을 비교하는 데 도움이 되며 생태계 성장에 대한 통찰력을 제공합니다.
+| 기능                                     | `intlayer`                                                                                      | `react-i18next`                                                                                         | `react-intl` (FormatJS)                                                                           | `lingui`                                                  | `next-intl`                                                                                             | `next-i18next`                                                                                          | `vue-i18n`                                                         |
+| ---------------------------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
+| **컴포넌트 인근 번역 관리**              | ✅ 예, 컴포넌트와 동일한 위치에 콘텐츠 저장                                                     | ❌ 아니오                                                                                               | ❌ 아니오                                                                                         | ❌ 아니오                                                 | ❌ 아니오                                                                                               | ❌ 아니오                                                                                               | ✅ 예 - `Single File Components` (SFCs) 적용 시                    |
+| **TypeScript 밀착 연동**                 | ✅ 고도의 타입 안전, 엄격한 사전 타입 자동 빌드                                                 | ⚠️ 기본 지원; 엄격한 검사를 위해 수동 설정 필수                                                         | ✅ 양호하나 비교적 유연한 편                                                                      | ⚠️ 기본 타입 지원, 별도 구성 필요                         | ✅ 양호                                                                                                 | ⚠️ 기본 지원                                                                                            | ✅ 양호 (타입 사용 가능; 키의 철저한 안전 검사에는 추가 설정 요함) |
+| **번역 누락 검출**                       | ✅ TypeScript 코드 경고 및 컴파일/빌드 시점에 에러/경고 표시                                    | ⚠️ 대부분 런타임에 대체(Fallback) 텍스트로 대체 처리                                                    | ⚠️ 런타임 대체 텍스트 처리                                                                        | ⚠️ 별도의 복잡한 도구 설정 요구                           | ⚠️ 런타임 대체 텍스트                                                                                   | ⚠️ 런타임 대체 텍스트                                                                                   | ⚠️ 런타임 대체 텍스트 및 경고 (구성 가능)                          |
+| **리ッチ 콘텐츠(JSX/Markdown/컴포넌트)** | ✅ 즉시 직접 결합 지원                                                                          | ⚠️ 제한적 / 변수 보간 기능 중심                                                                         | ⚠️ ICU 마크업 구문 활용, 실제 React JSX 아님                                                      | ⚠️ 제한적                                                 | ❌ 리치 컴포넌트 임베딩을 고려해 설계되지 않음                                                          | ⚠️ 제한적                                                                                               | ⚠️ 제한적 (컴포넌트는 `<i18n-t>`, 마크다운은 플러그인 이용)        |
+| **AI 연동 번역**                         | ✅ 예, 다양한 상용 AI API 탑재 가능. 개발자 키 사용. 앱의 문맥 구조와 컴포넌트 관계를 통합 판단 | ❌ 아니오                                                                                               | ❌ 아니오                                                                                         | ❌ 아니오                                                 | ❌ 아니오                                                                                               | ❌ 아니오                                                                                               | ❌ 아니오                                                          |
+| **비주얼 편집 도구**                     | ✅ 예, 로컬 비주얼 에디터 + 원격 헤드리스 CMS 무료 지원; 사전 딕셔너리 이식 가능                | ❌ 지원 불가 / 유료 외부 번역 대행 플랫폼으로 별도 유도                                                 | ❌ 지원 불가 / 유료 외부 번역 대행 플랫폼으로 별도 유도                                           | ❌ 지원 불가 / 유료 외부 번역 대행 플랫폼으로 별도 유도   | ❌ 지원 불가 / 유료 외부 번역 대행 플랫폼으로 별도 유도                                                 | ❌ 지원 불가 / 유료 외부 번역 대행 플랫폼으로 별도 유도                                                 | ❌ 지원 불가 / 유료 외부 번역 대행 플랫폼으로 별도 유도            |
+| **로컬라이즈 라우팅**                    | ✅ 예, 정교한 다국어 주소 라우팅 기본 결합 (Next.js & Vite와 매끄럽게 호환)                     | ⚠️ 기본 내장 없음, 복잡한 플러그인(예: `next-i18next`)이나 별도 커스텀 구현 필수                        | ❌ 지원 안 함, 메시지 포맷만 지원하며 주소 라우팅은 수동 설계 필요                                | ⚠️ 기본 내장 없음, 플러그인 연동 및 복잡한 수동 구성 필요 | ✅ 내장 지원, Next App Router의 `[locale]` 세그먼트 완벽 호환                                           | ✅ 내장 지원                                                                                            | ✅ 내장 지원                                                       |
+| **동적 다국어 경로 생성**                | ✅ 예                                                                                           | ⚠️ 플러그인 생태계 혹은 수동 구현 필수                                                                  | ❌ 제공되지 않음                                                                                  | ⚠️ 플러그인 연동/수동 구현                                | ✅ 예                                                                                                   | ✅ 예                                                                                                   | ❌ 제공되지 않음 (Nuxt i18n 환경은 제공)                           |
+| **복수형 처리(Pluralization)**           | ✅ 열거형 패턴 중심의 고급 제어                                                                 | ✅ 플러그인 결합(i18next-icu 등) 시 가능                                                                | ✅ (ICU 구문 지원)                                                                                | ✅ (ICU/messageformat 규격)                               | ✅ 안정적인 복수형 제어                                                                                 | ✅ 안정적인 복수형 제어                                                                                 | ✅ 기본 제공 복수형 처리 구문                                      |
+| **기본 포맷팅 (날짜, 수치, 통화 등)**    | ✅ 네이티브 Intl 기반 최적화 포맷터                                                             | ⚠️ 플러그인 연동 또는 수동으로 Intl 연계 구현                                                           | ✅ ICU 규격 포맷터 제공                                                                           | ✅ ICU 규격 / CLI 제공                                    | ✅ 안정적 지원 (Intl 연계)                                                                              | ✅ 안정적 지원 (Intl 연계)                                                                              | ✅ 날짜/숫자 포맷터 내장 (Intl)                                    |
+| **콘텐츠 포맷 규격**                     | ✅ .tsx, .ts, .js, .json, .md, .txt, (.yaml 릴리즈 예정)                                        | ⚠️ .json                                                                                                | ✅ .json, .js                                                                                     | ⚠️ .po, .json                                             | ✅ .json, .js, .ts                                                                                      | ⚠️ .json                                                                                                | ✅ .json, .js                                                      |
+| **ICU 문법 지원**                        | ⚠️ 배포 준비 중                                                                                 | ⚠️ 플러그인 연동 (i18next-icu)                                                                          | ✅ 예                                                                                             | ✅ 예                                                     | ✅ 예                                                                                                   | ⚠️ 플러그인 연동 (`i18next-icu`)                                                                        | ⚠️ 커스텀 포맷터나 번역용 빌더 구성 필요                           |
+| **SEO 최적화 도구 (hreflang, sitemap)**  | ✅ 다국어 사이트맵, robots.txt, 메타데이터 연동 헬퍼 기본 탑재                                  | ⚠️ 커뮤니티 플러그인 탐색 및 수동 설계                                                                  | ❌ 코어 미지원                                                                                    | ❌ 코어 미지원                                            | ✅ 양호                                                                                                 | ✅ 양호                                                                                                 | ❌ 코어 미지원 (Nuxt i18n 라이브러리는 헬퍼 제공)                  |
+| **커뮤니티 및 개발 생태계**              | ⚠️ 작지만 빠른 릴리즈 및 개발사의 고도로 민첩한 응대                                            | ✅ 극히 거대하고 오랜 기간 성숙됨                                                                       | ✅ 거대함                                                                                         | ⚠️ 소규모                                                 | ✅ 중간 규모, Next.js 프레임워크 타겟 편중                                                              | ✅ 중간 규모, Next.js 프레임워크 타겟 편중                                                              | ✅ Vue 개발 에코시스템 내 지배적인 점유율                          |
+| **SSR 및 React 서버 컴포넌트**           | ✅ 예, SSR 및 RSC 서버/클라이언트 동일 훅으로 매끄럽게 작동 설계                                | ⚠️ 페이지 단위는 지원되나, 하위 서버 컴포넌트 딕셔너리 공유를 위해 t 함수를 수동으로 계속 흘려주어야 함 | ⚠️ 복잡한 구성 수반, 하위 서버 컴포넌트 딕셔너리 공유를 위해 t 함수를 수동으로 계속 흘려주어야 함 | ✅ 지원, 별도 아키텍처 설정 필요                          | ⚠️ 페이지 단위는 지원되나, 하위 서버 컴포넌트 딕셔너리 공유를 위해 t 함수를 수동으로 계속 흘려주어야 함 | ⚠️ 페이지 단위는 지원되나, 하위 서버 컴포넌트 딕셔너리 공유를 위해 t 함수를 수동으로 계속 흘려주어야 함 | ✅ Nuxt/Vue SSR 기반의 SSR 지원 (RSC 미지원)                       |
+| **트리 셰이킹 (용량 효율화)**            | ✅ 예, 빌드 시점에 Babel/SWC 컴파일러 플러그인을 통한 컴포넌트별 용량 정밀 제어                 | ⚠️ 대개 전체 언어 사전 로드 (네임스페이스 분할로 일부 대응 가능하나 번거로움)                           | ⚠️ 대개 모든 다국어 정의가 통째로 브라우저에 배포                                                 | ❌ 기본 활성 미지원                                       | ⚠️ 일부 로케일 분리 대응 가능                                                                           | ⚠️ 일부 로케일 분리 대응 가능                                                                           | ⚠️ 부분 지원 (코드 스플리팅 적용 시 가능)                          |
+| **지연 로딩 (Lazy Loading)**             | ✅ 예, 로케일별 / 사전 파일별 정교한 분리 로딩                                                  | ✅ 예 (외부 사전 로더 등 결합 시)                                                                       | ✅ 예 (언어 파일 사전 빌드 분리)                                                                  | ✅ 예 (사전 카탈로그 비동기 임포트)                       | ✅ 예 (경로 단위 분할 가능), 네임스페이스 수동 분할 작업이 복잡함                                       | ✅ 예 (경로 단위 분할 가능), 네임스페이스 수동 분할 작업이 복잡함                                       | ✅ 예 (로케일 메시지 비동기 임포트)                                |
+| **미사용 언어 사전 정리 (Purge)**        | ✅ 예, 빌드 시 컴파일러가 미사용 사전을 전수 파악해 번들 대상서 축출                            | ❌ 지원 불가, 수작업 네임스페이스 격리 필수                                                             | ❌ 지원 불가, 모든 다국어 선언이 빌드 번들에 편입                                                 | ✅ 예, 빌드 시 코드 내 미사용 키를 검사하여 파일서 소거   | ❌ 지원 불가, 네임스페이스 수작업 격리 및 번거로운 구성 수반                                            | ❌ 지원 불가, 네임스페이스 수작업 격리 및 번거로운 구성 수반                                            | ❌ 지원 불가, 레이지 로딩 직접 구성 외에는 수동 통제 불가          |
+| **대규모 프로젝트 확장 제어**            | ✅ 개별 컴포넌트와 사전이 귀속되어 마이크로 아키텍처 및 디자인 시스템 최적화                    | ⚠️ 높은 파일 디렉토리 보존 훈련 요구                                                                    | ⚠️ 중앙화된 대용량 사전 파일이 극단적으로 팽창 가능                                               | ⚠️ 점진적으로 의존성 관리가 꼬이기 쉬움                   | ✅ 폴더 구조 구성 시 일부 대응 가능                                                                     | ✅ 폴더 구조 구성 시 일부 대응 가능                                                                     | ✅ Vue Router 및 Nuxt i18n 모듈과의 아키텍처 연계 필요             |
+
+## GitHub Star 연혁
+
+GitHub Star 수는 프로젝트의 인지도, 커뮤니티의 신뢰도 및 장기적인 생명력을 파악하는 중요한 척도입니다. 이것이 서비스 모듈의 기술적 안전성을 100% 대변하는 절대 지표는 아니지만, 얼마나 많은 실무 개발자들이 해당 솔루션을 검토하고 관심을 가지고 적극적으로 프로젝트 도입을 추진하는지 투명하게 반증합니다. Intlayer의 Star 연혁을 비교해 보면, 타 솔루션 대비 얼마나 빠르게 성장하며 생태계를 확장하고 있는지 그 추세를 정밀히 비교해 보실 수 있습니다.
 
 [![Star History Chart](https://api.star-history.com/chart?repos=aymericzip/intlayer%2Cformatjs/formatjs%2Ci18next/react-i18next%2Ci18next/i18next%2Ci18next/next-i18next%2Clingui/js-lingui%2Camannn/next-intl%2Cintlify/vue-i18n%2Ccodingcommons/typesafe-i18n%2Copral/paraglide-js&type=date&legend=top-left)](https://www.star-history.com/#aymericzip/intlayer&formatjs/formatjs&i18next/react-i18next&i18next/i18next&i18next/next-i18next&lingui/js-lingui&amannn/next-intl&intlify/vue-i18n&codingcommons/typesafe-i18n&opral/paraglide-js)
 
@@ -230,6 +278,6 @@ GitHub 스타는 프로젝트의 인기, 커뮤니티 신뢰 및 장기적인
 
 ## 상호 운용성
 
-`intlayer`는 `react-intl`, `react-i18next`, `next-intl`, `next-i18next` 및 `vue-i18n` 네임스페이스 관리를 도울 수 있습니다.
+`intlayer`는 기존의 `react-intl`, `react-i18next`, `next-intl`, `next-i18next` 및 `vue-i18n` 사전 네임스페이스들을 동시에 손쉽게 지배하고 가공하도록 지원합니다.
 
-`intlayer`를 사용하면 선호하는 i18n 라이브러리 형식으로 콘텐츠를 선언할 수 있으며, intlayer는 선택한 위치(예: `/messages/{{locale}}/{{namespace}}.json`)에 네임스페이스를 생성합니다.
+`intlayer` 문법 형태로 다국어를 간편히 선언만 해두면, intlayer가 번거롭고 복잡한 기존 프레임워크 규격(예: `/messages/{{locale}}/{{namespace}}.json`)에 맞춰 빌드 타임에 자동으로 사전 파일을 추출 및 변환해 줍니다.

package/docs/ko/intlayer_with_adonisjs.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2026-05-06
-title: AdonisJS i18n - AdonisJS 앱 번역 방법 2026
-description: AdonisJS 백엔드를 다국어로 만드는 방법을 알아보세요. 국제화(i18n) 및 번역을 위해 문서를 따르십시오.
+updatedAt: 2026-05-31
+title: "AdonisJS i18n - 완전한 번역 가이드: AdonisJS"
+description: 번들 크기, SEO, 성능 및 유지보수성을 위한 최고의 솔루션. 2026년에 AdonisJS 백엔드를 다국어로 만드세요, LLM 번역, Agent Skills & MCP.
 keywords:
   - 국제화
   - 문서

package/docs/ko/intlayer_with_analog.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-05-06
-title: Analog i18n - Analog 앱 번역 방법 2026
-description: Analog 앱을 다국어로 만드는 방법을 알아보세요. 가이드를 따라 국제화(i18n) 및 번역을 적용하세요.
+updatedAt: 2026-05-31
+title: "Analog i18n - 완전한 번역 가이드: Analog"
+description: 번들 크기, SEO, 성능 및 유지보수성을 위한 최고의 솔루션. 2026년에 Analog 앱를 다국어로 만드세요, LLM 번역, Agent Skills & MCP.
 keywords:
   - 국제화
   - 문서
@@ -56,16 +56,47 @@ history:
 
 <TOC/>
 
-## Intlayer란 무엇인가요?
+## 대안보다 Intlayer를 선택해야 하는 이유는 무엇입니까?
 
-**Intlayer**는 현대적인 웹 애플리케이션에서 다국어 지원을 단순화하기 위해 설계된 혁신적인 오픈 소스 국제화(i18n) 라이브러리입니다.
+'ngx-translate' 또는 'angular-l10n'과 같은 주요 솔루션과 비교할 때 Intlayer는 다음과 같은 통합 최적화가 제공되는 솔루션입니다.
 
-Intlayer를 사용하면 다음을 할 수 있습니다:
+<AccordionGroup>
+<Accordion header="완전한 아날로그 범위">
 
-- **번역 관리 용이**: 컴포넌트 수준에서 선언적 딕셔너리를 사용합니다.
-- **메타데이터, 라우트, 콘텐츠의 동적 로컬라이제이션**.
-- **TypeScript 지원 보장**: 자동 생성된 타입을 통해 자동 완성 및 오류 감지 기능을 향상시킵니다.
-- **고급 기능 활용**: 동적 로케일 감지 및 전환 등.
+Intlayer는 **다국어 라우팅**, **SSR 지원** 및 국제화 확장(i18n)에 필요한 모든 기능을 제공하여 아날로그와 완벽하게 작동하도록 최적화되었습니다.
+
+</Accordion>
+<Accordion header="번들 크기">
+
+대용량 JSON 파일을 페이지에 로드하는 대신 필요한 콘텐츠만 로드하세요. Intlayer는 **번들 및 페이지 크기를 최대 50%** 줄이는 데 도움이 됩니다.
+
+</Accordion>
+<Accordion header="유지관리성">
+
+애플리케이션 콘텐츠의 범위를 지정하면 대규모 애플리케이션의 **유지 관리가 용이해집니다**. 전체 콘텐츠 코드베이스를 검토해야 하는 정신적 부담 없이 단일 기능 폴더를 복제하거나 삭제할 수 있습니다. 또한 Intlayer는 **완전히 유형**되어 콘텐츠의 정확성을 보장합니다.
+
+</Accordion>
+<Accordion header="AI 에이전트">
+
+콘텐츠를 같은 위치에 배치하면 LLM(대형 언어 모델)에 **필요한 컨텍스트가 줄어듭니다**. Intlayer에는 누락된 번역을 테스트하기 위한 **CLI**, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 및 **[agent)와 같은 도구 모음도 함께 제공됩니다. 기술](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**, AI 에이전트를 위한 개발자 경험(DX)을 더욱 원활하게 만듭니다.
+
+</Accordion>
+<Accordion header="오토메이션">
+
+AI 공급자의 비용으로 선택한 LLM을 사용하여 CI/CD 파이프라인을 번역하려면 자동화를 사용하세요. Intlayer는 또한 콘텐츠 추출을 자동화하는 **컴파일러**와 **백그라운드에서 번역**을 돕는 [웹 플랫폼](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)을 제공합니다.
+
+</Accordion>
+<Accordion header="성능">
+
+대규모 JSON 파일을 구성 요소에 연결하면 성능 및 반응성 문제가 발생할 수 있습니다. Intlayer는 빌드 시 콘텐츠 로딩을 최적화합니다.
+
+</Accordion>
+<Accordion header="개발자가 없는 경우 확장">
+
+Intlayer는 단순한 i18n 솔루션 그 이상으로 관리에 도움이 되는 **자체 호스팅 [비주얼 편집기](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** 및 **[전체 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)**를 제공합니다. 다국어 콘텐츠를 **실시간**으로 제공하여 번역가, 카피라이터, 기타 팀원과 원활하게 협업할 수 있습니다. 콘텐츠는 로컬 및/또는 원격으로 저장될 수 있습니다.
+
+</Accordion>
+</AccordionGroup>
 
 ---