Changelog Viewer

Show Changelog files in the Storybook UI

View on Github

Storybook Addon Changelog Viewer

Show Changelog files in the Storybook UI - made with ❤️ by Dave Bitter

Storybook v7.0.0 or higher is needed to use this addon

Storybook UI showing the changelog tab active and displaying a mock changelog

Usage

  1. Install addon

    npm install storybook-addon-changelog-viewer --save
    
    yarn add storybook-addon-changelog-viewer --save
    
  2. Load addon in .storybook/main.js

    module.exports = {
      // other configuration here
      addons: [
        // other addons here.
        "storybook-addon-changelog-viewer",
      ],
    };
    
  3. Import changelog file in story and pass it to the changelog parameter

    import changelog from "./CHANGELOG.md";
    
    export default {
      title: "Your Component",
      parameters: {
        changelog: changelog,
      },
    };
    
  4. View changelog in the Storybook UI. There should be a new tab called "Changelog"

Features

  • View changelog files in the Storybook UI
  • Render Markdown as HTML
  • Automatically generate a navigation with links to all headings with a SemVer string (e.g. "## 1.0.0 - 2022-06-30")

Motivation

This addon was created to make it easier to view changelog files in the Storybook UI. Since Storybook v7.0.0. the Storybook Addon Notes is no longer working which is why this addon was created.

Made by
  • davebitter
    davebitter
Work with
    Angular
    Ember
    HTML
    Preact
    React
    React native
    Svelte
    Vue
    Web Components
Tags