mirror of https://github.com/DumbWareio/DumbAssets.git synced 2026-01-23 13:17:54 +08:00

feat: add multi-currency support via environment variables (#66 )

- Add CURRENCY_CODE and CURRENCY_LOCALE environment variables in server.js
- Inject currency configuration into frontend via dynamic config.js endpoint
- Update formatCurrency() function to use global app config for dynamic currency formatting
- Support any ISO 4217 currency code with proper locale-specific formatting
- Add comprehensive currency configuration documentation (CURRENCY_CONFIG.md)
- Update README.md with currency environment variables and collapsible configuration guide
- Include Docker/Docker Compose configuration examples for currency settings
- Maintain backward compatibility with USD/en-US defaults

Supported currencies include USD, EUR, GBP, CAD, AUD, JPY, and any valid ISO 4217 code.
Currency formatting respects locale-specific conventions (e.g., €1.234,56 for de-DE).

add docs folder

Stringify currency object and update docs

Adding responsive card values to wrap large values

2025-06-09 00:53:40 -04:00

2.6 KiB

Raw Permalink Blame History

Currency Configuration

DumbAssets supports multiple currencies via environment variables. The application uses the standard ISO 4217 currency codes and locale formatting.

Environment Variables

`CURRENCY_CODE`

Default: USD
Description: The ISO 4217 currency code for price formatting
Examples: USD, EUR, GBP, CAD, AUD, JPY

`CURRENCY_LOCALE`

Default: en-US
Description: The locale for currency formatting (affects number formatting, decimal separators, etc.)
Examples: en-US, en-GB, de-DE, fr-FR, ja-JP

Usage Examples

US Dollar (Default)

# No configuration needed - this is the default

Euro (Germany)

export CURRENCY_CODE=EUR
export CURRENCY_LOCALE=de-DE

British Pound

export CURRENCY_CODE=GBP
export CURRENCY_LOCALE=en-GB

Canadian Dollar

export CURRENCY_CODE=CAD
export CURRENCY_LOCALE=en-CA

Japanese Yen

export CURRENCY_CODE=JPY
export CURRENCY_LOCALE=ja-JP

Docker Configuration

Docker Compose

services:
  dumbassets:
    environment:
      - CURRENCY_CODE=EUR
      - CURRENCY_LOCALE=de-DE

Docker Run

docker run -e CURRENCY_CODE=EUR -e CURRENCY_LOCALE=de-DE dumbassets

Currency Format Examples

Different locales will format the same amount differently:

Locale	Currency	Amount: 1234.56	Formatted Output
en-US	USD	1234.56	$1,234.56
de-DE	EUR	1234.56	1.234,56 €
en-GB	GBP	1234.56	£1,234.56
fr-FR	EUR	1234.56	1 234,56 €
ja-JP	JPY	1234.56	¥1,235

Technical Implementation

The currency configuration is:

Set via environment variables in server.js
Injected into the frontend via the dynamic config.js endpoint
Used by the formatCurrency() function in public/helpers/utils.js
Applied consistently across all currency displays in the application

Supported Currency Codes

Any valid ISO 4217 currency code is supported. Common examples include:

USD - US Dollar
EUR - Euro
GBP - British Pound
CAD - Canadian Dollar
AUD - Australian Dollar
JPY - Japanese Yen
CHF - Swiss Franc
CNY - Chinese Yuan
INR - Indian Rupee
BRL - Brazilian Real
MXN - Mexican Peso
SEK - Swedish Krona
NOK - Norwegian Krone
DKK - Danish Krone

For a complete list, refer to the ISO 4217 standard.

2.6 KiB Raw Permalink Blame History