SoybeanUI

v0.29.0
GitHub
Language
Theme Configurator
Theme
Vue 3 Component System

SoybeanUI

A powerful, elegant Vue 3 component system with headless primitives and ready-to-use styled wrappers.

Library overview

93
Components
8
Categories
2
Packages
5
Guides

Two Ways to Use SoybeanUI

Choose the distribution mode that fits your workflow — npm package for quick integration, or CLI copy-paste for full source control.

npm Package

Traditional dependency

Install @soybeanjs/ui as a dependency. Auto-import, tree-shaking, and seamless updates via your package manager.

  • One-command install
  • Auto-import with unplugin-vue-components
  • Tree-shaking — only bundle what you use
  • Seamless updates via package manager
  • Nuxt module support
Install Package

CLI · Copy-Paste

shadcn-style

Copy source code into your project with sbean CLI. Full control, full customization — you own the code.

  • Components live in your source tree
  • Edit any file — full customization
  • sbean diff to review upstream changes
  • Only the components you add exist
  • Perfect for custom design systems
Try the CLI

Quick Setup

Install the package, wire the styling layer, and get the first screen rendering end to end.

Understand the Split

Review how the unstyled headless layer and the styled UI layer divide responsibility before choosing an integration strategy.

Browse the Catalog

Narrow the component choice set quickly by scanning primitives, patterns, and utilities by category.

Configure Theming

Learn how tokens, variants, and ui slot overrides work together before deeper customization.

Core Features

Headless First

@soybeanjs/headless focuses on state, behavior, and accessibility semantics without shipping any visual styling.

Styled Wrappers

@soybeanjs/ui ships S-prefixed styled components so common product surfaces can be delivered without rebuilding presentation from scratch.

Accessibility Built In

Follows WAI-ARIA patterns with keyboard navigation, focus management, and semantic state handling included.

Type-safe APIs

Built with TypeScript so components, slots, and configuration surfaces stay explicit during implementation.

Slot-level Overrides

Override local styling precisely through ui slot maps instead of rewriting entire components.

Theme-ready Variants

Variants are organized with UnoCSS and @soybeanjs/cva so design tokens and themes stay scalable.

Broad Component Coverage

Covers general UI, forms, navigation, overlays, and data display for the screens teams build most often.

Vue Ecosystem Friendly

Works smoothly with Nuxt, auto-import workflows, and living examples that shorten adoption time.