@zvk/ui

@zvk/ui is an internal React 19 component library for polished application interfaces. It is styled by default, TypeScript-first, dependency-conscious, and built around explicit subpath imports.

ZVK is short for Zero Vendor Kit.

import { Button } from "@zvk/ui/button";
import { Card } from "@zvk/ui/card";
import "@zvk/ui/styles.css";

Package Policy

• Runtime dependencies stay empty: dependencies: {}.
• Peer dependencies are limited to react and react-dom with React 19 compatibility.
• Styling ships through one public stylesheet: @zvk/ui/styles.css.
• Components use plain CSS classes, CSS variables, and data attributes.
• Runtime package imports remain SSR-safe; browser-only behavior runs after hydration.

Release Status

GitHub Actions runs bun run preflight:ci before release publishing. Release Please opens reviewable version-bump PRs from conventional commits; merging a release PR creates the GitHub release and publishes any package with a created release, including @zvk/ui, to npm through trusted publishing in the protected npm-publish environment.

Component Surface

The package ships dependency-free form controls, layout and display primitives, popup foundation internals, Dialog, Sheet, AlertDialog, Popover, HoverCard, Tooltip, Select, Combobox, DropdownMenu, ContextMenu, Menubar, Calendar, DatePicker, Carousel, Toast, and Conversation primitives.

License

This package is free to use but is not open source yet. You may use it in personal, internal, or commercial applications, but you may not redistribute, republish, resell, fork, mirror, or repackage it as a standalone library or competing component system. See LICENSE.md for details.

Repo Skill

Use .codex/skills/use-zvk-ui/SKILL.md when maintaining this package.