Package Exports

@pattern-lab/cli/bin/cli-actions/init

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@pattern-lab/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Pattern Lab Node CLI

Command-line interface (CLI) for the patternlab-node core.

Installation

Note: Global installs are currently not supported and will be fixed when the Pattern Lab core hits v3.0.0

Via NPM

npm install @pattern-lab/cli --save-dev

Via Yarn

yarn add @pattern-lab/cli --dev

Getting Started

In order to use Pattern Lab you need to initialize a Pattern Lab project with patternlab init. The CLI will ask you some setup question and scaffold your project based on it.
Build your patterns use patternlab build. The Pattern Lab CLI will assume that the patternlab-config.json is in the project root. Othewise specify a custom path to config with patternlab build --config path/to/config
To view your patterns in the browser preview patternlab serve or again specify a custom config location patternlab serve --config path/to/config
To export your patterns in the browser preview patternlab export or again specify a custom config location patternlab export --config path/to/config

API & Usage

General usage

Usage: patternlab <cmd> [options]
    Commands:
        build|compile [options]   Build Pattern Lab. Optionally (re-)build only the patterns
        export                    Export a Pattern Lab patterns into a compressed format
        init [options]            Initialize a Pattern Lab project from scratch or import an edition and/or starterkit
        install|add [options]     Installs Pattern Lab related modules like starterkits or plugins
        serve|browse [options]    Starts a server to inspect files in browser

    Options:
        -h, --help           output usage information
        -V, --version        output the version number
        -c, --config <path>  Specify config file. Default looks up the project dir
        -v, --verbose        Show verbose logging
        --silent             Turn off console logs

Build/Compile Pattern Lab

Usage: build|compile [options]

Build Pattern Lab. Optionally (re-)build only the patterns

    Options:
        -h, --help           output usage information
        -p, --patterns-only  Whether to only build patterns

Initialize Pattern Lab

Usage: init [options]

Initialize a Pattern Lab project from scratch or import an edition and/or starterkit
Passing no options starts the init in interactive mode

    Options:
        -h, --help                output usage information
        -p, --project-dir <path>  Specify a project directory. Default: ./
        -e, --edition <name>      Specify an edition to install. Default: edition-node
        -k, --starterkit <name>   Specify a starterkit to install. Default: starterkit-mustache-base

Serve Pattern Lab

Usage: serve|browse [options]

Starts a server to inspect files in browser


    Options:
        -h, --help   output usage information
        -w, --watch  Start watching for changes

Export Pattern Lab

Usage: export [options]

Export a Pattern Lab patterns into a compressed format

    Options:
        -h, --help  output usage information

Install Pattern Lab starterkits or plugins

Usage: install|add [options]

Installs Pattern Lab related modules like starterkits or plugins

    Options:
        -h, --help             output usage information
        --starterkits <names>  Specify one or more starterkits to install
        --plugins <names>      Specify one or more plugins to install

Examples

    $ patternlab init # Initialize a Pattern Lab project.
    $ patternlab build # Builds Pattern Lab from the current dir
    $ patternlab build --config <path/to/patternlab-config> # Builds Pattern Lab from different project directory

@pattern-lab/cli