amount_to_word
A comprehensive Flutter package for converting numbers and amounts to words in multiple languages (Persian, English, Turkish) with full currency support and smart pluralization.
What this package is like to depend on
Last release 10 months ago
28 Sep 2025
Too new to tell
only 1 release windows
Nearly every release is documented
notes for 3 of 3 stable releases
Nothing withdrawn
no release was ever pulled
10 months old
3 releases · first in 2025
3 releases in the last 12 months
see the full history below
Release timeline
3 releases · Sep 2025 to Sep 2025
2026
Releases
latest 3-
2.0.228 Sep 2025Release notes
Open source →Fixed
- Turkish Currency: Fixed "kurus" to "kuruş" in Turkish Lira sub-unit name
- App Name: Updated partner app name to "Fida Invoice" in English
-
2.0.128 Sep 2025Release notes
Open source →Added
- Support Section: Added support section for Fida Invoice app in README
- Partnership: Official partnership with Fida Invoice - professional invoice application
-
2.0.028 Sep 2025Release notes
Open source →Added
- Turkish Language Support: Complete number-to-word conversion for Turkish language
- Multi-language Currency Units: Currency units now support Persian, English, and Turkish
- Smart Pluralization: Automatic singular/plural handling for English currencies
- Extensible Architecture: Easy to add new languages via
addLanguage()method - Comprehensive Currency Support: 7 predefined currencies with proper localization
- Enhanced Testing: 100% test coverage with edge cases and performance tests
- Complete Documentation: Comprehensive README, usage guide, and API documentation
Changed
- BREAKING: Refactored
CurrencyConfigto useMap<Language, String>for multi-language support - BREAKING: Currency methods now accept
countparameter for pluralization - BREAKING: Removed string-based currency parameters in favor of
CurrencyConfigobjects - Improved: Number conversion accuracy and conjunction word handling
- Improved: Performance optimizations for large number processing
- Enhanced: Error handling and input validation
Fixed
- Persian Conjunction: Fixed "و" placement - now correctly appears between groups but not at the end
- English Conjunction: Fixed "and" placement for decimal numbers
- Decimal Handling: Fixed handling of numbers like 10000.0 (no trailing conjunction)
- Turkish Grammar: Proper handling of "bin" and "yüz" without "bir" prefix
Deprecated
mainUnitandsubUnitgetters inCurrencyConfig(usegetMainUnit()andgetSubUnit()instead)CurrencyConfig.tomanRial,CurrencyConfig.dollarCent,CurrencyConfig.euroCent(renamed to clearer names)
Migration Guide
From 1.x to 2.0
Currency Configuration:
// Old converter.convert(amount, mainUnit: 'dollar', subUnit: 'cent'); // New converter.convert(amount, currency: CurrencyConfig.usDollar);Custom Currencies:
// Old // Not supported in 1.x // New final customCurrency = CurrencyConfig( mainUnits: { Language.en: 'token', Language.fa: 'ژتون', }, subUnits: { Language.en: 'bit', Language.fa: 'بیت', }, );Pluralization:
// Old - Manual handling final unit = amount == 1 ? 'dollar' : 'dollars'; // New - Automatic final unit = currency.getMainUnit(Language.en, count: amount);