shadcn-errors-cmdk-version-drift

What problem does it solve?

It fixes shadcn ui Command component failures caused by drift between the shadcn registry-generated wrapper and the installed cmdk version, which can break filtering, clicking, focus, exports, and even crash rendering.

Core Features & Use Cases

• Diagnose drift causes quickly by mapping symptoms to the six common cmdk drift traps (filter signature mismatch, case-sensitive custom filtering, Vaul focus duel, shouldFilter=false full-list trap, CommandLoading export gap, and wrapper/core version mismatch).
• Apply correct, version-aware fixes including rewriting filter functions to the cmdk 1.0+ 3-argument signature, enforcing case normalization in custom filters, and regenerating or pinning cmdk so the wrapper matches the runtime API.
• Repair composition and runtime structure by ensuring CommandItem (and related subcomponents) are rendered under CommandList to avoid the Symbol.iterator crash, and by pairing shouldFilter=false with client/server filtering and a proper loading component.

Quick Start

Use the skill to troubleshoot a broken shadcn Command palette or Combobox by running the drift checks and then applying the matching fix strategy (pin cmdk, re-run shadcn add command --overwrite, or upgrade and migrate filter signatures).