A polished country dropdown where users pick exactly one option. A built-in search filters large lists instantly, rows show country flags with labels, and a radio check marks the active choice. The trigger displays the selected country for a clean, form-friendly experience on mobile and web.

Functionality

• Single-select list with radio indicators and focused row highlight

• Inline search with debounce and min-chars threshold

• Rows with flag icon + country name; optional ISO code and dial code

• Favorites/pinned countries at top (e.g., current/most used)

• Regional grouping with headers and dividers (optional)

• Clear selection & placeholder states; initial value support

• Disabled items and read-only mode

• Keyboard navigation: ↑/↓ to move, Enter/Space to select, Esc to close

• Async/API or local datasource with loading/empty/error states

• Virtualized scrolling for large datasets (200+ options)

• Smart overlay positioning, portal rendering, outside-click close

• Form integration: required/validation, helper & error text, onChange

• Accessibility: ARIA combobox, focus management, screen-reader labels

• Localization & RTL support; localized country names

• Theming controls: radius, colors, shadows, spacing, typography

• Responsive and safe-area aware for phones, tablets, and desktop

Use cases

• Country field in sign-up, checkout, or KYC forms

• Shipping/billing address selection in e-commerce

• Travel/booking filters and passenger details

• Admin dashboards for market/country settings

• Phone number onboarding paired with dial code selector

• Analytics/report builders for country scoping

• Content or feature availability by region

• Marketplace profile location and seller onboarding

• SaaS workspace defaults (e.g., default country)

• Support/help centers collecting user location

Keywords
country select, country dropdown, single select, radio list, flag icons, search country, typeahead, debounced search, ISO 3166, dial code, phone code, favorites pin, grouped by region, sticky headers, clear selection, placeholder, disabled options, required field, validation, initial value, async options, API data, loading state, empty state, virtualization, portal overlay, smart positioning, keyboard navigation, ARIA combobox, accessibility, localization, RTL support, responsive UI, mobile web, form field, admin dashboard, booking form, Flutter widget, FlutterFlow component, custom theming.