Pattern Lab Standard Edition for Twig
The Standard Edition for Twig gives developers and designers a clean and stable base from which to develop a Twig-based pattern library.
Packaged Components
The Standard Edition for Twig comes with the following components:
pattern-lab/core
: GitHub, Packagistpattern-lab/patternengine-twig
: documentation, GitHub, Packagistpattern-lab/styleguidekit-assets-default
: GitHub, Packagistpattern-lab/styleguidekit-twig-default
: GitHub, Packagist
Installing
There are two methods for downloading and installing the Standard Edition for Twig:
Download a pre-built project
The fastest way to get started with the Standard Edition for Twig is to download the pre-built version from the releases page. The pre-built project comes with the Base StarterKit for Twig installed by default.
Please note: Pattern Lab uses Composer to manage project dependencies. To upgrade the Standard Edition for Twig or to install plug-ins you'll need to install Composer. We recommend that you install it globally.
Use Composer to create a project
Pattern Lab uses Composer to manage project dependencies.
1. Install Composer
Please follow the directions for installing Composer on the Composer website. We recommend you install it globally.
2. Install the Standard Edition for Twig
Use Composer's create-project
command to install the Standard Edition for Twig into a location of your choosing. In Terminal type:
cd install/location/
composer create-project pattern-lab/edition-twig-standard your-project-name && cd $_
This will install the Standard Edition for Twig into a directory called your-project-name
in install/location/
. During the set-up process you will be asked to install an appropriate StarterKit. You will be automatically dropped into the project directory after the process is finished.
Updating Pattern Lab
To update Pattern Lab please refer to each component's GitHub repository. The components are listed at the top of the README.
Helpful Commands
These are some helpful commands you can use on the command line for working with Pattern Lab.
List all of the available commands
To list all available commands type:
php core/console --help
To list the options for a particular command type:
php core/console --help --[command]
Generate Pattern Lab
To generate the front-end for Pattern Lab type:
php core/console --generate
Watch for changes and re-generate Pattern Lab
To watch for changes and re-generate the front-end for Pattern Lab type:
php core/console --watch
Start a server to view Pattern Lab
You can use PHP's built-in web server to review your Pattern Lab project in a browser. In a seperate window type:
php core/console --server
Then open http://localhost:8080 in your browser.
Install a StarterKit
To install a near-empty StarterKit as a starting point for your project type:
php core/console --starterkit --init
To install a specific StarterKit from GitHub type:
php core/console --starterkit --install