synergiar / storybook-addon-next-router Goto Github PK

View Code? Open in Web Editor NEW

Addon to use Next.js Router in Storybook

License: MIT License

TypeScript 95.66% Shell 1.94% JavaScript 2.39%

storybook-addon-next-router's Introduction

Storybook Addon Next Router

Use Next.js Router in your Storybook stories.

Versions

Use 1.x if you're using storybook 5.x
Use 3.x if you're using storybook 6.x

Note: these docs refer to 3.0

Add the addon to your configuration in .storybook/main.js

module.exports = {
  ...config,
  addons: [
    ...your addons
    "storybook-addon-next-router",
  ],
};

Add the RouterContext.Provider to .storybook/preview.js

import { RouterContext } from "next/dist/shared/lib/router-context"; // next 11.1
import { RouterContext } from "next/dist/next-server/lib/router-context"; // next < 11.1


export const parameters = {
  nextRouter: {
    Provider: RouterContext.Provider,
  },
}

Usage in story

import MyComponentThatHasANextLink from "../component-that-has-a-next-link";

export default {
  title: "My Story",
};

// if you have the actions addon
// you can click the links and see the route change events there
export const Example = () => <MyComponentThatHasANextLink />;

Example.story = {
  parameters: {
    nextRouter: {
      path: "/profile/[id]",
      asPath: "/profile/lifeiscontent",
      query: {
        id: "lifeiscontent",
      },
    },
  },
};

Custom defaults

in preview.js

export const parameters = {
    nextRouter: {
        path: '/', // defaults to `/`
        asPath: '/', // defaults to `/`
        query: {}, // defaults to `{}`
        push() {
        } // defaults to using addon actions integration,
        //   can override any method in the router
    }
};