AddThisFeature

Currency Input

Let people enter money naturally without rounding surprises.

moderate Forms & Input

What it adds

A money field that keeps currency selection separate from the amount and stores exact values, not floats.

What your agent is told to do

6
  1. 1

    Store money as integer minor units or a fixed-precision decimal. Never a floating-point number — 0.1 + 0.2 is not 0.3, and money bugs found in production are always expensive.

  2. 2

    Keep currency selection a distinct value from the amount. An amount without a currency is meaningless, and a currency inferred from the user's locale will be wrong for anyone working across borders.

  3. 3

    Handle currencies whose minor unit is not two digits: JPY and KRW have none, BHD and KWD have three. A hardcoded ×100 is a real defect for real users.

  4. 4

    Parse the separators the user's locale actually uses — 1.234,56 and 1,234.56 are the same amount. Accept both rather than rejecting one.

  5. 5

    Decide and document how negative amounts are entered and shown, including the parenthesis convention in accounting contexts.

  6. 6

    Caret behaviour, paste handling, and separator insertion are owned by Input Masks; extend that rather than writing a second masking implementation. Read-only formatting of stored amounts is owned by Locale-Aware Numbers and Dates.

Edge cases it handles

6
  • Changing currency after typing an amount must not silently convert it — clarify whether the number stays or resets.
  • More decimal places than the currency allows must be handled by an explicit rounding rule, not truncated at random.
  • Very large amounts must not lose precision at the boundaries of the storage type.
  • An empty field and a zero amount are different; do not collapse them.
  • Amounts displayed after storage must match what was typed, to the minor unit.
  • The numeric keyboard on mobile must offer the decimal separator the locale actually uses.

Definition of done

8
  • Amounts are stored as minor units or fixed-precision decimals, never floats.
  • Currency is an explicit field, never inferred from locale alone.
  • Zero-decimal and three-decimal currencies round-trip correctly.
  • Both comma and full-stop decimal conventions parse to the same value.
  • Negative and zero amounts have defined, documented behaviour.
  • A stored amount redisplays exactly as it was entered.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.