Picking The Right Library
This repository (Asymmetric-al/core)
This lookup skill is explicit-only. Core already chose Base UI and the
base-maia style in packages/ui. Keep disable-model-invocation: true.
Reconcile this overlay after upstream refreshes before running
bun run skills:sync.
Triggers
- The user explicitly asks which library to use, or invokes
pick-ui-library.
- Do not auto-route ordinary UI implementation through this skill.
Workflow
- Check the relevant
package.json first. Prefer libraries already installed.
- Do not churn Base UI /
base-maia for an upstream pick.
- If the task is already covered by
packages/ui, use that shared component.
- Do not install Zustand. Local state is
useState / useReducer. Shared UI
state is React Context. Server state stays on TanStack Query or
@asym/database collections.
- Command menus use
@asym/ui Command. OTP fields use @asym/ui
InputOTP. Do not add another cmdk or input-otp package.
Checklist
When invoked without a concrete task, briefly ask for the objective. If a task or question is already present, continue its workflow immediately.
A lookup skill. When invoked with a task ("I need toasts", "what should I use for drag and drop?"), match the task to the curated list below and recommend the library. These are deliberate, taste-driven picks — don't substitute alternatives outside this list unless the user asks for one or the task genuinely isn't covered.
How to use this
- Identify the task, not the library the user named. "I need to show a dropdown" is a UI-primitives task (base-ui), even if they asked about something else.
- Check what's already installed. Look at
package.json first. If the project already uses a listed library, use it. If it uses a competitor (e.g. react-window instead of Virtuoso), flag the recommendation but don't churn the dependency without being asked.
- Recommend one library, state what it's for in one sentence, and install/wire it up if that's part of the request. Don't present a menu of options when the list has a clear answer.
- If the task isn't covered by the list, say so explicitly and recommend from your own knowledge — but be clear you've left the curated list.
The list
UI components & primitives
| Task |
Library |
| Unstyled, accessible UI components (dialogs, popovers, menus, selects…) |
base-ui |
| Command menus (⌘K palettes) |
@asym/ui Command (packages/ui/components/shadcn/command.tsx). Do not add another cmdk tree. |
| Toasts / notifications |
Sonner |
| OTP / verification code inputs |
@asym/ui InputOTP (packages/ui/components/shadcn/input-otp.tsx). Do not add another input-otp package. |
| Customizable GUIs / control panels |
Leva — dialkit is an alternative |
Motion & visuals
| Task |
Library |
| General-purpose animation (springs, layout animations, enter/exit) |
motion (Framer Motion) |
| Animating numbers (counters, prices, stats) |
NumberFlow |
| Animated text components |
torph |
| 3D globes |
Cobe |
| Dynamic OG images (HTML/CSS → SVG/PNG) |
Satori |
| Syntax highlighting |
shiki |
Reach for motion when you need springs, layout animations, exit animations, or gesture-driven values. A simple hover or fade doesn't need it — plain CSS transitions are the right tool there.
Charts
| Task |
Library |
| Real-time / streaming charts |
Liveline |
| General charts (static or interactive dashboards) |
recharts |
The split: if data points arrive live and the chart scrolls with time, use Liveline. Everything else is recharts.
Interaction & performance
| Task |
Library |
| Drag and drop |
dnd kit |
| Virtualization (long lists, large tables) |
Virtuoso |
State & styling
| Task |
Library |
| State management |
Local useState / useReducer; React Context for shared UI state. Do not install Zustand. |
Constructing className strings conditionally |
clsx |
| Type-safe, variant-driven styling for Tailwind |
cva |
| Theme switching / dark mode (no flash on load) |
next-themes |
The styling split: clsx for ad-hoc conditional classes; cva when a component has real variants (size, intent, state) that deserve a typed API. They compose — cva uses clsx-style inputs internally.
Common mismatches to catch
- Toasts built by hand or with a modal library → Sonner exists for exactly this.
- A
<div>-based dropdown/dialog with manual focus handling → base-ui, which handles accessibility, focus trapping, and dismissal.
- Animating a number by re-rendering text → NumberFlow handles digit transitions properly.
- Rendering a 1,000+ row list directly → Virtuoso before reaching for pagination hacks.
- A
useState-per-component web of props for shared state → lift with useState / useReducer, or React Context for shared UI state. Do not install Zustand.
- Template-literal className ternaries three conditions deep → clsx (or cva if it's variant-shaped).
1---2name: pick-ui-library3description: Pick the right library for a given frontend task from a curated, opinionated list — numbers, OTP inputs, charts, command menus, virtualization, drag and drop, toasts, state, styling, and more. Only runs when explicitly invoked; it does not trigger on its own.4disable-model-invocation: true5metadata:6 source: https://skillmd.com/skills/asymmetric-al/pick-ui-library7---89# Picking The Right Library1011<!-- CORE-OVERLAY-START -->1213## This repository (Asymmetric-al/core)1415This lookup skill is explicit-only. Core already chose Base UI and the16`base-maia` style in `packages/ui`. Keep `disable-model-invocation: true`.17Reconcile this overlay after upstream refreshes before running18`bun run skills:sync`.1920### Triggers2122- The user explicitly asks which library to use, or invokes `pick-ui-library`.23- Do not auto-route ordinary UI implementation through this skill.2425### Workflow26271. Check the relevant `package.json` first. Prefer libraries already installed.282. Do not churn Base UI / `base-maia` for an upstream pick.293. If the task is already covered by `packages/ui`, use that shared component.304. Do not install Zustand. Local state is `useState` / `useReducer`. Shared UI31 state is React Context. Server state stays on TanStack Query or32 `@asym/database` collections.335. Command menus use `@asym/ui` `Command`. OTP fields use `@asym/ui`34 `InputOTP`. Do not add another `cmdk` or `input-otp` package.3536### Checklist3738- [ ] Invocation was explicit.39- [ ] Existing Core dependencies and Base UI ownership are preserved.4041<!-- CORE-OVERLAY-END -->4243When invoked without a concrete task, briefly ask for the objective. If a task or question is already present, continue its workflow immediately.4445A lookup skill. When invoked with a task ("I need toasts", "what should I use for drag and drop?"), match the task to the curated list below and recommend the library. These are deliberate, taste-driven picks — don't substitute alternatives outside this list unless the user asks for one or the task genuinely isn't covered.4647## How to use this48491. **Identify the task**, not the library the user named. "I need to show a dropdown" is a UI-primitives task (base-ui), even if they asked about something else.502. **Check what's already installed.** Look at `package.json` first. If the project already uses a listed library, use it. If it uses a competitor (e.g. react-window instead of Virtuoso), flag the recommendation but don't churn the dependency without being asked.513. **Recommend one library**, state what it's for in one sentence, and install/wire it up if that's part of the request. Don't present a menu of options when the list has a clear answer.524. If the task isn't covered by the list, say so explicitly and recommend from your own knowledge — but be clear you've left the curated list.5354## The list5556### UI components & primitives5758| Task | Library |59| ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |60| Unstyled, accessible UI components (dialogs, popovers, menus, selects…) | [base-ui](https://base-ui.com) |61| Command menus (⌘K palettes) | `@asym/ui` `Command` (`packages/ui/components/shadcn/command.tsx`). Do not add another `cmdk` tree. |62| Toasts / notifications | [Sonner](https://sonner.emilkowal.ski) |63| OTP / verification code inputs | `@asym/ui` `InputOTP` (`packages/ui/components/shadcn/input-otp.tsx`). Do not add another `input-otp` package. |64| Customizable GUIs / control panels | [Leva](https://github.com/pmndrs/leva) — [dialkit](https://joshpuckett.me/dialkit) is an alternative |6566### Motion & visuals6768| Task | Library |69| ------------------------------------------------------------------ | -------------------------------------------- |70| General-purpose animation (springs, layout animations, enter/exit) | [motion](https://motion.dev) (Framer Motion) |71| Animating numbers (counters, prices, stats) | [NumberFlow](https://number-flow.barvian.me) |72| Animated text components | [torph](https://torph.lochie.me/) |73| 3D globes | [Cobe](https://cobe.vercel.app) |74| Dynamic OG images (HTML/CSS → SVG/PNG) | [Satori](https://github.com/vercel/satori) |75| Syntax highlighting | [shiki](https://shiki.style) |7677Reach for motion when you need springs, layout animations, exit animations, or gesture-driven values. A simple hover or fade doesn't need it — plain CSS transitions are the right tool there.7879### Charts8081| Task | Library |82| ------------------------------------------------- | --------------------------------------------------- |83| Real-time / streaming charts | [Liveline](https://github.com/benjitaylor/liveline) |84| General charts (static or interactive dashboards) | [recharts](https://recharts.org) |8586The split: if data points arrive live and the chart scrolls with time, use Liveline. Everything else is recharts.8788### Interaction & performance8990| Task | Library |91| ----------------------------------------- | -------------------------------- |92| Drag and drop | [dnd kit](https://dndkit.com) |93| Virtualization (long lists, large tables) | [Virtuoso](https://virtuoso.dev) |9495### State & styling9697| Task | Library |98| ---------------------------------------------- | ------------------------------------------------------------------------------------------- |99| State management | Local `useState` / `useReducer`; React Context for shared UI state. Do not install Zustand. |100| Constructing `className` strings conditionally | [clsx](https://github.com/lukeed/clsx) |101| Type-safe, variant-driven styling for Tailwind | [cva](https://cva.style) |102| Theme switching / dark mode (no flash on load) | [next-themes](https://github.com/pacocoursey/next-themes) |103104The styling split: clsx for ad-hoc conditional classes; cva when a component has real variants (size, intent, state) that deserve a typed API. They compose — cva uses clsx-style inputs internally.105106## Common mismatches to catch107108- **Toasts built by hand or with a modal library** → Sonner exists for exactly this.109- **A `<div>`-based dropdown/dialog with manual focus handling** → base-ui, which handles accessibility, focus trapping, and dismissal.110- **Animating a number by re-rendering text** → NumberFlow handles digit transitions properly.111- **Rendering a 1,000+ row list directly** → Virtuoso before reaching for pagination hacks.112- **A `useState`-per-component web of props for shared state** → lift with `useState` / `useReducer`, or React Context for shared UI state. Do not install Zustand.113- **Template-literal className ternaries three conditions deep** → clsx (or cva if it's variant-shaped).