registry-component-patterns

Register components in registry.json by creating an entry with the component file path and including retro.css in the files array. This enables discovery through the shadcn/ui add workflow and ensures visual consistency across your 8-bit component library.

Component entries register single UI elements pointing to one file, while block entries define pre-built layouts combining multiple components. Both require registry.json entries and retro.css inclusion for proper integration.

Retro.css must be included in the files array to maintain visual consistency across all 8-bit components. Omitting it breaks the styling and appearance of registered components in the library.

After creating your registry.json entry with the component file path and retro.css, test it by running pnpm dlx shadcn@latest add @8bitcn/your-component to verify the component installs and integrates correctly.

Registry entries require the component file path, retro.css in the files array, gaming-like categories, and base dependencies. This metadata enables seamless discovery and quick integration when users add your component.

Registry patterns apply when expanding the 8-bit component library with new components or blocks. Follow the entry pattern format to ensure compatibility with the shadcn/ui add workflow.