diff --git a/README.md b/README.md
index 22cca4a1..4c78c85c 100644
--- a/README.md
+++ b/README.md
@@ -1,103 +1,60 @@
+![Pattern Lab Logo](/patternlab.png "Pattern Lab Logo")
+
+![current release](https://img.shields.io/github/release/pattern-lab/edition-node-gulp.svg) ![license](https://img.shields.io/github/license/pattern-lab/edition-node-gulp.svg) [![Join the chat at Gitter](https://badges.gitter.im/pattern-lab/node.svg)](https://gitter.im/pattern-lab/node)
+
 # Pattern Lab Node - Gulp Edition
 
-The Gulp wrapper around [Pattern Lab Node Core](https://github.com/pattern-lab/patternlab-node) providing tasks to interact with the core library and move supporting frontend assets.
+The Gulp wrapper around [Pattern Lab Node Core](https://github.com/pattern-lab/patternlab-node), the default PatternEngine, and supporting frontend assets.
 
 ## Packaged Components
 
-The Gulp Edition comes with the following components:
+This Edition comes with the following components:
 
-* `patternlab-node`: [GitHub](https://github.com/pattern-lab/patternlab-node), [npm](https://www.npmjs.com/package/patternlab-node)
-* `patternengine-node-mustache`: [GitHub](https://github.com/pattern-lab/patternengine-node-mustache), [npm](https://www.npmjs.com/package/patternengine-node-mustache)
-* `pattern-lab/styleguidekit-assets-default`: [GitHub](https://github.com/pattern-lab/styleguidekit-assets-default)
-* `pattern-lab/styleguidekit-mustache-default`: [GitHub](https://github.com/pattern-lab/styleguidekit-mustache-default)
+* `pattern-lab/patternlab-node`: [GitHub](https://github.com/pattern-lab/patternlab-node) | [npm](https://www.npmjs.com/package/@pattern-lab/patternlab-node)
+* `pattern-lab/patternengine-node-mustache`: [GitHub](https://github.com/pattern-lab/patternengine-node-mustache) | [npm](https://www.npmjs.com/package/@pattern-lab/patternengine-node-mustache)
+* `pattern-lab/styleguidekit-assets-default`: [GitHub](https://github.com/pattern-lab/styleguidekit-assets-default) | [npm](https://www.npmjs.com/package/@pattern-lab/styleguidekit-assets-default)
+* `pattern-lab/styleguidekit-mustache-default`: [GitHub](https://github.com/pattern-lab/styleguidekit-mustache-default) | [npm](https://www.npmjs.com/package/@pattern-lab/styleguidekit-mustache-default)
 
 ## Prerequisites
 
-The Pattern Lab Node - Gulp Edition uses [Node](https://nodejs.org) for core processing, [npm](https://www.npmjs.com/) to manage project dependencies, and [gulp.js](http://gulpjs.com/) to run tasks and interface with the core library. Node version 4 or higher suffices. You can follow the directions for [installing Node](https://nodejs.org/en/download/) on the Node website if you haven't done so already. Installation of Node will include npm.
-
-It's also highly recommended that you [install gulp](hhttps://github.com/gulpjs/gulp/blob/4.0/docs/getting-started.md) globally.
-
-> Note: The Gulp Edition of Pattern Lab uses Gulp 4, which may require a new global install of the Gulp command line interface. Follow the [gulp upgrade instructions](https://github.com/pattern-lab/edition-node-gulp/wiki/Updating-to-Gulp-4) if you already have gulp installed and need to upgrade. Gulp 4 is in alpha, but brings many benefits to the table and is relatively stable. You can alternatively [run with local gulp instead of global gulp](https://github.com/pattern-lab/patternlab-node/wiki/Running-with-Local-Gulp-Instead-of-Global-Gulp), but commands are a bit more verbose. The rest of this documentation assumes a global install.
+This Edition uses [Node](https://nodejs.org) for core processing, [npm](https://www.npmjs.com/) to manage project dependencies, and [gulp.js](http://gulpjs.com/) to run tasks and interface with the core library. You can follow the directions for [installing Node](https://nodejs.org/en/download/) on the Node website if you haven't done so already. Installation of Node will include npm.
 
 ## Installing
 
-There are two methods for downloading and installing the Gulp Edition:
-
-* [Download a pre-built package](#download-a-pre-built-package)
-* [Use npm](#use-npm)
-
-### Download a pre-built package
-
-The fastest way to get started with the Gulp Edition is to [download the pre-built version](https://github.com/pattern-lab/edition-node-gulp/releases) from the [releases page](https://github.com/pattern-lab/edition-node-gulp/releases). The pre-built project comes with the [Base Starterkit for Mustache](https://github.com/pattern-lab/starterkit-mustache-base) installed by default.
-
-**Please note:** Pattern Lab Node uses [npm](https://www.npmjs.com/) to manage project dependencies. To upgrade the Gulp Edition or to install plug-ins you'll need to be familiar with npm.
+Pattern Lab Node can be used different ways. Editions like this one are **example** pairings of Pattern Lab code and do not always have an upgrade path or simple means to run as a dependency within a larger project. Users wishing to be most current and have the greatest flexibility are encouraged to consume `patternlab-node` directly. Users wanting to learn more about Pattern Lab and have a tailored default experience are encouraged to start with an Edition. Both methods still expect to interact with other elements of the [Pattern Lab Ecosystem](https://github.com/pattern-lab/patternlab-node#ecosystem).
 
-### Use npm
+As an Edition, the simplist installation sequence is to clone this repository.
 
-`npm` is a dependency management and package system which can pull in all of the Gulp Edition's dependencies for you. To accomplish this:
+``` bash
+mkdir newApp && cd newApp
+git clone https://github.com/pattern-lab/edition-node-gulp.git
+npm install
+```
 
-* download or `git clone` this repository to an install location.
-
-* run the following
-
-    ```
-    cd install/location
-    npm install
-    ```
+## Getting Started
 
-Running `npm install` from a directory containing a `package.json` file will download all dependencies defined within.
+This edition comes pre-packaged with a couple simple gulp tasks. Extend them as needed.
 
-#### Install the Gulp Edition of Pattern Lab Node as a Dependency
+**build** patterns, copy assets, and construct ui
 
-Most people want to run Pattern Lab Node standalone and not as a dependency. If you wish to install as a dependency you can do the following:
+``` bash
+gulp patternlab:build
+```
 
-Use npm's [`install` command](https://docs.npmjs.com/cli/install) with an argument to install the Gulp Edition into a location of your choosing. In Terminal type:
+build patterns, copy assets, and construct ui, watch source files, and **serve** locally
 
-    cd install/location/
-    npm install edition-node-gulp
+``` bash
+gulp patternlab:serve
+```
 
-This will install the Gulp Edition into a directory called `node_modules` in `install/location/`.
+logs Pattern Lab Node usage and **help** content
 
-## Getting Started
+``` bash
+gulp patternlab:help
+```
 
-The Pattern Lab Node - Gulp Edition ships with a [base experience](https://github.com/pattern-lab/starterkit-mustache-base) which serves as clean place to start from scratch with Pattern Lab. But if you want to get rolling with a starterkit of your own, or use the [demo starterkit](https://github.com/pattern-lab/starterkit-mustache-demo) like the one on [demo.patternlab.io](http://demo.patternlab.io), you can do so automatically at time of `npm install` by adding your starterkit to the `package.json` file.
-
-You can also [work with starterkits using the command line](https://github.com/pattern-lab/patternlab-node/wiki/Importing-Starterkits).
+To interact further with Pattern Lab Node, such as to install plugins or starterkits, check out the rest of the `gulpfile.js`. You could also install the [Pattern Lab Node Command Line Interface](https://github.com/pattern-lab/patternlab-node-cli) or learn more about the [core API](https://github.com/pattern-lab/patternlab-node#usage).
 
 ## Updating Pattern Lab
 
 To update Pattern Lab please refer to each component's GitHub repository, and the [master instructions for core](https://github.com/pattern-lab/patternlab-node/wiki/Upgrading). 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.
-
-> Reminder: These commands assume a global installation of gulp 4.X, instead of a local installation. Depending on your preference, you may need to [upgrade your global version of gulp](https://github.com/pattern-lab/edition-node-gulp/wiki/Updating-to-Gulp-4) or [run with local gulp](https://github.com/pattern-lab/patternlab-node/wiki/Running-with-Local-Gulp-Instead-of-Global-Gulp).
-
-### List all of the available commands
-
-To list all available commands type:
-
-    gulp patternlab:help
-
-### Generate Pattern Lab
-
-To generate the front-end for Pattern Lab type:
-
-    gulp patternlab:build
-
-### Watch for changes and re-generate Pattern Lab
-
-To watch for changes, re-generate the front-end, and server it via a BrowserSync server,  type:
-
-    gulp patternlab:serve
-
-BrowserSync should open [http://localhost:3000](http://localhost:3000) in your browser.
-
-### Install a StarterKit
-
-To install a specific StarterKit from GitHub type:
-
-    npm install [starterkit-vendor/starterkit-name]
-
-    gulp patternlab:loadstarterkit --kit=[starterkit-name]
diff --git a/gulpfile.js b/gulpfile.js
index f38f4174..efcc6704 100644
--- a/gulpfile.js
+++ b/gulpfile.js
@@ -1,266 +1,70 @@
 /******************************************************
  * PATTERN LAB NODE
  * EDITION-NODE-GULP
- * The gulp wrapper around patternlab-node core, providing tasks to interact with the core library and move supporting frontend assets.
+ * The gulp wrapper around patternlab-node core, providing tasks to interact with the core library.
 ******************************************************/
-var gulp = require('gulp'),
-  path = require('path'),
-  browserSync = require('browser-sync').create(),
-  argv = require('minimist')(process.argv.slice(2)),
-  chalk = require('chalk');
-
-/**
- * Normalize all paths to be plain, paths with no leading './',
- * relative to the process root, and with backslashes converted to
- * forward slashes. Should work regardless of how the path was
- * written. Accepts any number of parameters, and passes them along to
- * path.resolve().
- *
- * This is intended to avoid all known limitations of gulp.watch().
- *
- * @param {...string} pathFragment - A directory, filename, or glob.
-*/
-function normalizePath() {
-  return path
-    .relative(
-      process.cwd(),
-      path.resolve.apply(this, arguments)
-    )
-    .replace(/\\/g, "/");
-}
+const gulp = require('gulp');
+const argv = require('minimist')(process.argv.slice(2));
 
 /******************************************************
- * COPY TASKS - stream assets from source to destination
+ * PATTERN LAB  NODE WRAPPER TASKS with core library
 ******************************************************/
-// JS copy
-gulp.task('pl-copy:js', function () {
-  return gulp.src('**/*.js', {cwd: normalizePath(paths().source.js)} )
-    .pipe(gulp.dest(normalizePath(paths().public.js)));
-});
-
-// Images copy
-gulp.task('pl-copy:img', function () {
-  return gulp.src('**/*.*',{cwd: normalizePath(paths().source.images)} )
-    .pipe(gulp.dest(normalizePath(paths().public.images)));
-});
-
-// Favicon copy
-gulp.task('pl-copy:favicon', function () {
-  return gulp.src('favicon.ico', {cwd: normalizePath(paths().source.root)} )
-    .pipe(gulp.dest(normalizePath(paths().public.root)));
-});
-
-// Fonts copy
-gulp.task('pl-copy:font', function () {
-  return gulp.src('*', {cwd: normalizePath(paths().source.fonts)})
-    .pipe(gulp.dest(normalizePath(paths().public.fonts)));
-});
-
-// CSS Copy
-gulp.task('pl-copy:css', function () {
-  return gulp.src(normalizePath(paths().source.css) + '/*.css')
-    .pipe(gulp.dest(normalizePath(paths().public.css)))
-    .pipe(browserSync.stream());
-});
-
-// Styleguide Copy everything but css
-gulp.task('pl-copy:styleguide', function () {
-  return gulp.src(normalizePath(paths().source.styleguide) + '/**/!(*.css)')
-    .pipe(gulp.dest(normalizePath(paths().public.root)))
-    .pipe(browserSync.stream());
-});
-
-// Styleguide Copy and flatten css
-gulp.task('pl-copy:styleguide-css', function () {
-  return gulp.src(normalizePath(paths().source.styleguide) + '/**/*.css')
-    .pipe(gulp.dest(function (file) {
-      //flatten anything inside the styleguide into a single output dir per http://stackoverflow.com/a/34317320/1790362
-      file.path = path.join(file.base, path.basename(file.path));
-      return normalizePath(path.join(paths().public.styleguide, '/css'));
-    }))
-    .pipe(browserSync.stream());
-});
-
-/******************************************************
- * PATTERN LAB CONFIGURATION - API with core library
-******************************************************/
-//read all paths from our namespaced config file
-var config = require('./patternlab-config.json'),
-  patternlab = require('patternlab-node')(config);
-
-function paths() {
-  return config.paths;
-}
-
-function getConfiguredCleanOption() {
-  return config.cleanPublic;
+const config = require('./patternlab-config.json');
+const patternlab = require('@pattern-lab/patternlab-node')(config);
+
+function build() {
+  return patternlab.build({
+    watch: argv.watch,
+    cleanPublic: config.cleanPublic
+  }).then(() =>{
+    // do something else when this promise resolves
+  });
 }
 
-/**
- * Performs the actual build step. Accomodates both async and sync
- * versions of Pattern Lab.
- * @param {function} done - Gulp done callback
- */
-function build(done) {
-  const buildResult = patternlab.build(() => {}, getConfiguredCleanOption());
-
-  // handle async version of Pattern Lab
-  if (buildResult instanceof Promise) {
-    return buildResult.then(done);
+function serve() {
+  return patternlab.serve({
+    cleanPublic: config.cleanPublic
   }
-
-  // handle sync version of Pattern Lab
-  done();
-  return null;
+).then(() => {
+  // do something else when this promise resolves
+  });
 }
 
-gulp.task('pl-assets', gulp.series(
-  'pl-copy:js',
-  'pl-copy:img',
-  'pl-copy:favicon',
-  'pl-copy:font',
-  'pl-copy:css',
-  'pl-copy:styleguide',
-  'pl-copy:styleguide-css'
-));
-
-gulp.task('patternlab:version', function (done) {
+gulp.task('patternlab:version', function () {
   patternlab.version();
-  done();
 });
 
-gulp.task('patternlab:help', function (done) {
+gulp.task('patternlab:help', function () {
   patternlab.help();
-  done();
 });
 
-gulp.task('patternlab:patternsonly', function (done) {
-  patternlab.patternsonly(done, getConfiguredCleanOption());
+gulp.task('patternlab:patternsonly', function () {
+  patternlab.patternsonly(config.cleanPublic);
 });
 
-gulp.task('patternlab:liststarterkits', function (done) {
+gulp.task('patternlab:liststarterkits', function () {
   patternlab.liststarterkits();
-  done();
 });
 
-gulp.task('patternlab:loadstarterkit', function (done) {
+gulp.task('patternlab:loadstarterkit', function () {
   patternlab.loadstarterkit(argv.kit, argv.clean);
-  done();
 });
 
-gulp.task('patternlab:build', gulp.series('pl-assets', build));
-
-gulp.task('patternlab:installplugin', function (done) {
-  patternlab.installplugin(argv.plugin);
-  done();
+gulp.task('patternlab:build', function () {
+  build().then(() => {
+    // do something else when this promise resolves
+  });
 });
 
-/******************************************************
- * SERVER AND WATCH TASKS
-******************************************************/
-// watch task utility functions
-function getSupportedTemplateExtensions() {
-  var engines = require('./node_modules/patternlab-node/core/lib/pattern_engines');
-  return engines.getSupportedFileExtensions();
-}
-function getTemplateWatches() {
-  return getSupportedTemplateExtensions().map(function (dotExtension) {
-    return normalizePath(paths().source.patterns, '**', '*' + dotExtension);
+gulp.task('patternlab:serve', function () {
+  serve().then(() => {
+    // do something else when this promise resolves
   });
-}
-
-/**
- * Reloads BrowserSync.
- * Note: Exits more reliably when used with a done callback.
- */
-function reload(done) {
-  browserSync.reload();
-  done();
-}
-
-/**
- * Reloads BrowserSync, with CSS injection.
- * Note: Exits more reliably when used with a done callback.
- */
-function reloadCSS(done) {
-  browserSync.reload('*.css');
-  done();
-}
-
-function watch() {
-  const watchers = [
-    {
-      name: 'CSS',
-      paths: [normalizePath(paths().source.css, '**', '*.css')],
-      config: { awaitWriteFinish: true },
-      tasks: gulp.series('pl-copy:css', reloadCSS)
-    },
-    {
-      name: 'Styleguide Files',
-      paths: [normalizePath(paths().source.styleguide, '**', '*')],
-      config: { awaitWriteFinish: true },
-      tasks: gulp.series('pl-copy:styleguide', 'pl-copy:styleguide-css', reloadCSS)
-    },
-    {
-      name: 'Source Files',
-      paths: [
-        normalizePath(paths().source.patterns, '**', '*.json'),
-        normalizePath(paths().source.patterns, '**', '*.md'),
-        normalizePath(paths().source.data, '**', '*.json'),
-        normalizePath(paths().source.fonts, '**', '*'),
-        normalizePath(paths().source.images, '**', '*'),
-        normalizePath(paths().source.js, '**', '*'),
-        normalizePath(paths().source.meta, '**', '*'),
-        normalizePath(paths().source.annotations, '**', '*')
-      ].concat(getTemplateWatches()),
-      config: { awaitWriteFinish: true },
-      tasks: gulp.series(build, reload)
-    }
-  ];
+});
 
-  watchers.forEach(watcher => {
-    console.log('\n' + chalk.bold('Watching ' + watcher.name + ':'));
-    watcher.paths.forEach(p => console.log('  ' + p));
-    gulp.watch(watcher.paths, watcher.config, watcher.tasks);
-  });
-  console.log();
-}
+gulp.task('patternlab:installplugin', function () {
+  patternlab.installplugin(argv.plugin);
+});
 
-gulp.task('patternlab:connect', gulp.series(function (done) {
-  browserSync.init({
-    server: {
-      baseDir: normalizePath(paths().public.root)
-    },
-    snippetOptions: {
-      // Ignore all HTML files within the templates folder
-      blacklist: ['/index.html', '/', '/?*']
-    },
-    notify: {
-      styles: [
-        'display: none',
-        'padding: 15px',
-        'font-family: sans-serif',
-        'position: fixed',
-        'font-size: 1em',
-        'z-index: 9999',
-        'bottom: 0px',
-        'right: 0px',
-        'border-top-left-radius: 5px',
-        'background-color: #1B2032',
-        'opacity: 0.4',
-        'margin: 0',
-        'color: white',
-        'text-align: center'
-      ]
-    }
-  }, function () {
-    done();
-  });
-}));
+gulp.task('default', ['patternlab:help']);
 
-/******************************************************
- * COMPOUND TASKS
-******************************************************/
-gulp.task('default', gulp.series('patternlab:build'));
-gulp.task('patternlab:watch', gulp.series('patternlab:build', watch));
-gulp.task('patternlab:serve', gulp.series('patternlab:build', 'patternlab:connect', watch));
diff --git a/package.json b/package.json
index 348c1665..f223a5ee 100644
--- a/package.json
+++ b/package.json
@@ -1,15 +1,15 @@
 {
-  "name": "edition-node-gulp",
+  "name": "@pattern-lab/edition-node-gulp",
   "description": "The gulp wrapper around patternlab-node core, providing tasks to interact with the core library and move supporting frontend assets.",
-  "version": "1.4.0",
+  "version": "2.0.0-alpha.1",
+  "main": "gulpfile.js",
   "dependencies": {
-    "browser-sync": "^2.0.0",
-    "chalk": "^1.1.3",
-    "gulp": "gulpjs/gulp#4.0",
-    "minimist": "^1.2.0",
-    "patternlab-node": "^2.0.0",
-    "styleguidekit-assets-default": "^3.0.0",
-    "styleguidekit-mustache-default": "^3.0.0"
+    "@pattern-lab/patternengine-node-mustache": "^2.0.0-alpha.1",
+    "@pattern-lab/patternlab-node": "^3.0.0-alpha.5",
+    "@pattern-lab/styleguidekit-assets-default": "^4.0.0-alpha.2",
+    "@pattern-lab/styleguidekit-mustache-default": "^4.0.0-alpha.1",
+    "gulp": "^3.9.1",
+    "minimist": "^1.2.0"
   },
   "keywords": [
     "Pattern Lab",
@@ -25,12 +25,10 @@
   "bugs": "https://github.com/pattern-lab/edition-node-gulp/issues",
   "author": "Brian Muenzenmeyer",
   "scripts": {
-    "start": "gulp patternlab:serve",
-    "postinstall": "node scripts/postinstall.js",
     "gulp": "gulp -- "
   },
   "license": "MIT",
   "engines": {
-    "node": ">=5.0"
+    "node": ">=6.0"
   }
 }
diff --git a/patternlab-config.json b/patternlab-config.json
index 55f0c8fe..7c37b30a 100644
--- a/patternlab-config.json
+++ b/patternlab-config.json
@@ -1,4 +1,36 @@
 {
+  "cacheBust": true,
+  "cleanPublic" : true,
+  "defaultPattern": "all",
+  "defaultShowPatternInfo": false,
+  "ishControlsHide": {
+    "s": false,
+    "m": false,
+    "l": false,
+    "full": false,
+    "random": false,
+    "disco": false,
+    "hay": true,
+    "mqs": false,
+    "find": false,
+    "views-all": false,
+    "views-annotations": false,
+    "views-code": false,
+    "views-new": false,
+    "tools-all": false,
+    "tools-docs": false
+  },
+  "ishViewportRange": {
+    "s": [240, 500],
+    "m": [500, 800],
+    "l": [800, 2600]
+  },
+  "logLevel": "info",
+  "outputFileSuffixes": {
+    "rendered": ".rendered",
+    "rawTemplate": "",
+    "markupOnly": ".markup-only"
+  },
   "paths" : {
     "source" : {
       "root": "./source/",
@@ -6,8 +38,14 @@
       "data" : "./source/_data/",
       "meta": "./source/_meta/",
       "annotations" : "./source/_annotations/",
-      "styleguide" : "./node_modules/styleguidekit-assets-default/dist/",
-      "patternlabFiles" : "./node_modules/styleguidekit-mustache-default/views/",
+      "styleguide" : "./node_modules/@pattern-lab/styleguidekit-assets-default/dist/",
+      "patternlabFiles" : {
+        "general-header": "./node_modules/@pattern-lab/styleguidekit-mustache-default/views/partials/general-header.mustache",
+        "general-footer": "./node_modules/@pattern-lab/styleguidekit-mustache-default/views/partials/general-footer.mustache",
+        "patternSection": "./node_modules/@pattern-lab/styleguidekit-mustache-default/views/partials/patternSection.mustache",
+        "patternSectionSubtype": "./node_modules/@pattern-lab/styleguidekit-mustache-default/views/partials/patternSectionSubtype.mustache",
+        "viewall": "./node_modules/@pattern-lab/styleguidekit-mustache-default/views/viewall.mustache"
+      },
       "js" : "./source/js",
       "images" : "./source/images",
       "fonts" : "./source/fonts",
@@ -25,45 +63,19 @@
       "css" : "./public/css"
     }
   },
-  "styleGuideExcludes": [
-  ],
-  "defaultPattern": "all",
-  "defaultShowPatternInfo": false,
-  "cleanPublic" : true,
   "patternExtension": "mustache",
-  "ignored-extensions" : ["scss", "DS_Store", "less"],
-  "ignored-directories" : ["scss"],
-  "debug": false,
-  "ishControlsHide": {
-    "s": false,
-    "m": false,
-    "l": false,
-    "full": false,
-    "random": false,
-    "disco": false,
-    "hay": true,
-    "mqs": false,
-    "find": false,
-    "views-all": false,
-    "views-annotations": false,
-    "views-code": false,
-    "views-new": false,
-    "tools-all": false,
-    "tools-docs": false
-  },
-  "ishMinimum": "240",
-  "ishMaximum": "2600",
   "patternStateCascade": ["inprogress", "inreview", "complete"],
-  "patternStates": {
-  },
-  "patternExportPatternPartials": [],
   "patternExportDirectory": "./pattern_exports/",
-  "cacheBust": true,
-  "starterkitSubDir": "dist",
-  "outputFileSuffixes": {
-    "rendered": ".rendered",
-    "rawTemplate": "",
-    "markupOnly": ".markup-only"
+  "patternExportPatternPartials": [],
+  "serverOptions": {
+    "wait": 1000
   },
-  "cleanOutputHtml": true
+  "starterkitSubDir": "dist",
+  "styleGuideExcludes": [
+  ],
+  "theme": {
+    "color": "dark",
+    "density": "compact",
+    "layout": "horizontal"
+  }
 }
diff --git a/patternlab.png b/patternlab.png
new file mode 100644
index 00000000..80edf70a
Binary files /dev/null and b/patternlab.png differ
diff --git a/scripts/postinstall.js b/scripts/postinstall.js
deleted file mode 100644
index 001432fa..00000000
--- a/scripts/postinstall.js
+++ /dev/null
@@ -1,5 +0,0 @@
-"use strict";
-console.log('Beginning Pattern Lab Node Gulp postinstall...');
-
-//call the core library postinstall
-var patternlab = require('patternlab-node/core/scripts/postinstall');
diff --git a/source/_annotations/README.md b/source/_annotations/README.md
new file mode 100644
index 00000000..42592a09
--- /dev/null
+++ b/source/_annotations/README.md
@@ -0,0 +1,5 @@
+This is the default location to place annotations.
+
+Pattern Lab uses annotations defined here to markup the UI. Read more about [annotations](http://patternlab.io/docs/pattern-adding-annotations.html).
+
+If you wish to rename this directory, make sure you update the `paths.source.annotations` property within `patternlab-config.json`.
diff --git a/source/_annotations/annotations.js b/source/_annotations/annotations.js
deleted file mode 100644
index d817dfa9..00000000
--- a/source/_annotations/annotations.js
+++ /dev/null
@@ -1,9 +0,0 @@
-{
-  "comments" : [
-    {
-      "el": "#annotation-css-selector",
-      "title" : "Annotation title",
-      "comment": "Annotation description"
-    }
-  ]
-}
diff --git a/source/_data/README.md b/source/_data/README.md
new file mode 100644
index 00000000..3b9ea1ea
--- /dev/null
+++ b/source/_data/README.md
@@ -0,0 +1,5 @@
+This is the default location to place global data files.
+
+Pattern Lab uses data defined here as the global fallback if a template does not provide its own data. Read more about [data](http://patternlab.io/docs/data-overview.html).
+
+If you wish to rename this directory, make sure you update the `paths.source.data` property within `patternlab-config.json`.
diff --git a/source/_data/data.json b/source/_data/data.json
deleted file mode 100644
index 91d98d7d..00000000
--- a/source/_data/data.json
+++ /dev/null
@@ -1,75 +0,0 @@
-{
-  "key": "value",
-  "key2": "use this for variables you want to load globally",
-  "title": "Nullizzle shizznit velizzle, hizzle, suscipit own yo', gravida vizzle, arcu.",
-  "img": {
-    "avatar": {
-      "src": "http://placeimg.com/100/100/people",
-      "alt": "Avatar"
-    },
-    "square": {
-      "src": "http://placeimg.com/300/300/nature",
-      "alt": "Square"
-    },
-    "rectangle": {
-      "src": "http://placeimg.com/400/300/tech",
-      "alt": "Rectangle"
-    },
-    "landscape-4x3": {
-      "src": "http://placeimg.com/400/300/tech",
-      "alt": "4x3 Image"
-    },
-    "landscape-16x9": {
-      "src": "http://placeimg.com/640/360/tech",
-      "alt": "16x9 Image"
-    }
-  },
-  "headline": {
-    "short": "Lorizzle pimpin' dolizzle sit amet I",
-    "medium": "Rizzle adipiscing elizzle. Nullam sapien velizzle, shit volutpizzle, my"
-  },
-  "excerpt": {
-    "short": "Shizz fo shizzle mah nizzle fo rizzle, mah home g-dizzle, gravida vizzle, arcu. Pellentesque crunk tortizzle. Sed erizzle. Black izzle sheezy telliv.",
-    "medium": "Izzle crazy tempizzle sizzle. We gonna chung gangsta get down get down fo shizzle turpizzle. Away break it down black. Pellentesque bling bling rhoncus fo shizzle. In hac the bizzle platea dictumst. Black dapibizzle. Crackalackin.",
-    "long": "Curabitizzle fo shizzle diam quizzle nisi nizzle mollizzle. Suspendisse boofron. Morbi odio. Sure pizzle. Crazy orci. Shut the shizzle up maurizzle get down get down, check out this a, go to hizzle sit amizzle, malesuada izzle, pede. Pellentesque gravida. Vestibulizzle check it out mi, volutpat izzle, shiz sed, shiznit sempizzle, da bomb. Funky fresh in ipsum. Da bomb volutpat felis vizzle daahng dawg. Crizzle quis dope izzle fo shizzle my ni."
-  },
-  "description": "Fizzle crazy tortor. Sed rizzle. Ass pimpin' dolor dapibizzle turpis tempizzle fo shizzle my nizzle. Maurizzle pellentesque its fo rizzle izzle turpis. Get down get down we gonna chung nizzle. Shizzlin dizzle eleifend rhoncizzle break it down. In yo ghetto platea dictumst. Bling bling dapibizzle. Curabitur break yo neck, yall fo, pretizzle eu, go to hizzle dope, own yo' vitae, nunc. Bizzle suscipizzle. Ass semper velit sizzle fo.",
-  "url": "http://lorizzle.nl/",
-  "name": {
-    "first": "Junius",
-    "firsti": "J",
-    "middle": "Marius",
-    "middlei": "M",
-    "last": "Koolen",
-    "lasti": "K"
-  },
-  "year": {
-    "long": "2013",
-    "short": "13"
-  },
-  "month": {
-    "long": "January",
-    "short": "Jan",
-    "digit": "01"
-  },
-  "dayofweek": {
-    "long": "Sunday",
-    "short": "Sun"
-  },
-  "day": {
-    "long": "01",
-    "short": "1",
-    "ordinal": "st"
-  },
-  "hour": {
-    "long": "06",
-    "short": "6",
-    "military": "06",
-    "ampm": "am"
-  },
-  "minute": {
-    "long": "20",
-    "short": "20"
-  },
-  "seconds": "31"
-}
diff --git a/source/_data/listitems.json b/source/_data/listitems.json
deleted file mode 100644
index 42c29f0e..00000000
--- a/source/_data/listitems.json
+++ /dev/null
@@ -1,878 +0,0 @@
-{
-  "1": {
-    "title": "Nullizzle shizznit velizzle, hizzle, suscipit own yo', gravida vizzle, arcu.",
-    "img": {
-      "avatar": {
-        "src": "http://placeimg.com/100/100/people",
-        "alt": "Avatar"
-      },
-      "square": {
-        "src": "http://placeimg.com/300/300/nature",
-        "alt": "Square"
-      },
-      "rectangle": {
-        "src": "http://placeimg.com/400/300/tech",
-        "alt": "Rectangle"
-      },
-      "landscape-4x3": {
-        "src": "http://placeimg.com/400/300/tech",
-        "alt": "4x3 Image"
-      },
-      "landscape-16x9": {
-        "src": "http://placeimg.com/640/360/tech",
-        "alt": "16x9 Image"
-      }
-    },
-    "headline": {
-      "short": "Lorizzle pimpin' dolizzle sit amet I",
-      "medium": "Rizzle adipiscing elizzle. Nullam sapien velizzle, shit volutpizzle, my"
-    },
-    "excerpt": {
-      "short": "Shizz fo shizzle mah nizzle fo rizzle, mah home g-dizzle, gravida vizzle, arcu. Pellentesque crunk tortizzle. Sed erizzle. Black izzle sheezy telliv.",
-      "medium": "Izzle crazy tempizzle sizzle. We gonna chung gangsta get down get down fo shizzle turpizzle. Away break it down black. Pellentesque bling bling rhoncus fo shizzle. In hac the bizzle platea dictumst. Black dapibizzle. Crackalackin.",
-      "long": "Curabitizzle fo shizzle diam quizzle nisi nizzle mollizzle. Suspendisse boofron. Morbi odio. Sure pizzle. Crazy orci. Shut the shizzle up maurizzle get down get down, check out this a, go to hizzle sit amizzle, malesuada izzle, pede. Pellentesque gravida. Vestibulizzle check it out mi, volutpat izzle, shiz sed, shiznit sempizzle, da bomb. Funky fresh in ipsum. Da bomb volutpat felis vizzle daahng dawg. Crizzle quis dope izzle fo shizzle my ni."
-    },
-    "description": "Fizzle crazy tortor. Sed rizzle. Ass pimpin' dolor dapibizzle turpis tempizzle fo shizzle my nizzle. Maurizzle pellentesque its fo rizzle izzle turpis. Get down get down we gonna chung nizzle. Shizzlin dizzle eleifend rhoncizzle break it down. In yo ghetto platea dictumst. Bling bling dapibizzle. Curabitur break yo neck, yall fo, pretizzle eu, go to hizzle dope, own yo' vitae, nunc. Bizzle suscipizzle. Ass semper velit sizzle fo.",
-    "url": "http://lorizzle.nl/",
-    "name": {
-      "first": "Junius",
-      "firsti": "J",
-      "middle": "Marius",
-      "middlei": "M",
-      "last": "Koolen",
-      "lasti": "K"
-    },
-    "year": {
-      "long": "2013",
-      "short": "13"
-    },
-    "month": {
-      "long": "January",
-      "short": "Jan",
-      "digit": "01"
-    },
-    "dayofweek": {
-      "long": "Sunday",
-      "short": "Sun"
-    },
-    "day": {
-      "long": "01",
-      "short": "1",
-      "ordinal": "st"
-    },
-    "hour": {
-      "long": "06",
-      "short": "6",
-      "military": "06",
-      "ampm": "am"
-    },
-    "minute": {
-      "long": "20",
-      "short": "20"
-    },
-    "seconds": "31"
-  },
-  "2": {
-    "title": "Veggies sunt bona vobis, proinde vos postulo",
-    "img": {
-      "avatar": {
-        "src": "http://placeimg.com/100/100/nature",
-        "alt": "Avatar"
-      },
-      "square": {
-        "src": "http://placeimg.com/300/300/tech",
-        "alt": "Square"
-      },
-      "rectangle": {
-        "src": "http://placeimg.com/400/300/people",
-        "alt": "Rectangle"
-      },
-      "landscape-4x3": {
-        "src": "http://placeimg.com/400/300/people",
-        "alt": "4x3 Image"
-      },
-      "landscape-16x9": {
-        "src": "http://placeimg.com/640/360/people",
-        "alt": "16x9 Image"
-      }
-    },
-    "headline": {
-      "short": "Veggies sunt bona vobis, proinde vos",
-      "medium": "Postulo esse magis azuki bean burdock brussels sprout quandong komatsun"
-    },
-    "excerpt": {
-      "short": "A fava bean collard greens endive tomatillo lotus root okra winter purslane zucchini parsley spinach artichoke. Brussels sprout pea turnip catsear.",
-      "medium": "Bush tomato gumbo potato garbanzo ricebean burdock daikon coriander kale quandong. Bok choy celery leek avocado shallot horseradish aubergine parsley. Bok choy bell pepper kale celery desert raisin kakadu plum bok choy bunya nuts.",
-      "long": "Spinach tigernut. Corn cucumber grape black-eyed pea asparagus spinach avocado dulse bunya nuts epazote celery desert raisin celtuce burdock plantain yarrow napa cabbage. Plantain okra seakale endive tigernut pea sprouts asparagus corn chard peanut beet greens groundnut radicchio carrot coriander gumbo gram celtuce. Jícama nori bamboo shoot collard greens okra radicchio tomato. Catsear mustard corn tigernut celery kale water spinach bok choy."
-    },
-    "description": "Mung bean squash sorrel taro coriander collard greens gumbo bitterleaf tomato. Taro water chestnut celtuce turnip yarrow celery endive scallion black-eyed pea onion. Aubergine dulse turnip greens mustard salsify garlic soybean parsley bitterleaf desert raisin courgette.",
-    "url": "http://veggieipsum.com",
-    "name": {
-      "first": "Siguror",
-      "firsti": "S",
-      "middle": "Aron",
-      "middlei": "A",
-      "last": "Hanigan",
-      "lasti": "H"
-    },
-    "year": {
-      "long": "2013",
-      "short": "13"
-    },
-    "month": {
-      "long": "February",
-      "short": "Feb",
-      "digit": "02"
-    },
-    "dayofweek": {
-      "long": "Monday",
-      "short": "Mon"
-    },
-    "day": {
-      "long": "10",
-      "short": "10",
-      "ordinal": "th"
-    },
-    "hour": {
-      "long": "01",
-      "short": "1",
-      "military": "13",
-      "ampm": "pm"
-    },
-    "minute": {
-      "long": "20",
-      "short": "20"
-    },
-    "seconds": "31"
-  },
-  "3": {
-    "title": "Bacon ipsum dolor sit amet turducken strip steak beef ribs shank",
-    "img": {
-      "avatar": {
-        "src": "http://placeimg.com/100/100/tech",
-        "alt": "Avatar"
-      },
-      "square": {
-        "src": "http://placeimg.com/300/300/people",
-        "alt": "Square"
-      },
-      "rectangle": {
-        "src": "http://placeimg.com/400/300/nature",
-        "alt": "Rectangle"
-      },
-      "landscape-4x3": {
-        "src": "http://placeimg.com/400/300/nature",
-        "alt": "4x3 Image"
-      },
-      "landscape-16x9": {
-        "src": "http://placeimg.com/640/360/nature",
-        "alt": "16x9 Image"
-      }
-    },
-    "headline": {
-      "short": "Bacon ipsum dolor sit amet spare rib",
-      "medium": "Tongue pancetta short ribs bacon. Kielbasa ball tip cow bresaola, capic"
-    },
-    "excerpt": {
-      "short": "Tail jerky rump shoulder t-bone meatball meatloaf salami. Filet mignon shank t-bone venison, ham hock ribeye drumstick bresaola kielbasa. Frankfurter.",
-      "medium": "Doner biltong turducken leberkas. Rump swine pork loin ribeye ball tip meatloaf, pork chop ground round pig pancetta cow biltong brisket. Beef corned beef beef ribs, bacon pork belly sausage meatball boudin doner ham hock. Swine gro.",
-      "long": "Und round meatball, bacon pig leberkas corned beef tongue shoulder. Drumstick pork loin prosciutto ball tip shank pancetta spare ribs jowl pastrami. Frankfurter boudin filet mignon ribeye. Pig hamburger strip steak ham turducken prosciutto bresaola ground round pancetta frankfurter jowl. Frankfurter tongue brisket tenderloin, beef ribs pastrami biltong tail bresaola flank. Biltong pork chop beef boudin hamburger bacon. Capicola bresaola sausage."
-    },
-    "description": "Boudin sausage jerky pastrami ground round salami biltong. Sausage fatback strip steak doner pork loin, pork belly drumstick ham short loin hamburger shankle. Short ribs sirloin rump tri-tip beef biltong. Meatball pig salami, jowl pork loin fatback short loin drumstick andouille.",
-    "url": "http://baconipsum.com/",
-    "name": {
-      "first": "Teun",
-      "firsti": "T",
-      "middle": "Jodocus",
-      "middlei": "J",
-      "last": "Richard",
-      "lasti": "R"
-    },
-    "year": {
-      "long": "2013",
-      "short": "13"
-    },
-    "month": {
-      "long": "March",
-      "short": "Mar",
-      "digit": "03"
-    },
-    "dayofweek": {
-      "long": "Tuesday",
-      "short": "Tue"
-    },
-    "day": {
-      "long": "22",
-      "short": "22",
-      "ordinal": "nd"
-    },
-    "hour": {
-      "long": "04",
-      "short": "4",
-      "military": "16",
-      "ampm": "pm"
-    },
-    "minute": {
-      "long": "45",
-      "short": "45"
-    },
-    "seconds": "11"
-  },
-  "4": {
-    "title": "Whatever swag accusamus occupy, gentrify butcher tote bag",
-    "img": {
-      "avatar": {
-        "src": "http://placeimg.com/100/100/animals",
-        "alt": "Avatar"
-      },
-      "square": {
-        "src": "http://placeimg.com/300/300/arch",
-        "alt": "Square"
-      },
-      "rectangle": {
-        "src": "http://placeimg.com/400/300/people/grayscale",
-        "alt": "Rectangle"
-      },
-      "landscape-4x3": {
-        "src": "http://placeimg.com/400/300/people/greyscale",
-        "alt": "4x3 Image"
-      },
-      "landscape-16x9": {
-        "src": "http://placeimg.com/640/360/people/greyscale",
-        "alt": "16x9 Image"
-      }
-    },
-    "headline": {
-      "short": "Nesciunt sunt cillum keytar Pitchfork",
-      "medium": "Tote bag mixtape PBR Helvetica scenester forage four loko. Irure Tonx"
-    },
-    "excerpt": {
-      "short": "Golf quis +1, Wes Anderson church-key lo-fi keffiyeh selvage culpa authentic Brooklyn fap chambray. Id synth yr, 3 wolf moon locavore +1 mixtape do.",
-      "medium": "Sed single-origin coffee anim eu. Bicycle rights Neutra Truffaut pop-up. Paleo hella irure meh Banksy, Wes Anderson typewriter VHS jean shorts yr. Eiusmod officia banjo Thundercats, odio laborum magna deep v cornhole nostrud kitsch.",
-      "long": "Tattooed Williamsburg. Jean shorts proident kogi laboris. Non tote bag pariatur elit slow-carb, Vice irure eu Echo Park ea aliqua chillwave. Cornhole Etsy quinoa Pinterest cardigan. Excepteur quis forage, Blue Bottle keffiyeh velit hoodie direct trade typewriter Etsy. Fingerstache squid non, sriracha drinking vinegar Shoreditch pork belly. Paleo sartorial mollit 3 wolf moon chambray whatever, sed tote bag small batch freegan. Master cleanse."
-    },
-    "description": "Fanny pack ullamco et veniam semiotics. Shoreditch PBR reprehenderit cliche, magna Tonx aesthetic. Narwhal photo booth DIY aute post-ironic anim. Vice cliche brunch est before they sold out fap, street art Odd Future fashion axe messenger bag nihil Tonx tattooed. Nihil hashtag incididunt, do eu art party Banksy jean shorts four loko typewriter.",
-    "url": "http://hipsteripsum.me/",
-    "name": {
-      "first": "Duane",
-      "firsti": "D",
-      "middle": "Edvin",
-      "middlei": "E",
-      "last": "Wilms",
-      "lasti": "W"
-    },
-    "year": {
-      "long": "2013",
-      "short": "13"
-    },
-    "month": {
-      "long": "April",
-      "short": "Apr",
-      "digit": "04"
-    },
-    "dayofweek": {
-      "long": "Wednesday",
-      "short": "Wed"
-    },
-    "day": {
-      "long": "13",
-      "short": "13",
-      "ordinal": "th"
-    },
-    "hour": {
-      "long": "10",
-      "short": "10",
-      "military": "10",
-      "ampm": "am"
-    },
-    "minute": {
-      "long": "14",
-      "short": "14"
-    },
-    "seconds": "52"
-  },
-  "5": {
-    "title": "Marshall McLuhan Colbert bump backpack journalist vast wasteland Romenesko CPM",
-    "img": {
-      "avatar": {
-        "src": "http://placeimg.com/100/100/people/grayscale",
-        "alt": "Avatar"
-      },
-      "square": {
-        "src": "http://placeimg.com/300/300/animals",
-        "alt": "Square"
-      },
-      "rectangle": {
-        "src": "http://placeimg.com/400/300/arch",
-        "alt": "Rectangle"
-      },
-      "landscape-4x3": {
-        "src": "http://placeimg.com/400/300/arch",
-        "alt": "4x3 Image"
-      },
-      "landscape-16x9": {
-        "src": "http://placeimg.com/640/360/arch",
-        "alt": "16x9 Image"
-      }
-    },
-    "headline": {
-      "short": "Blog meme masthead DocumentCloud Fou",
-      "medium": "Square tabloid Andy Carvin stupid commenters, Nick Denton mathewi semip"
-    },
-    "excerpt": {
-      "short": "I love the Weather & Opera section Groupon copyright in the slot, Journal Register open newsroom analytics future totally blowing up on Twitter AOL.",
-      "medium": "CTR mthomps Flipboard do what you do best and link to the rest Buttry media bias Journal Register RT, newspaper strike do what you do best and link to the rest semipermeable learnings cognitive surplus mathewi, Encyclo Google News.",
-      "long": "Pulse mathewi Project Thunderdome digital first. HuffPo social media optimization try PR dying the notion of the public monetization data visualization audience atomization overcome community, libel lawyer twitterati should isn't a business model fair use innovation Facebook AOL, Walter Cronkite died for your sins horse-race coverage crowdfunding Patch but what's the business model rubber cement horse-race coverage. Lucius Nieman content farm."
-    },
-    "description": "Like button audience atomization overcome Colbert bump Free Darko inverted pyramid we will make them pay, digital circulation strategy Like button totally blowing up on Twitter church of the savvy. Pictures of Goats section open source discuss Frontline analog thinking filters paidContent.",
-    "url": "http://www.niemanlab.org/journo-ipsum/",
-    "name": {
-      "first": "Frans",
-      "firsti": "F",
-      "middle": "Fabius",
-      "middlei": "F",
-      "last": "Keegan",
-      "lasti": "K"
-    },
-    "year": {
-      "long": "2013",
-      "short": "13"
-    },
-    "month": {
-      "long": "May",
-      "short": "May",
-      "digit": "05"
-    },
-    "dayofweek": {
-      "long": "Thursday",
-      "short": "Thu"
-    },
-    "day": {
-      "long": "26",
-      "short": "26",
-      "ordinal": "th"
-    },
-    "hour": {
-      "long": "06",
-      "short": "6",
-      "military": "18",
-      "ampm": "pm"
-    },
-    "minute": {
-      "long": "37",
-      "short": "37"
-    },
-    "seconds": "24"
-  },
-  "6": {
-    "title": "Thunder, thunder, thundercats, Ho!",
-    "img": {
-      "avatar": {
-        "src": "http://placeimg.com/100/100/arch",
-        "alt": "Avatar"
-      },
-      "square": {
-        "src": "http://placeimg.com/300/300/animals",
-        "alt": "Square"
-      },
-      "rectangle": {
-        "src": "http://placeimg.com/400/300/people/grayscale",
-        "alt": "Rectangle"
-      },
-      "landscape-4x3": {
-        "src": "http://placeimg.com/400/300/people/grayscale",
-        "alt": "4x3 Image"
-      },
-      "landscape-16x9": {
-        "src": "http://placeimg.com/640/360/people/grayscale",
-        "alt": "16x9 Image"
-      }
-    },
-    "headline": {
-      "short": "Hong Kong Phooey, number one super g",
-      "medium": "Hong Kong Phooey, quicker than the human eye. He's got style, a groovy"
-    },
-    "excerpt": {
-      "short": "Style, and a car that just won't stop. When the going gets tough, he's really rough, with a Hong Kong Phooey chop (Hi-Ya!). Hong Kong Phooey, number.",
-      "medium": "One super guy. Hong Kong Phooey, quicker than the human eye. Hong Kong Phooey, he's fan-riffic! One for all and all for one, Muskehounds are always ready. One for all and all for one, helping everybody. One for all and all for one.",
-      "long": "It's a pretty story. Sharing everything with fun, that's the way to be. One for all and all for one, Muskehounds are always ready. One for all and all for one, helping everybody. One for all and all for one, can sound pretty corny. If you've got a problem chum, think how it could be. This is my boss, Jonathan Hart, a self-made millionaire, he's quite a guy. This is Mrs H., she's gorgeous, she's one lady who knows how to take care of herself."
-    },
-    "description": "Beats all you've ever saw, been in trouble with the law since the day they was born. Straight'nin' the curve, flat'nin' the hills. Someday the mountain might get 'em, but the law never will. Makin' their way, the only way they know how, that's just a little bit more than the law will allow. Just good ol' boys, wouldn't change if they could, fightin' the system like a true modern day Robin Hood.",
-    "url": "http://www.malevole.com/mv/misc/text/",
-    "name": {
-      "first": "Fergus",
-      "firsti": "F",
-      "middle": "Jon",
-      "middlei": "J",
-      "last": "Althuis",
-      "lasti": "A"
-    },
-    "year": {
-      "long": "2013",
-      "short": "13"
-    },
-    "month": {
-      "long": "June",
-      "short": "Jun",
-      "digit": "06"
-    },
-    "dayofweek": {
-      "long": "Friday",
-      "short": "Fri"
-    },
-    "day": {
-      "long": "08",
-      "short": "8",
-      "ordinal": "th"
-    },
-    "hour": {
-      "long": "11",
-      "short": "11",
-      "military": "23",
-      "ampm": "pm"
-    },
-    "minute": {
-      "long": "37",
-      "short": "37"
-    },
-    "seconds": "33"
-  },
-  "7": {
-    "title": "Yeah, I like animals better than people sometimes",
-    "img": {
-      "avatar": {
-        "src": "http://placeimg.com/100/100/any",
-        "alt": "Avatar"
-      },
-      "square": {
-        "src": "http://placeimg.com/300/300/any",
-        "alt": "Square"
-      },
-      "rectangle": {
-        "src": "http://placeimg.com/400/300/any",
-        "alt": "Rectangle"
-      },
-      "landscape-4x3": {
-        "src": "http://placeimg.com/400/300/any",
-        "alt": "4x3 Image"
-      },
-      "landscape-16x9": {
-        "src": "http://placeimg.com/640/360/any",
-        "alt": "16x9 Image"
-      }
-    },
-    "headline": {
-      "short": "Now that we know who you are, I know",
-      "medium": "Who I am. I'm not a mistake! It all makes sense! In a comic, you know"
-    },
-    "excerpt": {
-      "short": "How you can tell who the arch-villain's going to be? He's the exact opposite of the hero. And most times they're friends, like you and me! I should've known way back when... You know why, David? Because of the kids. They called me.",
-      "medium": "The lysine contingency - it's intended to prevent the spread of the animals is case they ever got off the island. Dr. Wu inserted a gene that makes a single faulty enzyme in protein metabolism. The animals can't manufacture the amin.",
-      "long": "Do you see any Teletubbies in here? Do you see a slender plastic tag clipped to my shirt with my name printed on it? Do you see a little Asian child with a blank expression on his face sitting outside on a mechanical helicopter that shakes when you put quarters in it? No? Well, that's what you see at a toy store. And you must think you're in a toy store, because you're here shopping for an infant named Jeb. Acid lysine. Unless they're."
-    },
-    "description": "Especially dogs. Dogs are the best. Every time you come home, they act like they haven't seen you in a year. And the good thing about dogs... is they got different dogs for different people. Like pit bulls. The dog of dogs. Pit bull can be the right man's best friend... or the wrong man's worst enemy. You going to give me a dog for a pet, give me a pit bull.",
-    "url": "http://slipsum.com/lite/",
-    "name": {
-      "first": "Bertil",
-      "firsti": "B",
-      "middle": "Pier",
-      "middlei": "P",
-      "last": "Aaij",
-      "lasti": "A"
-    },
-    "year": {
-      "long": "2013",
-      "short": "13"
-    },
-    "month": {
-      "long": "July",
-      "short": "Jul",
-      "digit": "07"
-    },
-    "dayofweek": {
-      "long": "Saturday",
-      "short": "Sat"
-    },
-    "day": {
-      "long": "22",
-      "short": "22",
-      "ordinal": "nd"
-    },
-    "hour": {
-      "long": "11",
-      "short": "11",
-      "military": "11",
-      "ampm": "am"
-    },
-    "minute": {
-      "long": "12",
-      "short": "12"
-    },
-    "seconds": "47"
-  },
-  "8": {
-    "title": "Webtwo ipsum dolor sit amet, eskobo chumby doostang bebo",
-    "img": {
-      "avatar": {
-        "src": "http://placeimg.com/100/100/any/grayscale",
-        "alt": "Avatar"
-      },
-      "square": {
-        "src": "http://placeimg.com/300/300/any/grayscale",
-        "alt": "Square"
-      },
-      "rectangle": {
-        "src": "http://placeimg.com/400/300/any/grayscale",
-        "alt": "Rectangle"
-      },
-      "landscape-4x3": {
-        "src": "http://placeimg.com/400/300/any/grayscale",
-        "alt": "4x3 Image"
-      },
-      "landscape-16x9": {
-        "src": "http://placeimg.com/640/360/any/grayscale",
-        "alt": "16x9 Image"
-      }
-    },
-    "headline": {
-      "short": "Webtwo ipsum dolor sit amet, eskobo",
-      "medium": "Chumby doostang bebo. Wakoopa oooj geni zoho loopt eskobo sifteo chart"
-    },
-    "excerpt": {
-      "short": "Dropio, chumby waze dopplr plugg oooj yammer jibjab imvu yuntaa knewton, mobly trulia airbnb bitly chegg tivo empressr knewton. Plickers spock voxy.",
-      "medium": "Zooomr kippt voxy zinch appjet napster trulia, zappos wufoo zapier spotify mzinga jaiku fleck, disqus lijit voxy voki yoono. Dogster elgg jibjab xobni kazaa bebo udemy sifteo kiko, elgg knewton skype mog octopart zoodles kazaa udem.",
-      "long": "Appjet spock handango empressr lijit palantir weebly dropio jibjab revver kaboodle spotify orkut mobly chegg akismet, handango ebay woopra revver joukuu kosmix unigo oooooc wufoo zanga kno zinch spock knewton. Balihoo greplin bebo squidoo skype kaboodle meebo disqus joost gooru, zlio tumblr edmodo palantir eskobo shopify kiko gsnap. Greplin balihoo chartly plugg imeem diigo trulia plickers qeyno wikia akismet, palantir grockit prezi jabber zo."
-    },
-    "description": "Wufoo diigo grockit sifteo divvyshot, unigo zooomr revver. Edmodo appjet joyent skype bubbli jajah zoodles joukuu xobni hojoki edmodo appjet, mozy mzinga akismet yuntaa joost yuntaa geni tivo insala yoono chumby, grockit sococo loopt zanga etsy cloudera koofers empressr jiglu blippy. Omgpop lanyrd joukuu sococo zimbra airbnb movity jibjab, foodzie.",
-    "url": "http://web20ipsum.com",
-    "name": {
-      "first": "Freyr",
-      "firsti": "F",
-      "middle": "Ninian",
-      "middlei": "N",
-      "last": "Hines",
-      "lasti": "H"
-    },
-    "year": {
-      "long": "2013",
-      "short": "13"
-    },
-    "month": {
-      "long": "August",
-      "short": "Aug",
-      "digit": "08"
-    },
-    "dayofweek": {
-      "long": "Sunday",
-      "short": "Sun"
-    },
-    "day": {
-      "long": "31",
-      "short": "31",
-      "ordinal": "st"
-    },
-    "hour": {
-      "long": "03",
-      "short": "3",
-      "military": "15",
-      "ampm": "pm"
-    },
-    "minute": {
-      "long": "42",
-      "short": "42"
-    },
-    "seconds": "21"
-  },
-  "9": {
-    "title": "Rebel Mission to Ord Mantell",
-    "img": {
-      "avatar": {
-        "src": "http://placeimg.com/100/100/any/sepia",
-        "alt": "Avatar"
-      },
-      "square": {
-        "src": "http://placeimg.com/300/300/any/sepia",
-        "alt": "Square"
-      },
-      "rectangle": {
-        "src": "http://placeimg.com/400/300/any/sepia",
-        "alt": "Rectangle"
-      },
-      "landscape-4x3": {
-        "src": "http://placeimg.com/400/300/any/sepia",
-        "alt": "4x3 Image"
-      },
-      "landscape-16x9": {
-        "src": "http://placeimg.com/640/360/any/sepia",
-        "alt": "16x9 Image"
-      }
-    },
-    "headline": {
-      "short": "All right. Well, take care of yourself, Han",
-      "medium": "You don't believe in the Force, do you? The Force is strong with this one"
-    },
-    "excerpt": {
-      "short": "I'm trying not to, kid. I find your lack of faith disturbing. You are a part of the Rebel Alliance and a traitor! Take her away! I want to come with.",
-      "medium": "I'm surprised you had the courage to take the responsibility yourself. Don't be too proud of this technological terror you've constructed. The ability to destroy a planet is insignificant next to the power of the Force. You don't be.",
-      "long": "A tremor in the Force. The last time I felt it was in the presence of my old master. You don't believe in the Force, do you? I have traced the Rebel spies to her. Now she is my only link to finding their secret base. A tremor in the Force. The last time I felt it was in the presence of my old master. I'm trying not to, kid. The more you tighten your grip, Tarkin, the more star systems will slip through your fingers. There's nothing for me here."
-    },
-    "description": "I find your lack of faith disturbing. A tremor in the Force. The last time I felt it was in the presence of my old master. Don't act so surprised, Your Highness. You weren't on any mercy mission this time. Several transmissions were beamed to this ship by Rebel spies. I want to know what happened to the plans they sent you. The plans you refer to will soon be back in our hands.",
-    "url": "http://chrisvalleskey.com/fillerama/",
-    "name": {
-      "first": "Jacobus",
-      "firsti": "J",
-      "middle": "Domitianus",
-      "middlei": "D",
-      "last": "Sneiders",
-      "lasti": "S"
-    },
-    "year": {
-      "long": "2013",
-      "short": "13"
-    },
-    "month": {
-      "long": "September",
-      "short": "Sep",
-      "digit": "09"
-    },
-    "dayofweek": {
-      "long": "Monday",
-      "short": "Mon"
-    },
-    "day": {
-      "long": "04",
-      "short": "4",
-      "ordinal": "th"
-    },
-    "hour": {
-      "long": "09",
-      "short": "9",
-      "military": "09",
-      "ampm": "am"
-    },
-    "minute": {
-      "long": "04",
-      "short": "4"
-    },
-    "seconds": "37"
-  },
-  "10": {
-    "title": "Help, help, I'm being repressed!",
-    "img": {
-      "avatar": {
-        "src": "http://placeimg.com/100/100/tech/grayscale",
-        "alt": "Avatar"
-      },
-      "square": {
-        "src": "http://placeimg.com/300/300/nature/grayscale",
-        "alt": "Square"
-      },
-      "rectangle": {
-        "src": "http://placeimg.com/400/300/arch/grayscale",
-        "alt": "Rectangle"
-      },
-      "landscape-4x3": {
-        "src": "http://placeimg.com/400/300/arch/grayscale",
-        "alt": "4x3 Image"
-      },
-      "landscape-16x9": {
-        "src": "http://placeimg.com/640/360/arch/grayscale",
-        "alt": "16x9 Image"
-      }
-    },
-    "headline": {
-      "short": "The swallow may fly south with the sun",
-      "medium": "On second thoughts, let's not go there. It is a silly place. You don't"
-    },
-    "excerpt": {
-      "short": "The swallow may fly south with the sun, and the house martin or the plover may seek warmer climes in winter, yet these are not strangers to our land.",
-      "medium": "The Knights Who Say Ni demand a sacrifice! Found them? In Mercia?! The coconut's tropical! Where'd you get the coconuts? Why do you think that she is a witch? I am your king. You don't vote for kings. But you are dressed as one. Oh, ow!",
-      "long": "Well, I didn't vote for you. Burn her! Be quiet! He hasn't got shit all over him. Where'd you get the coconuts? The swallow may fly south with the sun, and the house martin or the plover may seek warmer climes in winter, yet these are not strangers to our land. No! Yes, yes. A bit. But she's got a wart. Shut up! Will you shut up?! I have to push the pram a lot. Now, look here, my good man. Frighten us, English pig-dogs! Go and boil your bottoms."
-    },
-    "description": "The Knights Who Say Ni demand a sacrifice! …Are you suggesting that coconuts migrate? Knights of Ni, we are but simple travelers who seek the enchanter who lives beyond these woods. You don't frighten us, English pig-dogs! Go and boil your bottoms, sons of a silly person! I blow my nose at you, so-called Ah-thoor Keeng, you and all your silly English K-n-n-n-n-n-n-n-niggits!",
-    "url": "http://chrisvalleskey.com/fillerama/",
-    "name": {
-      "first": "Plinius",
-      "firsti": "P",
-      "middle": "Varinius",
-      "middlei": "V",
-      "last": "Sloane",
-      "lasti": "S"
-    },
-    "year": {
-      "long": "2013",
-      "short": "13"
-    },
-    "month": {
-      "long": "October",
-      "short": "Oct",
-      "digit": "10"
-    },
-    "dayofweek": {
-      "long": "Tuesday",
-      "short": "Tue"
-    },
-    "day": {
-      "long": "25",
-      "short": "25",
-      "ordinal": "th"
-    },
-    "hour": {
-      "long": "03",
-      "short": "3",
-      "military": "03",
-      "ampm": "am"
-    },
-    "minute": {
-      "long": "51",
-      "short": "51"
-    },
-    "second": "19"
-  },
-  "11": {
-    "title": "Danish danish candy canes bonbon cheesecake danish marzipan",
-    "img": {
-      "avatar": {
-        "src": "http://placeimg.com/100/100/tech/sepia",
-        "alt": "Avatar"
-      },
-      "square": {
-        "src": "http://placeimg.com/300/300/animals/sepia",
-        "alt": "Square"
-      },
-      "rectangle": {
-        "src": "http://placeimg.com/400/300/arch/sepia",
-        "alt": "Rectangle"
-      },
-      "landscape-4x3": {
-        "src": "http://placeimg.com/400/300/arch/sepia",
-        "alt": "4x3 Image"
-      },
-      "landscape-16x9": {
-        "src": "http://placeimg.com/640/360/arch/sepia",
-        "alt": "16x9 Image"
-      }
-    },
-    "headline": {
-      "short": "Carrot cake fruitcake dessert apple",
-      "medium": "Pie powder lemon drops sesame snaps cake brownie. Biscuit ice cream gin"
-    },
-    "excerpt": {
-      "short": "Bread cotton candy marzipan. Baker too go gingerbread topping cupcake donut. Fruitcake marzipan bear claw tart toffee candy cheesecake. Lemon drops.",
-      "medium": "Cupcake chupa chups pudding gummies. Unerdwear.com cupcake candy soufflé sesame snaps macaroon sesame snaps. Tart dragée muffin. Sweet roll gummi bears caramels fruitcake candy cake. Cotton candy carrot cake tart cotton candy. Jelly.",
-      "long": "Gingerbread candy icing pastry cake bonbon fruitcake donut. Powder liquorice dessert tart croissant cake. Dessert chocolate cake sweet roll candy candy sesame snaps tiramisu ice cream. Candy candy canes marzipan biscuit cupcake pie pudding. Donut cotton candy muffin. Pastry bear claw icing halvah. Gingerbread cotton candy sweet roll toffee chocolate jujubes. Wafer jujubes danish ice cream lemon drops wafer. Sesame snaps cupcake gummies browni."
-    },
-    "description": "Sugar plum wafer soufflé ice cream. Wafer topping biscuit pie gummi bears topping. Gummies toffee powder applicake oat cake cookie. Bear claw candy tootsie roll fruitcake danish applicake candy canes macaroon. Liquorice tiramisu danish cotton candy gummies. Tiramisu dessert gummi bears macaroon sweet roll jelly-o gummi bears marzipan.",
-    "url": "http://cupcakeipsum.com/",
-    "name": {
-      "first": "Matthias",
-      "firsti": "M",
-      "middle": "Brady",
-      "middlei": "B",
-      "last": "Macguinness",
-      "lasti": "M"
-    },
-    "year": {
-      "long": "2013",
-      "short": "13"
-    },
-    "month": {
-      "long": "November",
-      "short": "Nov",
-      "digit": "11"
-    },
-    "dayofweek": {
-      "long": "Wednesday",
-      "short": "Wed"
-    },
-    "day": {
-      "long": "19",
-      "short": "19",
-      "ordinal": "th"
-    },
-    "hour": {
-      "long": "11",
-      "short": "11",
-      "military": "23",
-      "ampm": "pm"
-    },
-    "minute": {
-      "long": "55",
-      "short": "55"
-    },
-    "seconds": "12"
-  },
-  "12": {
-    "title": "Cottage cheese brie lancashire. Boursin when the cheese comes out.",
-    "img": {
-      "avatar": {
-        "src": "http://placeimg.com/100/100/people/sepia",
-        "alt": "Avatar"
-      },
-      "square": {
-        "src": "http://placeimg.com/300/300/people/sepia",
-        "alt": "Square"
-      },
-      "rectangle": {
-        "src": "http://placeimg.com/400/300/people/sepia",
-        "alt": "Rectangle"
-      },
-      "landscape-4x3": {
-        "src": "http://placeimg.com/400/300/people/sepia",
-        "alt": "4x3 Image"
-      },
-      "landscape-16x9": {
-        "src": "http://placeimg.com/640/360/people/sepia",
-        "alt": "16x9 Image"
-      }
-    },
-    "headline": {
-      "short": "Cauliflower cheese cream cheese baby",
-      "medium": "Lancashire cheesy feet rubber cheese cheese and wine gouda the big chee"
-    },
-    "excerpt": {
-      "short": "Queso fromage. Taleggio boursin bavarian bergkase cream cheese when the cheese comes out everybody's happy port-salut halloumi pecorino. Caerphilly cut the cheese manchego camembert de normandie goat melted cheese cheese and biscuit.",
-      "medium": "Pecorino queso lancashire. Manchego lancashire cheesy feet emmental babybel cheese strings dolcelatte bavarian bergkase. Ricotta cheese slices cheesy grin cow cheesecake smelly cheese mascarpone lancashire. Cow say cheese babybel do.",
-      "long": "Cheesy grin macaroni cheese airedale. Fromage frais airedale cheese and wine brie cow swiss swiss mozzarella. Emmental cheese triangles edam rubber cheese pepper jack ricotta airedale airedale. Brie parmesan smelly cheese cheese strings stinking bishop cheese strings taleggio. Bocconcini blue castello gouda. Everyone loves caerphilly rubber cheese halloumi smelly cheese melted cheese melted cheese bavarian bergkase. Rubber cheese ricotta emm."
-    },
-    "description": "Queso caerphilly cheesecake. Parmesan chalk and cheese port-salut port-salut babybel cottage cheese cheesy grin pepper jack. Croque monsieur paneer st. agur blue cheese emmental airedale monterey jack bavarian bergkase cheese triangles. Halloumi parmesan.",
-    "url": "http://www.cheeseipsum.co.uk/",
-    "name": {
-      "first": "Aquila",
-      "firsti": "A",
-      "middle": "Gaius",
-      "middlei": "G",
-      "last": "Achterkamp",
-      "lasti": "A"
-    },
-    "year": {
-      "long": "2013",
-      "short": "13"
-    },
-    "month": {
-      "long": "December",
-      "short": "Dec",
-      "digit": "12"
-    },
-    "dayofweek": {
-      "long": "Thursday",
-      "short": "Thu"
-    },
-    "day": {
-      "long": "28",
-      "short": "28",
-      "ordinal": "th"
-    },
-    "hour": {
-      "long": "08",
-      "short": "8",
-      "military": "08",
-      "ampm": "am"
-    },
-    "minute": {
-      "long": "34",
-      "short": "34"
-    },
-    "seconds": "56"
-  }
-}
diff --git a/source/_meta/README.md b/source/_meta/README.md
new file mode 100644
index 00000000..c6c8c3b8
--- /dev/null
+++ b/source/_meta/README.md
@@ -0,0 +1,5 @@
+This is the default location to place meta files, otherwise known a pattern's header and footer.
+
+Pattern Lab builds each pattern while prepending and appending the header and footer. Read more about [pattern headers and footers](http://patternlab.io/docs/pattern-header-footer.html).
+
+If you wish to rename this directory, make sure you update the `paths.source.meta` property within `patternlab-config.json`.
diff --git a/source/_patterns/.gitkeep b/source/_patterns/.gitkeep
deleted file mode 100644
index c7c2a5f5..00000000
--- a/source/_patterns/.gitkeep
+++ /dev/null
@@ -1 +0,0 @@
-keeping this dir around
diff --git a/source/_patterns/README.md b/source/_patterns/README.md
new file mode 100644
index 00000000..2f89266b
--- /dev/null
+++ b/source/_patterns/README.md
@@ -0,0 +1,5 @@
+This is the default location to place pattern files.
+
+Pattern Lab builds patterns and the ui from the structure defined within. Read more about [pattern organization](http://patternlab.io/docs/pattern-organization.html).
+
+If you wish to rename this directory, make sure you update the `paths.source.patterns` property within `patternlab-config.json`.
diff --git a/source/css/README.md b/source/css/README.md
new file mode 100644
index 00000000..a6ce7bf2
--- /dev/null
+++ b/source/css/README.md
@@ -0,0 +1,5 @@
+This is the default location to place global css files.
+
+The entire contents of this directory will be recursively copied to your configured `public/` directory.
+
+If you wish to rename this directory, make sure you update the `paths.source.css` property within `patternlab-config.json`.
diff --git a/source/fonts/README.md b/source/fonts/README.md
new file mode 100644
index 00000000..ff4d4dee
--- /dev/null
+++ b/source/fonts/README.md
@@ -0,0 +1,5 @@
+This is the default location to place global font files.
+
+The entire contents of this directory will be recursively copied to your configured `public/` directory.
+
+If you wish to rename this directory, make sure you update the `paths.source.fonts` property within `patternlab-config.json`.
diff --git a/source/images/README.md b/source/images/README.md
new file mode 100644
index 00000000..86c91d56
--- /dev/null
+++ b/source/images/README.md
@@ -0,0 +1,5 @@
+This is the default location to place global image files.
+
+The entire contents of this directory will be recursively copied to your configured `public/` directory.
+
+If you wish to rename this directory, make sure you update the `paths.source.images` property within `patternlab-config.json`.
diff --git a/source/js/.gitkeep b/source/js/.gitkeep
deleted file mode 100644
index 67291bbf..00000000
--- a/source/js/.gitkeep
+++ /dev/null
@@ -1 +0,0 @@
-keeping this dir around
\ No newline at end of file
diff --git a/source/js/README.md b/source/js/README.md
new file mode 100644
index 00000000..85789385
--- /dev/null
+++ b/source/js/README.md
@@ -0,0 +1,5 @@
+This is the default location to place global javascript files.
+
+The entire contents of this directory will be recursively copied to your configured `public/` directory.
+
+If you wish to rename this directory, make sure you update the `paths.source.js` property within `patternlab-config.json`.