Nostradamus Prophecy Machine

    This package has been deprecated

    Author message:

    Package no longer supported. Contact Support at for more info.


    39.0.0 • Public • Published

    Coverage Status Dependabot Status

    Patchwork - Wealthsimple React Component Library


    Patchwork is Wealthsimple's UI Component library for React applications.

    It aims to provide a first class DSL for building user interfaces that can:

    • Reduce the amount of DOM and CSS you have to write,
    • Help ensure that all your UI is themeable,
    • Help ensure that all your UI is accessible.

    Patchwork User's Guide

    Are you a developer trying to use patchwork to implement features in your application? Check out the Users' Guide.

    Patchwork Implementer's Guide

    Are you a designer or a developer adding features to patchwork itself? Check out the Implementers' Guide.


    Architectural Decision Records

    Wonder why something is implemented a certain way? Curious about the reasoning behind this code-base's conventions?

    Decisions of this nature are recorded in this repo as Architectural Decision Records (ADRs).

    Consuming components in your project

    You can consume this project one of two ways:

    Babel 7+ With Flow

    For compatibility with our internal toolchain, I just expose the ES6+Flow source code for now. That means you'll need a compatible babel config + bundler setup in your project. Check this project's .babel.config.js for the specific configuration.

    Then import things from @wealthsimple/patchwork to use them:

    import { Box } from '@wealthsimple/patchwork';


    Not running a transpiler? Running a transpiler that's not Babel (e.g. TypeScript)? Not using Flow?

    No problem. We also expose a UMD-ified ES5 version of this library in the dist folder:


    import { Box } from '@wealthsimple/patchwork/dist';


    const { Box } = require('@wealthsimple/patchwork/dist');

    Running locally

    To run patchwork locally run ( on port 9001):

    yarn storybook

    If using a compatible IDE ( RubyMine ) you can display flow errors by linking the flow library:

    • Language & Frameworks / JavaScript
    • Select language version: Flow
    • Select executable flow library "... patchwork/node_modules/flow-bin/flow-osx-v0.78.0/flow"

    Accessibility Testing

    As of January 2021, Wealthsimple is legally required to make any of our websites WCAG 2.0 Level AA compliant. Accessibility is sometimes forgotten about when developing fast features in web, but it’s extremely important in providing all of our clients the same, equal-level of access to our services. Patchwork must be accessible because it serves as the building blocks for our entire application.

    In order to test accessibility, we have some scanning jobs in CI that will flag things like missing screenreader labels, insufficient text/background colour contrasts.

    Note: Automated testing can't catch everything. When you make changes or create a new component, before you launch it to the public you should run it by the Web a11y testing guidelines.




    npm i @wealthsimple/patchwork

    DownloadsWeekly Downloads






    Unpacked Size

    8.25 MB

    Total Files


    Last publish


    • 6
    • abejfehr
    • alexturpin
    • cchawn
    • f3ndot
    • jsuter
    • sdavenportws
    • spollock-ws
    • sterlingwes
    • wealthsimple-ci
    • ws-sumeet