Skip to content
Silubaba trade > Blog > news > VOLEMI Frontend + Flutter Buyer App Multilingual & Currency Specification

VOLEMI Frontend + Flutter Buyer App Multilingual & Currency Specification

    (Merge into full official website PRD + Buyer App Development Document | English Version)

    1. Frontend Website Multilingual Configuration (Web Public Portal)

    1.1 Reserved Language List (Only these languages remain, all other languages removed)

    1. Chinese (zh-CN)
    2. English (en)
    3. German (de)
    4. French (fr)
    5. Russian (ru)
    6. Turkish (tr)
    7. Korean (ko)
    8. Japanese (ja)
    9. Spanish (es)
    10. Portuguese (pt)
    11. Arabic (ar) — Auto enable RTL layout
    12. Hindi (hi)
    13. Thai (th)
    14. Vietnamese (vi)

    Development requirement: All unused language packs shall be deleted from front-end code, backend language configuration panel, translation database.

    1.2 Language Pack Architecture Requirement

    All front-end pages add independent language pack management layer

    • All static text, button text, prompt text, page title, TDK copy stored in independent language JSON language packs
    • No hard-coded text on any page
    • Language pack path specification:

    plaintext

    /langs/zh-CN.json
/langs/en.json
/langs/de.json
/langs/fr.json
/langs/ru.json
/langs/tr.json
/langs/ko.json
/langs/ja.json
/langs/es.json
/langs/pt.json
/langs/ar.json
/langs/hi.json
/langs/th.json
/langs/vi.json
    • Backend support one-click import/export language pack for batch translation editing

    1.3 Automatic Language Loading Rule (GEO + Time Zone Trigger)

    1. System automatically identify visitor IP country, region, time zone via GEO service
    2. Match the most matching reserved language and automatically load corresponding language pack for first access
    3. Manual language switch by user has higher priority than automatic GEO detection; system save user language selection into browser local storage
    4. If the matched regional language is not in reserved list → default load English (en)
    5. Arabic visitors automatically trigger HTML RTL layout switch

    2. Currency Configuration Rules (Web + Buyer App Unified)

    2.1 Keep only two currencies, remove all other currency options

    1. USD (US Dollar)
    2. CNY (Chinese Yuan)

    2.2 Currency display logic

    1. GEO detection automatically match recommended display currency:
      • Visitors from overseas non-China regions: default display USD
      • Visitors from Mainland China: default display CNY
    2. Users can manually switch between USD / CNY; selection saved locally
    3. Real-time exchange rate conversion between USD and CNY on product price, checkout page, order detail page
    4. Google Shopping feed only output selected currency price according to region rules

    3. VOLEMI Flutter Buyer Mobile App Language Rules (All App Pages)

    1. The buyer app completely synchronizes the above 14 language list, consistent with web frontend
    2. Flutter built-in independent i18n language package resource files, all UI text read from language packs; zero hardcode text
    3. App first launch: obtain device location / IP GEO information → auto load matching language pack
    4. User manual language switch saved in app local storage, priority higher than automatic detection
    5. Arabic language mode: global automatic RTL layout flip for all pages
    6. All modules effective: homepage, category, product detail, login/register, checkout, order center, order details, AI customer service, personal center

    4. Admin Mobile App Language Note

    Admin backend mobile app language scope can be configured separately (not affected by front buyer side language reduction requirement)

    5. SEO & Multilingual URL Synchronization Update

    1. Reserved language subdirectory route standard: /zh-CN/ /en/ /de/ /fr/ /ru/ /tr/ /ko/ /ja/ /es/ /pt/ /ar/ /hi/ /th/ /vi/
    2. Remove all other unused language subdirectory routes
    3. Hreflang tags only output the above 14 language versions
    4. Each language corresponds independent sitemap XML
    5. Google Shopping multi-language feeds only generate for reserved languages

    6. Key Development Checklist (Deliver to Dev Team)

    • Clean up all redundant language files and database translation entries
    • Build unified independent language pack layer for web frontend
    • Implement GEO IP + time zone automatic language matching logic
    • Lock available currency to USD & CNY only, delete other currency calculation logic
    • Flutter Buyer App rebuild i18n language resource for the 14 languages
    • All pages verify no hard-coded static text
    • Test Arabic RTL global layout switch
    • Test language manual switch storage & priority logic
    • Test cross-device consistent language preference after user login

    Leave a Reply