Lager Guru v3.5.0
Release date: 2025-12-08
Git tag: v3.5.0
Branch: feature/i18n-multi-language-upgrade
🔥 Summary
This release introduces comprehensive multi-language support (i18n) to Lager Guru, enabling the application to be used in multiple languages with full translation support for English and Bulgarian, with infrastructure for additional languages.
✨ Added
Internationalization Infrastructure
- react-i18next Integration: Complete react-i18next infrastructure setup
- Language Detection: Automatic browser language detection
- Language Routing: URL-based language routing (e.g.,
/en/dashboard,/bg/dashboard) - Translation Management: Centralized translation key management
- Multi-language VitePress: Documentation site with multi-language support
Language Support
- English (EN): Complete English translations
- Bulgarian (BG): Complete Bulgarian translations
- Language Switcher: UI component for switching languages
- Persistent Language: User and tenant language preferences
Translation Coverage
- Landing Page: Complete translations for landing page
- Login Page: Full login page translations
- Navigation: All navigation items translated
- Admin Layout: Complete admin layout translations
- Dashboard: Dashboard translations
- Sidebar: Sidebar navigation translations
Language Detection Chain
- Browser Language: Automatic detection from browser settings
- User Preference: User-specific language preference
- Tenant Default: Tenant-level default language
- System Default: Fallback to system default (English)
Documentation
- Multi-language Docs: VitePress documentation with language support
- Translation Guide: Documentation for adding new languages
- Language Support Docs: Complete language support documentation
🔧 Improved
User Experience
- Localized Interface: Full interface localization
- Language Persistence: Language preference saved per user/tenant
- Smooth Transitions: Seamless language switching without page reload
- Better Accessibility: Improved accessibility with proper language attributes
Developer Experience
- Translation Keys: Structured translation key organization
- Type Safety: Type-safe translation keys
- Easy Extensions: Easy to add new languages
- Documentation: Comprehensive i18n documentation
🐛 Fixed
- CI/CD Build Errors: Fixed build errors related to
letvsconstin shipments.ts queries - PDF Generator: Fixed parsing error by renaming pdfGenerator.ts to .tsx
- Language Prefix: Prevented language prefix duplication in dashboard routes
- Import Errors: Fixed dashboard import in i18n config
- Initialization: Proper i18n initialization in main.tsx
Additional Fixes
- Pick & Pack Access: Added Pick & Pack access for drivers
- Safety Dashboard: Fixed Safety Dashboard layouts
- Driver RLS: Added driver RLS policies
- Zone Fixes: Fixed zone-related issues
🔒 Security
- RLS Compatibility: i18n system respects existing RLS policies
- Tenant Isolation: Language preferences are tenant-specific
- Access Control: Language switching doesn't affect access control
- Security: No security implications from i18n implementation
⚙ Migration Notes
- No Breaking Changes: All changes are additive
- Translation Files: New translation files added to
src/i18n/locales/ - Database: User and tenant language preferences stored in database
- Routing: Language-aware routing implemented
- Backward Compatible: Defaults to English if no language preference set
Technology Stack
- react-i18next: v16.4.0
- i18next: v25.7.1
- i18next-browser-languagedetector: v8.2.0
- VitePress: Multi-language configuration