jogalanza/ui-kit

Shared Vue 3 component library, distributed as independent npm packages published to GitHub Packages under the @jogalanza scope. npm workspaces monorepo:

packages/
  core-ui/      @jogalanza/ui-kit-core — shared shadcn-vue primitives (Badge, Button, Checkbox,
                Dialog, DropdownMenu, Input, NativeSelect, Popover, Separator, Switch, Table,
                Toaster), the cn() util, and the notify()/notifyError()/notifyResult() toast
                helpers. Dual-purpose: published directly (for projects that want the primitives
                on their own) AND bundled into other ui-kit packages at build time (e.g.
                filterbar), so those stay fully self-contained without their own peer dependency.
  filterbar/    @jogalanza/filterbar — badge-style popover filter bar.

Adding a new component package

1. packages/<name>/ with its own package.json (copy packages/filterbar/package.json as a template — same peerDependencies, same publishConfig pointing at GitHub Packages) and vite.config.js (copy packages/filterbar/vite.config.js; keep peer deps external, leave @jogalanza/ui-kit-core bundled).
2. Add "@jogalanza/ui-kit-core": "*" to its devDependencies (not dependencies — it's bundled at build time, so it should never be installed separately by consumers of the leaf package) and import primitives from it, e.g. import { Button, Popover } from '@jogalanza/ui-kit-core'. A project that wants core-ui's primitives directly (not through a leaf package) can instead add @jogalanza/ui-kit-core as a normal dependency.
3. If the component needs a primitive that doesn't exist in core-ui yet, add it there (not locally) so future components can reuse it too.
4. npm install at the repo root to link the new workspace. Build core-ui before any package that bundles it (npm run build --workspace=packages/core-ui first) — its main/exports point at its own built dist, not raw source.

Develop

npm install
npm run build --workspace=packages/<name>