Boilerplate Design System using JSS and ReactJS
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.storybook 🔥 Removing old commented code Aug 20, 2018
.vscode 👕 Setup Airbnb ESLint + Prettier Aug 20, 2018
src Added react-styleguidist + Webpack Aug 21, 2018
tests/setup Added Jest + Enzyme testing Aug 20, 2018
CHANGELOG.MD 🎉 React + StorybookJS + JSS Aug 20, 2018
webpack.config.js Added react-styleguidist + Webpack Aug 21, 2018

JSS Design System Boilerplate

Boilerplate Design System using JSS and ReactJS


This project primarily uses StorybookJS for development.

Quick Start

  1. git clone this project
  2. npm install
  3. npm run storybook or npm run dev

Creating components

Make a new folder in the components folder, make sure the folder name is unspaced and Pascal Case (ExampleComponentName). Create a JS file with the same folder name (or appropriate variation).


  • Documented PropTypes and default props.
  • Storybook examples are labeled with a .story.js filename.

Project Structure

The goal is to keep the package as lightweight and minimal as possible, so there's not much to it. If you look at the package.json, you'll see a few dev dependencies like Babel, React, and Storybook.

In terms of actual dependencies, we only have React-JSS, since it's used in the actual components. React and react-dom are peer-deps (since the project's using this will be react-based).

Folder Structure

  • /components/
  • /components/ComponentName/
  • /components/ComponentName/ComponentName.js
  • /components/ComponentName/index.js - contains exports of all components in folder
  • .babelrc - env and react Babel presets.


High Priority

  • More components

Low Priority

  • Integrate Jest + Storybook for testing


  • Install Lerna to manage sub-packages, allowing users to install specific components (maybe separate branch?)