Carte Blanche – isolated development space with integrated fuzz testing

README.md

Carte Blanche is an isolated development space with integrated fuzz testing for your components. See them individually, explore them in different states and quickly and confidently develop them.

Screenshot of Carte Blanche

30 seconds feature video on Youtube

Setup

Setting up Carte Blanche is an easy two-step process:

  1. Install the plugin with npm install --save-dev carte-blanche

  2. Add it to the plugins in your development webpack configuration, specifying a relative path to the folder with your components in the componentRoot option:

    var CarteBlanche = require('carte-blanche');
    /* … */
    plugins: [
      new CarteBlanche({
        componentRoot: './src/components'
      })
    ],

That’s it, now start your development environment and go to /carte-blanche to see your Carte Blanche!

Options

You can specify some options for the webpack plugin:

  • componentRoot (required): Folder where your component modules are.

      plugins: [
        new CarteBlanche({
          componentRoot: 'src/components'
        })
      ]
  • dest (default: 'carte-blanche'): Change the location of your Carte Blanche. Needs to be a path.

      plugins: [
        new CarteBlanche({
          componentRoot: 'src/components',
          dest: 'components'
        })
      ]
  • plugins (default: ReactPlugin): An array of plugins to use in your Carte Blanche. (Want to write your own? See writing-plugins.md for more information!)

      var ReactPlugin = require('carte-blanche-react-plugin');
      var SourcePlugin = require('carte-blanche-source-plugin');
    
      plugins: [
        new CarteBlanche({
          componentRoot: 'src/components',
          plugins: [
           new SourcePlugin({ /* …options for the plugin here… */ }),
           new ReactPlugin()
          ]
        })
      ]
  • filter (default: matches uppercase files and uppercase folders with an index file): Regex that matches your components in the componentRoot folder. We do not recommend changing this, as it might have unintended side effects.

      plugins: [
        new CarteBlanche({
          filter: /.*.jsx$/ // Matches all files ending in .jsx
        })
      ]

This project has a custom plugin system to make it as extensible as possible. By default, we include the ReactPlugin, which has options of itself. (to pass these in you’ll have to explicitly specify it with the plugins option)

ReactPlugin Options

  • variationFolderName (default: variations): The name of the folders that stores the variation files.

    new ReactPlugin({
      variationFolderName: 'examples'
    })
  • port (default: 8082): The port the variations server runs at.

    new ReactPlugin({
      port: 7000
    })
  • hostname (default: localhost): The URL the variations server runs at.

    new ReactPlugin({
      hostname: 'mydomain.com'
    })

Plugins

This is a list of endorsed plugins that are useable right now:

Want to write your own plugin? Check out writing-plugins.md!

License

Copyright (c) 2016 Nikolaus Graf and Maximilian Stoiber, licensed under the MIT License.


Original URL: http://feedproxy.google.com/~r/feedsapi/BwPx/~3/dvc9vZ1M-Ow/carte-blanche

Original article

Comments are closed.

Proudly powered by WordPress | Theme: Baskerville 2 by Anders Noren.

Up ↑

%d bloggers like this: