react-native-element-dropdown, maintained.

📚 Full documentation →

A drop-in fork of react-native-element-dropdown. Bugs get fixed, the toolchain stays current, and every release is signed. Same API, same components (Dropdown, MultiSelect, SelectCountry), same props — change two lines and keep shipping.

npm install @carlos3g/element-dropdown

- import { Dropdown } from 'react-native-element-dropdown';
+ import { Dropdown } from '@carlos3g/element-dropdown';

Why this fork

The original package is unmaintained — a large open issue backlog, plus clean community PRs sitting untouched for years. If you're already on react-native-element-dropdown, you've probably hit at least one of these:

• Invariant Violation: scrollToIndex out of range when searching long lists
• The list flashes at the wrong position for a frame when you reopen it
• IDropdownRef / IMultiSelectRef missing when you build for web or Expo
• Every item has a non-overridable padding: 17 — itemContainerStyle can't shrink it
• MultiSelect trigger uses placeholderStyle even after you've selected something

Fixed — along with plenty more. See the roadmap in docs/upstream-triage.md and per-version detail in the release notes.

What you get

• Dropdown + MultiSelect + SelectCountry — three components, one package, same feel on iOS and Android
• Drop-in migration — public API unchanged from [email protected], peerDependencies: *
• Active maintenance — upstream bugs get triaged and fixed in every release; see the changelog for the current set
• Better defaults — per-item disable via disabledField, hitSlop for bigger tap targets, allowFontScaling, isInsideModal for nested Modal positioning
• Proper accessibility — trigger announces as combobox, items expose selected/disabled state
• A real test suite — integration tests cover the core interaction flows
• Signed releases — published via npm Trusted Publishing, with provenance attestation on every version

Quick example

import { useState } from 'react';
import { Dropdown } from '@carlos3g/element-dropdown';

const data = [
  { label: 'Apple', value: 'apple' },
  { label: 'Banana', value: 'banana' },
];

export function FruitPicker() {
  const [value, setValue] = useState<string | null>(null);
  return (
    <Dropdown
      data={data}
      labelField="label"
      valueField="value"
      placeholder="Pick a fruit"
      value={value}
      onChange={(item) => setValue(item.value)}
    />
  );
}

For the full API (Dropdown, MultiSelect, SelectCountry), migration guide, and 18 hands-on recipes, see the docs.

Use with AI assistants

This package is designed to work well with LLM-powered tools (Claude, Cursor, GitHub Copilot, ChatGPT, Aider, etc.):

• llms.txt / llms-full.txt — the docs site exposes both files at the root, following the llmstxt.org standard:
  • /llms.txt — short manifest with links to every page
  • /llms-full.txt — every doc page concatenated, optimized for a single fetch
• Rich JSDoc on every prop in DropdownProps, MultiSelectProps, and SelectCountryProps — your IDE's IntelliSense (and any AI integrated with it) sees @default, @example, and links to the matching guide for each prop.
• Stable, drop-in API — agents can safely refactor existing react-native-element-dropdown codebases just by changing the install name and import path.

Sample prompt

"I'm using @carlos3g/element-dropdown. Read its full documentation at https://carlos3g.github.io/element-dropdown/llms-full.txt and build me a <UserPicker> component that wraps MultiSelect, debounces search, paginates with onEndReached, and shows a sticky modal header with a counter."

Demo

Contributing

See the upstream triage at docs/upstream-triage.md for the current roadmap and the prioritized list of upstream issues and PRs worth porting. Issues and pull requests are the interface — please include a repro when filing.

License

MIT — see LICENSE. This is a fork; the original copyright is preserved in contributor metadata.