National Poetry Month

    storybook-amplitude

    0.1.2 • Public • Published

    Storybook Addon Amplitude

    Storybook Addon Amplitude provides support for Amplitude on Storybook.

    Getting Started

    Install:

    npm install storybook-amplitude --save-dev

    within .storybook/main.js:

    module.exports = {
      addons: ['storybook-amplitude/register']
    };

    Then, set an environment variable with your API key:

    window.STORYBOOK_AMPLITUDE_API_KEY = '561t966209h0789k7ffr2c3nmn0sau90'
    

    Configuration

    You can use a custom event name setting an environment variable:

    window.STORYBOOK_AMPLITUDE_EVENT = 'Your custom event'
    

    The default value is Story Viewed.

    Event anatomy

    lt;dr: the event will be sent with Story Viewed (or your custom event name) and the custom property object with viewMode, group, page and story.

    The Storybook provides just the path and storyId on the api provided by register callback. The strings are like these examples:

    • /story/fundamentals-principles--page
    • /docs/design-spacing--page
    • /docs/components-accordion--base
    • /story/components-accordion--base

    So, we've split the path and created an object with this anatomy:

    /<viewMode>/<group>-<page>--<story>

    Examples:

    Path ViewMode Group Page Story
    /story/fundamentals-principles--page story fundamentals principles null
    /docs/design-spacing--page docs design spacing null
    /docs/components-accordion--base docs components accordion base
    /story/components-button--disabled story components button disabled

    Creating an util function that returns an object with viewMode, group, page and story. Something like this:

    {
      viewMode: 'docs',
      group: 'components',
      page: 'button',
      story: 'disabled'
    }

    Support

    Do you need a help? Open a issue here!

    Install

    npm i storybook-amplitude

    DownloadsWeekly Downloads

    5

    Version

    0.1.2

    License

    MIT

    Unpacked Size

    9.06 kB

    Total Files

    8

    Last publish

    Collaborators

    • cherrylipstick