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

@aphrody/shenron-ui

v1.4.7

Published

Shenron's single UI layer: Dragon Ball design system, site components, readers, admin primitives, the Koharu manga editor and the desktop studio.

Readme

Portable Dragon Ball interface package

@aphrody/shenron-ui contains the visual layer used by the Shenron site. Its runtime source imports neither Shenron application code nor Next.js. React is a peer; @base-ui/react, React Query, and the small styling helpers are ordinary dependencies. A host supplies routes, authorization, content, translations, data fetching, and optimized image rendering.

Entry points

  • @aphrody/shenron-ui/server: server-safe SVG, page layout, navigation frames, skeletons, and read-only admin presentation.
  • @aphrody/shenron-ui/client: interactive controls and the optional React Query provider. It includes the full Base UI wrapper set, public filters, the mega menu, and the admin sidebar view. Import this entry only from a client boundary.
  • @aphrody/shenron-ui/public and @aphrody/shenron-ui/admin: public and admin presentation.
  • @aphrody/shenron-ui/toriyama, @aphrody/shenron-ui/svg, @aphrody/shenron-ui/cinematic: themed components and the pure SVG geometry helpers.
  • @aphrody/shenron-ui/styles.css, @aphrody/shenron-ui/site.css, and @aphrody/shenron-ui/toriyama.css: Tailwind v4 tokens, the site visual layer, and Toriyama effects. styles.css registers the package sources with Tailwind when installed under node_modules.
  • @aphrody/shenron-ui/barre-nav.css, @aphrody/shenron-ui/editor.css, and @aphrody/shenron-ui/editorial.css: optional navigation and editorial surfaces.
  • @aphrody/shenron-ui/assets: paths to the 24 bundled interface SVG, PNG, and ICO assets. Content images and fonts belong to the host.
  • @aphrody/shenron-ui/reader: manga, collection, and databook readers. The reader styles are @aphrody/shenron-ui/reader-styles.css and @aphrody/shenron-ui/reader-dragon-ball.css.

The package provides ordinary <a> and <img> defaults. A framework host can pass its own link component to TabNav, NavMega, AdminSidebarView, Chip, EmptyState, and StatTiles, and an image renderer to PageHero. The Shenron site does this through small adapters in apps/site/src/components.

JsonLd, Markdown, and VideoSourceSummary are server-safe presentation helpers. ApiAccess is client-side because it uses the browser clipboard; it receives paths and labels as props and makes no API request itself.

To copy the assets to a host public directory, run:

bun node_modules/@aphrody/shenron-ui/scripts/sync-assets.ts --to ./public

Use --check to verify an existing copy. The script never removes other files.

The host can load the visual layer from one package:

@import "tailwindcss";
@import "@aphrody/shenron-ui/styles.css";
@import "@aphrody/shenron-ui/site.css";
@import "@aphrody/shenron-ui/toriyama.css";

Import barre-nav.css, editor.css, or editorial.css only for the surfaces that use them. The package scans its own source for Tailwind classes.

Tailwind v4 excludes node_modules during automatic source detection, so styles.css deliberately declares @source "."; do not replace it with a global safelist. Build class names as complete strings. CSS modules can use @reference "@aphrody/shenron-ui/styles.css" when they need tokens without emitting a second copy of the stylesheet. See the Tailwind source-detection guide.

The Base UI wrappers use its v1 data attributes and provide visible keyboard focus styles. When composing them, forward both the ref and props and use Base UI's render API. See Base UI accessibility.

Application boundary

| In this package | Supplied by the host | | --------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | | Base UI controls, Toriyama vectors, geometry, layouts, content cards, pagers, navigation and admin presentation | Route matching, launch catalogue, translations, auth and editorial data | | Reader components, scoped stylesheets and 24 generated or vector interface assets | Fonts and content media | | Default HTML links and images | Optional router links and optimized image renderer |

apps/site keeps the thin Next adapters and its domain screens. The server entry renders React views; it does not provide an HTTP server or Shenron APIs.

Checks

From the repository root:

bun --filter @aphrody/shenron-ui typecheck
bun --filter @aphrody/shenron-ui test
bun --filter @aphrody/shenron-ui portability:check
bun packages/ui/scripts/generate-tokens.ts --check
bun packages/ui/scripts/sync-assets.ts --to apps/site/public --check
bun packages/ui/scripts/check-css-equivalence.ts

The tarball has also been installed in a separate Bun project and checked with server rendering, client imports, asset reads, and Tailwind compilation. This is a source package for Bun and Tailwind v4 consumers. No registry release or deployment is implied by the repository checks. The host supplies fonts and content media.

Readers and their styles have one owner: @aphrody/m3-reader. The existing @aphrody/shenron-ui/reader, reader-styles.css and reader-dragon-ball.css exports delegate to that package. The Dragon Ball skin retains the live --dbz-* variables; route adapters, transcription fetching and editorial rules stay in the site. @aphrody/shenron-ui/use-focus-trap shares the M3 modal lifecycle. The reader stylesheet registers its own Tailwind sources, including isolated installs.

Production build check

bun --filter @aphrody/shenron-ui build:check

This builds the five public TypeScript entry points in memory with Bun's browser target, ESM output, dependency externals, tree-shaking, full minification, a closed dynamic-import policy, and environment injection disabled. It also compiles all nine stylesheets through the Tailwind v4 PostCSS plugin with minification, then reports byte counts. No dist is written: this package ships source so each host can tree-shake exactly the entry points it consumes. Bun's bundler options are documented at bun.com/docs/bundler.