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

@kahwee/runway-ui

v1.3.0

Published

React components and CSS for cozy simulation and management games

Readme

Runway UI

Package checks MIT license

React components and a cozy theme for management and simulation games.

Resource HUDs, desk workspaces, meters, inventories, native dialogs and charts, in a soft sweet-sim style. React 19 is required, with Base UI for form controls and TanStack Charts for charts. The CSS is also usable on its own.

MIT licensed. Free for personal and commercial projects, including closed-source games. Keep the license notice in redistributed copies. No attribution in your interface is required. See LICENSE.

Explore a real component state

Open the theme playground. Compare light Studio, dark Orbital and black Midnight using the same markup. Adjust content, width, status, progress and disabled state to inspect actual component behavior.

| Explore | What it demonstrates | | --- | --- | | Recipe book | Editable first components, copyable HTML and interaction contracts | | Paper studio | Warm surfaces, illustrated season cover and native controls | | Simulation Observatory | Metrics, history, resource inspection and decisions | | Colony | Production and a large virtual inventory | | Isolated components | Minimal imports verified without the full stylesheet | | Dependency recipes | Copyable markup and exact CSS requirements | | React components | React 19 integration using Base UI |

Find your way

Start with the installation below, then choose the resource for your task:

| Task | Resource | | ------------------------------------------ | ------------------------------------------------------------------------------------------------------- | | Learn the library and choose a guide | Documentation map | | Find classes, defaults and copyable markup | Component reference | | Try component states and theme controls | Storybook | | See components assembled into a screen | Workshop and Simulation Observatory | | Release a tested package | Release checklist and tag-only npm workflow | | Change the library itself | Contributing and repository layout |

The docs explain usage and contracts. Storybook is the interactive component explorer. Examples demonstrate compositions with synthetic data; they do not run a simulation.

Start with React

bun add @kahwee/runway-ui react react-dom @base-ui/react @tanstack/charts
import "@kahwee/runway-ui/bundle.css";
import { Button, Meter, Panel, Runway } from "@kahwee/runway-ui/react";

export function Briefing() {
  return (
    <Runway theme="cozy">
      <Panel kicker="Today" title="Morning briefing">
        <Meter label="Team energy" value={72} tone="morale" />
        <Button data-variant="primary">Next day</Button>
      </Panel>
    </Runway>
  );
}

The component list, props and chart usage are in the React guide. Coming from the vanilla modules? See migration. Themes (cozy, ledger, orbital, parchment, whimsy, midnight) are in theming.

Release status: @kahwee/[email protected] is the current release on npm and follows semantic versioning (see stability). The remaining vanilla modules (dialog, navigation, inventory) are deprecated and will be removed in a future major release. You can also install from GitHub with bun add github:kahwee/runway-ui. Development uses Bun 1.4.4; Node 24.11+ remains available for Storybook; CI uses Node 24.22.1.

CSS only

The committed bundle works without React or a build step:

<link rel="stylesheet" href="./runway-ui/dist/runway-ui.css">
<section class="rw-ui rw-panel" data-theme="cozy">
  <button class="rw-button" data-variant="primary">Launch</button>
</section>

Explore locally

bun run build-site
python3 -m http.server 4320 --bind 127.0.0.1 --directory .site

Open http://127.0.0.1:4320/docs/charts.html for the TanStack chart lab, or http://127.0.0.1:4320/docs/ for searchable component options. The root page is the component workshop. Other examples:

  • Illustrated workspace navigation: six generic destinations with original vector miniatures.
  • examples/colony.html: production, reserve history and a searchable 10,000-item synthetic inventory.
  • examples/drop-in.html: opt-in styling for existing native form controls.

The examples adapt from narrow phone canvases to desktop workspaces. Data, native controls and actions remain available at 320px and larger; the CSS library imposes no viewport gate.

What's included

| Module | Components | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | Foundations | Theme tokens, cascade layers, surfaces, typography, focus and state colors | | Primitives | Buttons, panels, badges, inputs, disclosures, native dialog styling | | Game patterns | Resource HUD, equipment slots, objectives, choices, action dock | | TanStack charts | TanStack columns, stacked/signed bars, lines, areas and horizontal bars; API and scale rules | | Simulation | Subgrid production ledger and container-aware panels | | Themes | Warm Studio, dark Orbital, Parchment, playful Whimsy Ledger and black Midnight; identical markup | | Optional behaviors | Native dialog dismissal policy, roving keyboard focus, standard controller adapter and fixed-height virtual inventory |

All component classes use rw-; the root rw-ui supplies inherited tokens without a global reset. Application styles can override the cascade layers. This is a CSS namespace, not Shadow DOM isolation.

Easy adoption

  1. Components: add the stylesheet, a rw-ui root and documented component classes.
  2. Existing forms: add rw-native to the root (included in the full bundle; @kahwee/runway-ui/native.css is a standalone form entry). Native submission and control semantics stay intact.
  3. Interactions: import only the optional modules you need; retain their handles and call destroy() on unmount.

Runway UI is not an API-compatible replacement for another UI framework. Existing custom widgets may need markup changes. The CSS core does not run a simulation, store saves or render a world.

Modern browser features

  • Subgrid aligns production rows with their parent's shared columns.
  • Container queries adapt panels to their allocated space.
  • Native HTML dialog supplies top-layer modality, focus and background inertness.
  • Cascade layers, logical properties, custom properties, color-mix() and :has() provide composition and theming.
  • @starting-style and discrete transitions enhance dialog motion when supported.
  • Reduced motion and forced colors adjust animation and state indicators.

Targets current desktop Chromium, Firefox and Safari with subgrid and container-query support. The optional dialog helper requires native showModal() and close(). Newer dismissal APIs are optional; the helper provides local fallbacks while keeping focus and inertness native. Dialog CSS uses :open. See dialog requirements. Desktop Chromium checks are documented in STATUS.md; broader browser and assistive-technology validation remains work in progress.

Documentation

Development

bun install --frozen-lockfile
bun run check
bun run check-boundaries
bun run test-boundaries
bun run test-dialog
bun run build
bun pm pack --dry-run

The library has no third-party runtime dependencies or remote font/asset requests. Development installation downloads tooling and icon/font inputs; Storybook bundles its local font dependencies. The CSS bundle is generated from index.css and styles/; edit source modules and rebuild the bundle. Type declarations accompany every optional behavior.

Early-stage API: improvements should keep markup predictable, effects modest and boundaries explicit. Suggestions and small, focused contributions are welcome.

Documentation development and hosting

See the Storybook guide. Run bun install --frozen-lockfile, then bun run storybook for the HTML component explorer. bun run build-site creates the public allowlisted .site/ folder with Storybook under /storybook/. GitHub Actions deploys it to GitHub Pages on pushes to main. npm package publication is separate.

Native dialog stories use HTML invoker commands (commandfor, command="show-modal") and form method="dialog". The optional dialog helper adds dynamic dismissal policy with local fallbacks when requestClose() or closedBy is unavailable; native showModal() and close() remain required. Native disclosures and form controls need no event handlers.

Dialog styling is opt-in with rw-dialog, structured rw-dialog__header, __body and __footer classes, plus compact/wide/danger modifiers. See the dialog class guide and dialog playground.

For restrained surfaces and controls, see Quiet appearance.

Paper studio

See the paper workspace example for reusable warm-paper HUD surfaces, an illustrated season cover, native selects and pace buttons. Import the full bundle or @kahwee/runway-ui/studio.css alongside the base tokens and workspace primitives. The Storybook Game patterns / Paper studio playground exposes season, rank, artwork and pace controls.

Behavior declarations are generated from strict TypeScript into dist/, with consumer type fixtures for every optional package entry. See generated types and behavior ownership for the workflow.