AddThisFeature

Phone Number Input

Accept phone numbers in the format people know and store them consistently.

moderate Forms & Input

What it adds

A phone field with explicit country selection that stores a canonical number while displaying a readable one.

What your agent is told to do

6
  1. 1

    Store the canonical international form (E.164) and display the national or international format the user recognises. One stored shape means matching, deduplication, and sending all work.

  2. 2

    Make country selection explicit and changeable. Browser locale is not phone country — expatriates, travellers, and anyone with a foreign SIM will be assigned the wrong one.

  3. 3

    Validate per country using real numbering rules, not a single length. Numbers range from about seven to fifteen digits and are not uniform inside one country.

  4. 4

    Capture an extension as a separate field. Appending it to the number breaks dialling and every downstream integration.

  5. 5

    Do not reject a number just because your library does not recognise its prefix. Numbering plans change; warn rather than block, unless the number is being used for delivery.

  6. 6

    Caret movement, separator insertion, and paste normalization are owned by Input Masks; extend that rather than writing a second masking implementation.

Edge cases it handles

6
  • A pasted number that already carries a country code must set the country selector, not be treated as a local number.
  • Leading zeros in national format must be dropped correctly when converting to E.164 and restored on display.
  • Some countries share a calling code (+1, +7); disambiguate by area code rather than guessing.
  • Existing stored numbers may not be canonical — migrate them rather than assuming the format on read.
  • The mobile keyboard must be a phone keypad, and must permit +, spaces, and dashes.
  • A number valid for display may still be undeliverable for SMS; verification, not validation, decides that.

Definition of done

8
  • Numbers are stored in E.164 and displayed in a readable national or international format.
  • Country selection is explicit, visible, and independent of locale.
  • Valid numbers from at least a dozen countries of differing lengths are accepted.
  • Extensions are stored separately from the number.
  • Pasting an international number sets the country correctly.
  • Unrecognised prefixes warn rather than block.
  • 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.