Skip to content

[Feature/i18n translate] add full frontend localization (en/ko), feedback message refactor, and language-switch polish#15

Merged
hololee merged 6 commits into
mainfrom
feature/i18n_translate
Feb 14, 2026
Merged

[Feature/i18n translate] add full frontend localization (en/ko), feedback message refactor, and language-switch polish#15
hololee merged 6 commits into
mainfrom
feature/i18n_translate

Conversation

@hololee

@hololee hololee commented Feb 14, 2026

Copy link
Copy Markdown
Owner

Summary

main 이후 i18n 1~6단계를 하나의 PR로 통합했습니다.
프론트엔드 전반에 en/ko 로컬라이제이션 인프라를 도입하고, 페이지 UI/토스트/에러/동적 메시지까지 현지화했으며, 언어 전환
UX와 문서/검증 스크립트까지 마무리했습니다.

Included Commits

  • 3601819 add i18n infrastructure
  • 7f06ba5 extract shared, common strings
  • 9a82869 localize dashboard + provisioning
  • afe36d2 localize settings + templates + terminal
  • b1d5842 localize toasts/errors/dynamic messages
  • f77d366 docs + language switch polish

Scope / Key Changes

1) i18n infrastructure

  • i18next, react-i18next 도입
  • frontend/src/i18n/index.ts 초기화
  • frontend/src/main.tsx i18n bootstrap 연결
  • locale 파일 추가:
    • frontend/src/i18n/locales/en/common.ts
    • frontend/src/i18n/locales/ko/common.ts

2) 공통 문자열 체계화

  • 공통 액션/상태/라벨 키 정리
  • Modal, Sidebar 등 공통 컴포넌트 문자열 치환

3) 페이지 현지화

  • Dashboard / Provisioning / Settings / Templates / Terminal
  • 제목/설명/라벨/버튼/placeholder/모달/empty-state 현지화
  • 상태값 표시 및 동적 텍스트 interpolation 적용

4) 메시지 리팩터링 (toasts/errors/dynamic)

  • feedback.* 네임스페이스 도입
  • 토스트/상태 메시지/동적 오류 문구를 feedback.*로 통일
  • API 에러 fallback 유틸 추가:
    • frontend/src/utils/i18nMessage.ts (withApiMessage)

5) language switch polish

  • 언어 선택 UI를 Settings > General 섹션으로 이동
  • 선택 언어 localStorage(lyra.language)에 저장
  • 초기 언어 로딩 시 localStorage 안전 접근(try/catch)
  • 터미널 페이지 언어 변경 시 불필요한 WS 재연결 방지 개선

6) docs + check automation

  • i18n 가이드 및 운영 정책 문서화
    • README.md
    • frontend/README.md
  • i18n 검증 스크립트 추가
    • frontend/scripts/i18n-scan.mjs
    • frontend/scripts/i18n-keys.mjs
    • package.json scripts:
      • i18n:scan
      • i18n:keys

Migration / Breaking Changes

  • DB 마이그레이션 없음
  • Backend API 스키마 변경 없음
  • Frontend UX 변경:
    • 언어 선택 위치가 사이드바 → Settings General로 이동됨

Notes

  • 번역 키/메시지 정책은 README에 명시
  • 이후 신규 UI/메시지는 feedback.* 및 locale 동기화 규칙 준수 필요

@hololee hololee self-assigned this Feb 14, 2026
@hololee hololee merged commit 58ce252 into main Feb 14, 2026
1 check passed
@hololee hololee deleted the feature/i18n_translate branch February 14, 2026 09:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant