# Histoire

Vite-based tool that builds interactive story books of components for Vue, React and Svelte.


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

## Record

### Links

- home: https://histoire.dev/
- repository: https://github.com/histoire-dev/histoire
- docs: https://histoire.dev/
- x: https://twitter.com/histoire_dev
- mastodon: https://m.webtoo.ls/@histoire
- discord: https://discord.gg/KpCnT72rJk

### Identity

- status: active
- maintainer: Guillaume Chau
- maintainerType: unknown
- parent: unknown
- firstRelease: 2022
- hqCountry: unknown

### Kind

- category: dev-tool
- hosting: not applicable
- language: javascript
- runtime: unknown
- runtimeMin: not applicable
- basedOn: vite

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: not applicable

### Rendering and deploy

- runsAs: local, static
- renderingModes: static
- installMethod: npm i -D histoire

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 0
- latestReleaseDate: 2024-04-09

### Adoption

- githubStargazers: 3585
- packagistDownloads: not applicable
- npmWeeklyDownloads: 125480
- contributors: 79
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: unknown
- dependentPackages: unknown

### Sources

- urls: https://histoire.dev/ (read 2026-10-28)
- urls: https://api.github.com/repos/histoire-dev/histoire (read 2026-10-28)
- urls: https://github.com/histoire-dev/histoire/blob/main/README.md (read 2026-10-28)
- license: https://api.github.com/repos/histoire-dev/histoire (read 2026-10-28)
- licenseModel: https://github.com/histoire-dev/histoire/blob/main/LICENSE (read 2026-10-28)
- maintainer: https://histoire.dev/ (read 2026-10-28)
- language: https://api.github.com/repos/histoire-dev/histoire (read 2026-10-28)
- category: https://github.com/histoire-dev/histoire/blob/main/README.md (read 2026-10-28)
- basedOn: https://histoire.dev/ (read 2026-10-28)
- runsAs: https://github.com/histoire-dev/histoire/blob/main/docs/guide/vue3/getting-started.md (read 2026-10-28)
- runsAs: https://github.com/histoire-dev/histoire/blob/main/docs/guide/deploy-node.md (read 2026-10-28)
- renderingModes: https://github.com/histoire-dev/histoire/blob/main/docs/guide/deploy-node.md (read 2026-10-28)
- installMethod: https://github.com/histoire-dev/histoire/blob/main/docs/guide/vue3/getting-started.md (read 2026-10-28)
- installMethod: https://github.com/histoire-dev/histoire/blob/main/docs/guide/vue3/getting-started.md (read 2026-10-28)
- installMethod: https://github.com/histoire-dev/histoire/blob/main/docs/guide/vue3/getting-started.md (read 2026-10-28)
- firstRelease: https://api.github.com/repos/histoire-dev/histoire/releases (read 2026-10-28)
- currentMajor: https://api.github.com/repos/histoire-dev/histoire/releases (read 2026-10-28)
- latestReleaseDate: https://api.github.com/repos/histoire-dev/histoire/releases (read 2026-10-28)
- npmWeeklyDownloads: https://api.npmjs.org/downloads/range/2026-09-28:2026-10-04/histoire (read 2026-10-28)
- githubStargazers: https://api.github.com/repos/histoire-dev/histoire (read 2026-10-28)
- contributors: https://api.github.com/repos/histoire-dev/histoire/contributors (read 2026-10-28)

## Notes

Histoire is a Vite-based tool for writing stories, pages that show a component in one or more variants with controls and the source code that reproduces it. A story file imports a component and mounts it in a variant. Histoire builds the stories into a book with navigation, a search index, Markdown documentation and copyable source code. The README lists Vue, React, Svelte, Nuxt and SvelteKit as supported. Each framework is added as a development dependency next to Histoire, and the CLI runs a development server for the book.

## Worth knowing

The npm package's latest tag points to a beta of the next major release, while the newest stable GitHub release belongs to the earlier line. The docs describe beta features, such as an MCP server and a standalone Node deployment target, and a Node.js requirement that the stable package does not declare. Read the docs for the version being installed.

---

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