# Ladle

Component workshop that runs React component stories in a Vite dev server and builds them into a static app.


Source: https://findsoftware.frbit.cloud/ladle/
Last reviewed: 2026-10-28
Listed since: 2026-10-28

## Record

### Links

- home: https://ladle.dev
- repository: https://github.com/tajo/ladle
- docs: https://ladle.dev/docs/
- x: https://twitter.com/ladlejs
- discord: https://discord.gg/H6FSHjyW7e

### Identity

- status: active
- maintainer: Vojtech Miksu
- maintainerType: individual
- parent: unknown
- firstRelease: 2021
- hqCountry: unknown

### Kind

- category: dev-tool
- hosting: not applicable
- language: javascript
- runtime: node
- runtimeMin: node 20
- basedOn: vite, react

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: right-to-left stories

### Rendering and deploy

- runsAs: local, static
- renderingModes: static
- installMethod: npm

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 5
- latestReleaseDate: 2025-11-04

### Adoption

- githubStargazers: 2995
- packagistDownloads: not applicable
- npmWeeklyDownloads: 391572
- contributors: 61
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 162
- dependentPackages: 251

### Sources

- urls: https://ladle.dev/ (read 2026-10-28)
- urls: https://api.github.com/repos/tajo/ladle (read 2026-10-28)
- urls: https://ladle.dev/docs/ (read 2026-10-28)
- basedOn: https://ladle.dev/docs/ (read 2026-10-28)
- basedOn: https://ladle.dev/docs/ (read 2026-10-28)
- maintainer: https://raw.githubusercontent.com/tajo/ladle/main/LICENSE (read 2026-10-28)
- category: https://ladle.dev/ (read 2026-10-28)
- language: https://api.github.com/repos/tajo/ladle (read 2026-10-28)
- runtime: https://raw.githubusercontent.com/tajo/ladle/%40ladle%2Freact%405.1.1/packages/ladle/package.json (read 2026-10-28)
- runtimeMin: https://raw.githubusercontent.com/tajo/ladle/%40ladle%2Freact%405.1.1/packages/ladle/package.json (read 2026-10-28)
- runsAs: https://ladle.dev/docs/setup (read 2026-10-28)
- runsAs: https://ladle.dev/docs/cli (read 2026-10-28)
- renderingModes: https://ladle.dev/docs/cli (read 2026-10-28)
- installMethod: https://ladle.dev/docs/setup (read 2026-10-28)
- installMethod: https://ladle.dev/docs/setup (read 2026-10-28)
- installMethod: https://ladle.dev/docs/setup (read 2026-10-28)
- i18n: https://ladle.dev/ (read 2026-10-28)
- license: https://api.github.com/repos/tajo/ladle (read 2026-10-28)
- licenseModel: https://raw.githubusercontent.com/tajo/ladle/main/LICENSE (read 2026-10-28)
- firstRelease: https://registry.npmjs.org/@ladle%2freact (read 2026-10-28)
- currentMajor: https://registry.npmjs.org/@ladle%2freact/latest (read 2026-10-28)
- latestReleaseDate: https://api.github.com/repos/tajo/ladle/releases?per_page=100 (read 2026-10-28)
- githubStargazers: https://api.github.com/repos/tajo/ladle (read 2026-10-28)
- contributors: https://api.github.com/repos/tajo/ladle/contributors?per_page=1 (read 2026-10-28)
- npmWeeklyDownloads: https://api.npmjs.org/downloads/range/2026-09-28:2026-10-04/@ladle/react (read 2026-10-28)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/%40ladle%2Freact (read 2026-10-28)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/%40ladle%2Freact (read 2026-10-28)

## Notes

Ladle is a workshop for React components. It shows each story file in a browser through a development server, and its build command produces a static production app that can be deployed. It installs from npm as @ladle/react and expects react and react-dom to be installed alongside it.

The docs describe Ladle as a drop-in alternative to Storybook. Its releases are tagged on the GitHub repository tajo/ladle.

## Worth knowing

Ladle supports only React. Stories for other component frameworks are outside what the project covers.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0