Skip to content
Native Animation
Base Radio Group animation previewBase Radio Group animation preview

This preview uses fictional demo content. See the props below for the customization options available in this component.

npx nativeanimation add base-radio-group

Base Radio Group

React Native Radio Group Component

A radio group with spring-driven selection dots and configurable options, orientation, and theme.

Native Animation Base · Free · MIT

Add to your project

Copy the component and its assets into your app with the Native Animation CLI, or paste the agent prompt into Claude Code, Codex or Cursor once the MCP server is connected.

About this component

Related guides

A radio group with spring-driven selection dots and configurable options, orientation, and theme.

How it works

  1. Each row is a single tap target with a 48 dp Android or 44 pt iOS/web minimum height.
  2. The group controls selection while each radio animates its own dot.
  3. Labels and optional descriptions use the shared theme typography and colors.
  4. Horizontal and vertical layouts share the same interaction and accessibility model.

Install

npx nativeanimation add base-radio-group
npx expo install react-native-gesture-handler react-native-reanimated react-native-worklets

Usage

<BaseRadioGroup value={plan} onValueChange={setPlan} options={plans} />
<BaseRadio value="team" label="Team" description="For growing teams" selected={plan === 'team'} onPress={setPlan} />

Props

PropTypeDefaultDescription
valuestring—Controlled selected value.
defaultValuestring—Initial uncontrolled value.
onValueChange(value: string) => void—Called after a row is selected.
optionsBaseRadioOption[]requiredRadio values, labels, descriptions, and disabled flags.
orientation'vertical' | 'horizontal'verticalRow direction.
themeBaseThemeproviderOverrides the family theme.
testIDstring—Stable root identifier.

Compatibility

Expo SDK 58 · React Native 0.88 · Reanimated 4.7 · react-native-worklets 0.13. Runs on iOS, Android, and web in Expo Go or a development build.

Accessibility

The group exposes radiogroup; rows expose radio and their checked and disabled state. Reduced motion removes the dot and press animations but keeps selection immediate.

Source code

Loading public source…