Skip to content

Conversation

@dilutedev
Copy link

Pull Request Template

Description

This PR adds complete Traditional Chinese (繁體中文) language support to the Chatwoot mobile app, enabling Traditional Chinese users to use the app in their native language.

Changes include:

  • Added complete zh_TW translation file with all 326 translation keys
  • Integrated zh_TW into i18n configuration
  • Added "Chinese (Traditional)" to the language selection menu
  • Updated "Chinese" to "Chinese (Simplified)" for clarity
  • Added comprehensive language documentation for future contributors

Motivation: Expand accessibility to Traditional Chinese speaking users in Taiwan, Hong Kong, Macau, and other regions.

Fixes # (if there's an issue, add the number)

Type of change

Please delete options that are not relevant.

  • New feature (non-breaking change which adds functionality)
  • This change requires a documentation update

How Has This Been Tested?

Testing performed:

  1. Translation completeness verification:

    • Validated all 326 translation keys match English version
    • Confirmed JSON syntax is valid
    • Verified no missing or extra keys
  2. Code validation:

    • Prettier formatting check passed for all modified files
    • JavaScript syntax validation passed
    • TypeScript configuration updated correctly
  3. Manual testing needed:

    • Launch app and navigate to Settings → Change Language
    • Select "Chinese (Traditional)" from language list
    • Navigate through all major screens (Login, Conversations, Settings, Notifications)
    • Verify all UI text displays correctly in Traditional Chinese
    • Test MFA and SSO flows with Traditional Chinese translations
    • Confirm no layout issues with longer/shorter text strings

Test Configuration:

  • Branch: feat/add-traditional-chinese-support
  • Modified files: 5 (3 code, 2 documentation)
  • Translation quality: Professional Traditional Chinese (繁體中文)

Checklist:

  • I have performed a self-review of my own code
  • I have commented on my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • I have tested in both Android and iOS platform
  • My changes generate no new warnings
  • Any dependent changes have been merged and published in downstream modules

Additional Notes

Documentation added:

  • docs/ADDING_LANGUAGES.md - Comprehensive guide for adding new languages
  • README.md - Added "Supported Languages" section listing all 33 supported languages

Translation quality:

  • All MFA (Multi-Factor Authentication) terms properly translated
  • SSO (Single Sign-On) terminology accurate
  • Consistent use of Traditional Chinese characters throughout
  • Professional tone maintained for error messages and UI text

Files modified:

  1. src/i18n/zh_TW.json - New translation file
  2. src/i18n/index.js - Added zh_TW import and registration
  3. src/constants/index.ts - Added zh_TW to LANGUAGES constant
  4. README.md - Added language documentation
  5. docs/ADDING_LANGUAGES.md - New contributor guide

  Added complete Traditional Chinese localization to enable users to use
  the app in Traditional Chinese (繁體中文).

  Changes:
  - Added zh_TW translations with all 326 translation keys matching en.json
  - Imported zh_TW locale in i18n configuration (src/i18n/index.js)
  - Added 'Chinese (Traditional)' to LANGUAGES constant (src/constants/index.ts)
  - Updated existing 'Chinese' to 'Chinese (Simplified)' for clarity
  - Included translations for MFA and SSO features

  Documentation:
  - Added "Supported Languages" section to README.md listing all 33 languages
  - Created comprehensive language contribution guide (docs/ADDING_LANGUAGES.md)
  - Added link to translation guide in README for contributors

  All translations are complete and verified. Users can now select
  "Chinese (Traditional)" from Settings → Change Language.

  Modified files:
  - src/i18n/zh_TW.json
  - src/i18n/index.js
  - src/constants/index.ts
  - README.md
  - docs/ADDING_LANGUAGES.md (new)
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