# Quick start

> Every picker in Patine UI in five minutes, with live, editable examples.

Each block below is a complete, runnable component. Edit it, and copy it straight into your app when you're done.

## Wheel

Pass primitives or `{ label, value }` objects.

```tsx live
import { useState } from 'react';
import { WheelPicker } from 'patine-ui';

export default function Example() {
  const [size, setSize] = useState('M');
  return (
    <WheelPicker
      items={['XS', 'S', 'M', 'L', 'XL', 'XXL']}
      value={size}
      onValueChange={setSize}
    />
  );
}
```

## Time

The 12h / 24h format comes from the locale automatically.

```tsx live
import { useState } from 'react';
import { TimePicker } from 'patine-ui';

export default function Example() {
  const [time, setTime] = useState(new Date());
  return <TimePicker value={time} onValueChange={setTime} minuteInterval={5} />;
}
```

## Date (calendar)

```tsx live
import { useState } from 'react';
import { DatePicker } from 'patine-ui';

export default function Example() {
  const [date, setDate] = useState<Date | null>(null);
  return <DatePicker value={date} onValueChange={setDate} minDate={new Date()} />;
}
```

## Date range

```tsx live
import { useState } from 'react';
import { Text } from 'react-native';
import { DatePicker, formatDate } from 'patine-ui';
import type { DateRange } from 'patine-ui';

export default function Example() {
  const [range, setRange] = useState<DateRange>({ start: null, end: null });
  return (
    <>
      <DatePicker
        mode="range"
        value={range}
        onValueChange={setRange}
        minDate={new Date()}
      />
      <Text style={{ textAlign: 'center', color: '#6E685E' }}>
        {range.start ? formatDate(range.start) : '—'} →{' '}
        {range.end ? formatDate(range.end) : '—'}
      </Text>
    </>
  );
}
```

## Date (wheel)

```tsx live
import { useState } from 'react';
import { DatePicker } from 'patine-ui';

export default function Example() {
  const [birthday, setBirthday] = useState(new Date(1990, 4, 17));
  return (
    <DatePicker
      display="wheel"
      value={birthday}
      onValueChange={setBirthday}
      maxDate={new Date()}
    />
  );
}
```

## Select

Tap the field to open the list: a bottom sheet on phones, a dropdown on the web. A search box appears past 8 options.

```tsx live
import { useState } from 'react';
import { Select } from 'patine-ui';

const languages = [
  { label: 'English', value: 'en' },
  { label: 'Español', value: 'es' },
  { label: 'Français', value: 'fr' },
  { label: 'Deutsch', value: 'de' },
  { label: 'עברית', value: 'he', keywords: ['hebrew'] },
];

export default function Example() {
  const [lang, setLang] = useState<string | null>(null);
  return (
    <Select
      label="Language"
      placeholder="Choose a language"
      options={languages}
      value={lang}
      onValueChange={setLang}
    />
  );
}
```

## Emoji

```tsx live
import { useState } from 'react';
import { Text } from 'react-native';
import { EmojiPicker } from 'patine-ui';

export default function Example() {
  const [text, setText] = useState('');
  return (
    <>
      <Text style={{ fontSize: 28, minHeight: 40 }}>{text}</Text>
      <EmojiPicker
        height={320}
        onSelect={(emoji) => setText((t) => t + emoji)}
      />
    </>
  );
}
```

## In a bottom sheet

Every picker also ships as a sheet. The sheet keeps a **draft** and only calls `onConfirm` when the user taps **Done** (**OK** in Material); **Cancel**, a backdrop tap or a swipe down discards it.

```tsx live
import { useState } from 'react';
import { DatePickerSheet, formatDate } from 'patine-ui';
import type { DateRange } from 'patine-ui';
import { DemoButton } from './DemoButton';

export default function Example() {
  const [open, setOpen] = useState(false);
  const [range, setRange] = useState<DateRange>({ start: null, end: null });
  return (
    <>
      <DemoButton
        title={
          range.start && range.end
            ? `${formatDate(range.start)} → ${formatDate(range.end)}`
            : 'Pick dates'
        }
        onPress={() => setOpen(true)}
      />
      <DatePickerSheet
        open={open}
        onOpenChange={setOpen}
        title="Check-in / Check-out"
        mode="range"
        value={range}
        onConfirm={setRange}
        minDate={new Date()}
      />
    </>
  );
}
```

## In a form field

A field opens the sheet for you and shows the confirmed value, so there's no open state to manage. Each sheet has one, such as `DatePickerField`, `TimePickerField`, `DateTimePickerField`, `WheelPickerField` and `EmojiPickerField`.

```tsx live
import { useState } from 'react';
import { View } from 'react-native';
import {
  DatePickerField,
  TimePickerField,
} from 'patine-ui';

export default function Example() {
  const [day, setDay] = useState<Date | null>(null);
  const [time, setTime] = useState<Date | undefined>();
  return (
    <View style={{ gap: 14 }}>
      <DatePickerField
        label="Date"
        placeholder="Pick a date"
        value={day}
        onConfirm={setDay}
        minDate={new Date()}
      />
      <TimePickerField
        label="Time"
        placeholder="Pick a time"
        value={time}
        onConfirm={setTime}
        minuteInterval={15}
      />
    </View>
  );
}
```

→ [Picker fields](../components/picker-fields)

## Pick a design

Each picker looks native on its platform by default. Use the switch at the top left of any example to see iOS, Android and Web. To use one look on every platform, set `design` on the provider or on one component:

```tsx live
import { useState } from 'react';
import { TimePicker } from 'patine-ui';

export default function Example() {
  const [time, setTime] = useState(new Date());
  return (
    <TimePicker
      design="material"
      value={time}
      onValueChange={setTime}
    />
  );
}
```

→ [Designs](../guides/designs)

## Next

- [Core concepts](./core-concepts): the few ideas every component shares
- [Components](../components/wheel-picker): full props for each picker
