npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@puzzle-ui/ui

v0.12.0

Published

Composable React UI components with typed APIs for Puzzle applications

Readme

@puzzle-ui/ui — React UI component library

Composable, token-driven React components with TypeScript APIs for building forms, responsive layouts, navigation, and overlays with Puzzle. Browse live component examples, props, and accessibility guidance in the documentation.

Documentation: https://puzzle-ui.com/docs/ui

Component API maturity is listed on each component's documentation page. Button, Button Group, and Toggle Group, including ToggleGroup.Item, have Stable public APIs with component/browser coverage and backward-compatibility intent within a major version. SectionHeader is Beta while its shared section API is exercised by upcoming Pieces families. Paper, Skeleton, Label, Background, Breadcrumbs, Sidebar, and Backdrop are Experimental because their current validation evidence is limited. Review documented accessibility and framework details when integrating components.

@puzzle-ui/ui provides composable, router-independent React components: actions, data display, editors, forms, layout, navigation, overlays, typography, and utilities. Components use semantic HTML and native browser behavior first, and all styling comes from the CSS custom properties supplied by @puzzle-ui/theme, so one Theme provider styles your whole application.

Install

npm install @puzzle-ui/ui @puzzle-ui/theme
# or
bun add @puzzle-ui/ui @puzzle-ui/theme
# or
pnpm add @puzzle-ui/ui @puzzle-ui/theme
# or
yarn add @puzzle-ui/ui @puzzle-ui/theme

React and React DOM 19 are peer dependencies and should already be installed in your application.

To start a new project with Puzzle preconfigured, run npx @puzzle-ui/create.

Usage

Wrap your application in Theme and import components from @puzzle-ui/ui:

import { Theme } from "@puzzle-ui/theme";
import { Button, Stack, Text } from "@puzzle-ui/ui";

export const App = () => (
  <Theme>
    <Stack direction="col" gap="sm">
      <Text>Build your interface with Puzzle.</Text>
      <Button>Get started</Button>
    </Stack>
  </Theme>
);

Component categories

| Category | Components | | ------------ | ------------------------------------------------------------------------------------------------------------- | | Actions | Button, ButtonGroup, ToggleGroup | | Data display | Alert, Avatar, Badge, Card, EmptyState, Image, Paper, Progress, Rating, Skeleton | | Editors | TextEditor, TextEditorToolbar, TextRenderer | | Forms | Autocomplete, Checkbox, ColorPicker, DatePicker, FileUpload, FormField, inputs, Radio, Select, Slider, Switch | | Layout | AppBar, AspectRatio, Container, Grid, GridItem, PageLayout, ResizablePanels, ScrollArea, Section, SectionHeader, Separator, Sidebar, Stack | | Navigation | Accordion, Breadcrumbs, Carousel, Link, Pagination, Tabs, TreeView | | Overlays | Command, ContextMenu, Dialog, Drawer, DropdownMenu, Notification, Popover, Tooltip | | Typography | Heading, Text | | Utilities | Portal, Preview, ScrollLock, Transition |

Browse every component with live examples, props, and accessibility guidance in the component documentation.

Dialog headings accept React nodes and are associated with the dialog through an accessible heading relationship. Use a heading element when a dialog title needs richer markup.

Framework integration

Components do not depend on a router or framework. Use the components prop of Theme to provide your framework's link and image components; see Component Overrides.

Related packages