dinero-best-practices

# Dinero.js Best Practices for Multi-Currency E-Commerce

## Core Principles
- **Always initialize Dinero with a currency code** (e.g., `USD`, `EUR`) to ensure consistent formatting and calculations.
- **Use `setLocale()`** to match the user's regional settings for proper number formatting.

## Implementation Tips
### 1. Currency Conversion
```javascript
import { Dinero } from 'dinero.js';

const basePrice = Dinero({ amount: 1000, currency: 'USD' });
const exchangeRate = 0.85; // 1 USD = 0.85 EUR
const convertedPrice = basePrice.multiply(exchangeRate).toUnit();
```

### 2. Tax Calculations
```javascript
const subtotal = Dinero({ amount: 5000, currency: 'USD' });
const taxRate = 0.0825; // 8.25%
const tax = subtotal.multiply(taxRate).toUnit();
const total = subtotal.add(tax);
```

### 3. Rounding Strategies
```javascript
// Round to nearest cent (default behavior)
const rounded = Dinero({ amount: 12345, currency: 'USD' }).toUnit(); // 123.45

// Custom rounding (e.g., floor)
const floored = Dinero({ amount: 12345, currency: 'USD' }).toUnit(Math.floor); // 123.45 → 123.45
```

## Common Pitfalls
- ❌ **Avoid floating-point arithmetic** – Dinero uses integers for precision.
- ❌ **Don’t hardcode currency symbols** – Use `Dinero.toFormat()` for locale-aware formatting.

Need help with a specific scenario? Share your use case!