Keyframery

Animated Date Picker for UI SDK

A field that opens a calendar unfolding from it, with the selected day gliding to its new place.

Part of Keyframery, the open-source animated components for UI SDK

The demo plays by itself. Point at it or press Tab to take over.

Installation

npx shadcn@latest add @keyframery/date-picker

This adds components/keyframery/date-picker.tsx and its primitive, components/keyframery/primitives/date-picker.tsx, to your project, and installs @ui-sdk/react. The motion tokens are added to your global CSS the first time you install a component.

Usage

import {
  CalendarDay,
  CalendarGrid,
  CalendarHeader,
  CalendarHeading,
  CalendarMonthSelect,
  CalendarNext,
  CalendarPrevious,
  CalendarWeekday,
  CalendarWeekdays,
  CalendarWeeks,
  CalendarYearSelect,
  DatePicker,
  DatePickerClear,
  DatePickerContent,
  DatePickerField,
  DatePickerHint,
  DatePickerInput,
  DatePickerPreset,
  DatePickerTrigger,
} from "@/components/keyframery/date-picker"

The parts and props are the same as UI SDK's Date Picker. For every prop, see the UI SDK date picker reference.

Next.js with cacheComponents

The date picker reads today's date while it renders. With cacheComponents turned on, render it inside <Suspense> after await connection(). See the fix.

What moves

MoveWhat you see
UnfoldThe calendar unfolds from the field.
GlideInside, the selected-day key glides to its new place.
DirectionMonths slide in from the side you turned to.

Timing and springiness follow the motion style you set, so this component moves like the rest of your app.

Swap the import

Already using UI SDK's date picker with your own styles? Keep your markup and change one line. The primitive adds motion and nothing else.

// Before
import { … } from "@ui-sdk/react/date-picker"

// After: same parts, same props, now animated
import { … } from "@/components/keyframery/primitives/date-picker"

Parts

The finished component exports 19 parts:

CalendarDay, CalendarGrid, CalendarHeader, CalendarHeading, CalendarMonthSelect, CalendarNext, CalendarPrevious, CalendarWeekday, CalendarWeekdays, CalendarWeeks, CalendarYearSelect, DatePicker, DatePickerClear, DatePickerContent, DatePickerField, DatePickerHint, DatePickerInput, DatePickerPreset, DatePickerTrigger

Accessibility

Keyboard, focus and screen-reader behaviour come from UI SDK and are not changed. With reduced motion turned on, nothing in the date picker moves: changes happen at once or with a short fade. More in Accessibility.

Source

The code that lands in your project. It is yours to change.

Questions

How does the animated Date Picker for UI SDK move?

Unfold: The calendar unfolds from the field. Glide: Inside, the selected-day key glides to its new place. Direction: Months slide in from the side you turned to.

Do I need Motion or Framer Motion for the animated Date Picker?

No. Every move is plain CSS, so there is nothing to install besides the component and UI SDK.

Can I keep my own styling and only take the motion?

Yes. Import from @/components/keyframery/primitives/date-picker instead. It has the same parts and props as @ui-sdk/react/date-picker and adds motion only.

What happens to the Date Picker when someone turns on reduced motion?

Nothing moves. State changes happen at once, or with a short fade.

On this page