# tajo/ladle

🥄 Develop, test and document your React story components faster.

Repository: https://github.com/tajo/ladle
Canonical: https://ross.abutalabs.com/products/ladle
Homepage: https://www.ladle.dev
Language: TypeScript
License: MIT
License Family: permissive
Topics: playground, react, javascript, testing, components, documentation, styleguide, typescript, ui, esbuild, vitejs, stories
Last push: 2026-06-28T20:32:40+00:00

## Health v2 (maintenance only)
Score: 75/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 89, release rhythm 43, longevity 100
- inputs: {"age_days": 2241, "days_push": 66, "days_rel": 303, "gap_med": 59.0, "n_releases_24m": 7}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2983, forks 119 (observed 2026-08-28T04:07:33.959204+00:00)

## What it is
Ladle is a fast, zero-configuration environment for developing, testing, and documenting React components using the Component Story Format. It serves as a lightweight drop-in alternative to Storybook, built on Vite and esbuild with HMR, accessibility checks, and an indexable story catalog for tools like Playwright.

## Use cases
- develop and preview React components in isolation
- replace Storybook with a faster lighter alternative
- document React UI components with stories
- run accessibility checks on components with axe
- browse and test components via Playwright
- create a component styleguide for a design system

## When to choose
- you use React exclusively and want instant startup and small bundles
- you want zero-config story-based component development with Vite
- you need a fast component catalog for e2e testing

## When to avoid
- you need multi-framework support (Vue, Svelte, Angular)
- you rely on Storybook addons or its large ecosystem
- you need MDX-heavy documentation workflows

## Facets
- artifact type: application
- maturity: active
- function: ui-components, testing, documentation, developer-tools
- domain: frontend, web-development, developer-tools, testing
- platform: cross-platform
- tags: storybook-alternative, component-story-format, vite, component-playground, react-components, hmr, nodejs, web-server

## Member repositories
- tajo/ladle (main) score 75

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:33.959204+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:31:27.881502+00:00, confidence not recorded.
  - readme: https://github.com/tajo/ladle (fetched 2026-08-28T04:07:33.959204+00:00, sha f24968ffbd26)
  - homepage: https://www.ladle.dev (fetched 2026-08-29T09:46:46.460618+00:00, sha 866d3b66dde2)
  - site_page: https://ladle.dev/docs (fetched 2026-08-29T09:46:46.469540+00:00, sha 87ce7ba2720e)
- Data as of 2026-08-30T08:39:29.467469+00:00.