atlassian-archive · dpisani-atl · Jan 14, 2020
diff --git a/.changeset/tasty-bears-confess.md b/.changeset/tasty-bears-confess.md
@@ -0,0 +1,6 @@
+---
+'@brisk-docs/gatsby-generator': patch
+'@brisk-docs/pipeline-stages': patch
+---
+
+Extracted the core website pipeline generation stages into its own package.
diff --git a/.gitignore b/.gitignore
@@ -24,6 +24,8 @@ scratchings.js
 /packages/gatsby-generator/static/favicon.ico
 /packages/gatsby-generator/typings
 
+/packages/pipeline-stages/data
+
 /packages/**/bundles
 /packages/gatsby-generator/public
 /packages/**/**/yarn.lock

diff --git a/package.json b/package.json
@@ -37,7 +37,8 @@
     "packages": [
       "packages/file-viewer",
       "packages/react-changelogs",
-      "packages/gatsby-generator"
+      "packages/gatsby-generator",
+      "packages/pipeline-stages"
     ]
   },
   "dependencies": {

diff --git a/packages/file-viewer/package.json b/packages/file-viewer/package.json
@@ -10,7 +10,9 @@
   ],
   "author": "Peter Yu",
   "license": "MIT",
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "peerDependencies": {
     "react": "16.10.2",
     "react-dom": "^16.8.4"

diff --git a/packages/gatsby-generator/docs/build-pipeline/4-build-website-stage.md b/packages/gatsby-generator/docs/build-pipeline/4-build-website-stage.md
diff --git a/packages/gatsby-generator/docs/build-pipeline/5-start-website-stage.md b/packages/gatsby-generator/docs/build-pipeline/5-start-website-stage.md
diff --git a/packages/gatsby-generator/package.json b/packages/gatsby-generator/package.json
@@ -35,7 +35,6 @@
   },
   "files": [
     "static",
-    "default-pages",
     "babel.config.js",
     "gatsby-node.js",
     "gatsby-config.js",
@@ -66,6 +65,7 @@
     "@babel/preset-react": "^7.0.0",
     "@babel/runtime": "^7.4.3",
     "@brisk-docs/file-viewer": "^0.2.5",
+    "@brisk-docs/pipeline-stages": "^0.1.0",
     "@brisk-docs/react-changelogs": "^0.1.11",
     "@emotion/core": "^10.0.9",
     "@emotion/styled": "^10.0.9",

diff --git a/packages/gatsby-generator/src/pipeline/buildPagesPipeline.ts b/packages/gatsby-generator/src/pipeline/buildPagesPipeline.ts
@@ -1,25 +1,34 @@
-import scanMetadata from './stages/scan-metadata';
-import generateWebsiteInfo from './stages/generate-website-info';
-import generatePages from './stages/generate-pages';
+import {
+  scanMetadataStage,
+  generateWebsiteInfoStage,
+  generatePagesStage,
+} from '@brisk-docs/pipeline-stages';
+
 import allPaths from './getAllPaths';
 
 const buildPipeline = async (configPath?: string) => {
-  const { rootPath, wrappersPath, pagesPath, pkgRoot, config } = await allPaths(
-    configPath,
-  );
+  const {
+    rootPath,
+    wrappersPath,
+    pagesPath,
+    pkgRoot,
+    config,
+    defaultPagesPath,
+  } = await allPaths(configPath);
 
-  return scanMetadata({
+  return scanMetadataStage({
     rootPath,
     packagePathPatterns: config.packagesPaths,
     customPackageFields: config.customPackageFields,
     docs: config.docs,
     showSubExamples: config.showSubExamples,
   })
-    .then(projectData => generateWebsiteInfo(projectData))
+    .then(projectData => generateWebsiteInfoStage(projectData))
     .then(websiteInfo =>
-      generatePages({
+      generatePagesStage({
         wrappersPath,
         pagesPath,
+        defaultPagesPath,
         packageRoot: pkgRoot,
         ...websiteInfo,
         ...config,

diff --git a/packages/gatsby-generator/src/pipeline/buildPipeline.ts b/packages/gatsby-generator/src/pipeline/buildPipeline.ts
@@ -1,8 +1,10 @@
 import path from 'path';
 import fs from 'fs-extra';
-import scanMetadata from './stages/scan-metadata';
-import generateWebsiteInfo from './stages/generate-website-info';
-import generatePages from './stages/generate-pages';
+import {
+  scanMetadataStage,
+  generateWebsiteInfoStage,
+  generatePagesStage,
+} from '@brisk-docs/pipeline-stages';
 import runGatsby from './stages/run-gatsby';
 import allPaths from './getAllPaths';
 
@@ -11,22 +13,28 @@ const buildPipeline = async (
   configPath?: string,
   gatsbyOptions: string[] = [],
 ) => {
-  const { rootPath, wrappersPath, pagesPath, pkgRoot, config } = await allPaths(
-    configPath,
-  );
+  const {
+    rootPath,
+    wrappersPath,
+    pagesPath,
+    pkgRoot,
+    config,
+    defaultPagesPath,
+  } = await allPaths(configPath);
 
-  return scanMetadata({
+  return scanMetadataStage({
     rootPath,
     packagePathPatterns: config.packagesPaths,
     customPackageFields: config.customPackageFields,
     docs: config.docs,
     showSubExamples: config.showSubExamples,
   })
-    .then(projectData => generateWebsiteInfo(projectData))
+    .then(projectData => generateWebsiteInfoStage(projectData))
     .then(websiteInfo =>
-      generatePages({
+      generatePagesStage({
         wrappersPath,
         pagesPath,
+        defaultPagesPath,
         packageRoot: pkgRoot,
         ...websiteInfo,
         ...config,

diff --git a/packages/gatsby-generator/src/pipeline/devPipeline.ts b/packages/gatsby-generator/src/pipeline/devPipeline.ts
@@ -1,26 +1,34 @@
-import scanMetadata from './stages/scan-metadata';
-import generateWebsiteInfo from './stages/generate-website-info';
-import generatePages from './stages/generate-pages';
+import {
+  scanMetadataStage,
+  generateWebsiteInfoStage,
+  generatePagesStage,
+} from '@brisk-docs/pipeline-stages';
 import runGatsby from './stages/run-gatsby';
 import allPaths from './getAllPaths';
 
 const devPipeline = async (configPath?: string, gatsbyOptions?: string[]) => {
-  const { rootPath, wrappersPath, pagesPath, pkgRoot, config } = await allPaths(
-    configPath,
-  );
+  const {
+    rootPath,
+    wrappersPath,
+    pagesPath,
+    pkgRoot,
+    config,
+    defaultPagesPath,
+  } = await allPaths(configPath);
 
-  return scanMetadata({
+  return scanMetadataStage({
     rootPath,
     packagePathPatterns: config.packagesPaths,
     customPackageFields: config.customPackageFields,
     docs: config.docs,
     showSubExamples: config.showSubExamples,
   })
-    .then(projectData => generateWebsiteInfo(projectData))
+    .then(projectData => generateWebsiteInfoStage(projectData))
     .then(websiteInfo =>
-      generatePages({
+      generatePagesStage({
         wrappersPath,
         pagesPath,
+        defaultPagesPath,
         packageRoot: pkgRoot,
         ...websiteInfo,
         ...config,

diff --git a/packages/gatsby-generator/src/pipeline/getAllPaths.ts b/packages/gatsby-generator/src/pipeline/getAllPaths.ts
@@ -13,13 +13,15 @@ const getPathData = async (configPath?: string) => {
     `./un-src/components/page-templates`,
   );
   const pagesPath = path.resolve(pkgRoot, `./pages`);
+  const defaultPagesPath = path.join(pkgRoot, 'default-pages');
 
   return {
     rootPath: cwd,
     wrappersPath,
     pagesPath,
     pkgRoot,
     config,
+    defaultPagesPath,
   };
 };
 export default getPathData;
diff --git a/packages/gatsby-generator/src/pipeline/stages/build-website/index.ts b/packages/gatsby-generator/src/pipeline/stages/build-website/index.ts
@@ -1,4 +1,4 @@
-import createStage from '../make-pipeline-stage';
+import { makePipelineStage } from '@brisk-docs/pipeline-stages';
 // @ts-ignore
 import createNextServer from '../run-website/next-server';
 
@@ -10,7 +10,7 @@ interface StageInput {
   nextOptions?: string[];
 }
 
-export default createStage(
+export default makePipelineStage(
   'build-website',
   async (input: StageInput): Promise<void> => {
     return createNextServer(input);

diff --git a/packages/gatsby-generator/src/pipeline/stages/run-gatsby/index.ts b/packages/gatsby-generator/src/pipeline/stages/run-gatsby/index.ts
@@ -1,4 +1,4 @@
-import createStage from '../make-pipeline-stage';
+import { makePipelineStage } from '@brisk-docs/pipeline-stages';
 
 // @ts-ignore: Importing non-ts file with no definition
 import createGatsbyServer from './gatsby-server';
@@ -14,7 +14,7 @@ interface StageInput {
 // Boilerplate, uncomment when used
 // interface StageConfig {}
 
-export default createStage(
+export default makePipelineStage(
   'run-gatsby',
   async (input: StageInput): Promise<void> => createGatsbyServer(input),
 );
diff --git a/packages/gatsby-generator/src/pipeline/stages/run-website/index.ts b/packages/gatsby-generator/src/pipeline/stages/run-website/index.ts
@@ -1,4 +1,4 @@
-import createStage from '../make-pipeline-stage';
+import { makePipelineStage } from '@brisk-docs/pipeline-stages';
 
 // @ts-ignore: Importing non-ts file with no definition
 import createNextServer from './next-server';
@@ -14,7 +14,7 @@ interface StageInput {
 // Boilerplate, uncomment when used
 // interface StageConfig {}
 
-export default createStage(
+export default makePipelineStage(
   'run-website',
   async (input: StageInput): Promise<void> => {
     createNextServer(input);

diff --git a/packages/pipeline-stages/README.md b/packages/pipeline-stages/README.md
@@ -0,0 +1,13 @@
+# Brisk Docs Core Pipeline
+
+This library contains the core modules that Brisk Docs uses to read docs from a monorepo and generate the code for
+pages in the docs website.
+
+Brisk's website generation functionality is broken down into a series of stages that can be run independently or in a
+complete pipeline. This package exposes the following stages:
+
+ - Scan metadata: Scans the source of a monorepo and extract information about packages and docs within
+ - Generate website info: Creates a plan for the structure of the docs website using provided metadata
+ - Generate pages: Writes files to disk for all the pages to be built into the running website
+
+For creating and running a docs website end to end please use `@brisk-docs/gatsby-generator`.
diff --git a/...ck-docs-with-assets/docs/_assets/doc-3.md → ..._fixtures__/default-pages/default-page.js b/...ck-docs-with-assets/docs/_assets/doc-3.md → ..._fixtures__/default-pages/default-page.js
diff --git a/...ixtures__/docs-with-readme/docs/derpo.jpg → ...ixtures__/docs-with-readme/docs/derpo.jpg b/...ixtures__/docs-with-readme/docs/derpo.jpg → ...ixtures__/docs-with-readme/docs/derpo.jpg
diff --git a/...fixtures__/docs-with-readme/docs/doc-1.md → ...fixtures__/docs-with-readme/docs/doc-1.md b/...fixtures__/docs-with-readme/docs/doc-1.md → ...fixtures__/docs-with-readme/docs/doc-1.md
diff --git a/...fixtures__/docs-with-readme/docs/doc-2.md → ...fixtures__/docs-with-readme/docs/doc-2.md b/...fixtures__/docs-with-readme/docs/doc-2.md → ...fixtures__/docs-with-readme/docs/doc-2.md
diff --git a/...-with-readme/docs/doc-3/doc-3-2/README.md → ...-with-readme/docs/doc-3/doc-3-2/README.md b/...-with-readme/docs/doc-3/doc-3-2/README.md → ...-with-readme/docs/doc-3/doc-3-2/README.md
diff --git a/...s__/docs-with-readme/docs/doc-3/readme.md → ...s__/docs-with-readme/docs/doc-3/readme.md b/...s__/docs-with-readme/docs/doc-3/readme.md → ...s__/docs-with-readme/docs/doc-3/readme.md
diff --git a/...res__/mock-docs-with-assets/docs/doc-2.md → ...ck-docs-with-assets/docs/_assets/doc-3.md b/...res__/mock-docs-with-assets/docs/doc-2.md → ...ck-docs-with-assets/docs/_assets/doc-3.md
diff --git a/...k-docs-with-assets/docs/sub-docs/doc-1.md → ...res__/mock-docs-with-assets/docs/doc-2.md b/...k-docs-with-assets/docs/sub-docs/doc-1.md → ...res__/mock-docs-with-assets/docs/doc-2.md
diff --git a/...ock-docs-with-assets/docs/resources/1.png → ...ock-docs-with-assets/docs/resources/1.png b/...ock-docs-with-assets/docs/resources/1.png → ...ock-docs-with-assets/docs/resources/1.png
diff --git a/packages/pipeline-stages/__fixtures__/mock-docs-with-assets/docs/sub-docs/doc-1.md b/packages/pipeline-stages/__fixtures__/mock-docs-with-assets/docs/sub-docs/doc-1.md
diff --git a/...es__/mock-docs-with-sorting/docs/doc-1.md → ...es__/mock-docs-with-sorting/docs/doc-1.md b/...es__/mock-docs-with-sorting/docs/doc-1.md → ...es__/mock-docs-with-sorting/docs/doc-1.md
diff --git a/...es__/mock-docs-with-sorting/docs/doc-2.md → ...es__/mock-docs-with-sorting/docs/doc-2.md b/...es__/mock-docs-with-sorting/docs/doc-2.md → ...es__/mock-docs-with-sorting/docs/doc-2.md
diff --git a/...k-docs-with-sorting/docs/doc-3/doc-3-1.md → ...k-docs-with-sorting/docs/doc-3/doc-3-1.md b/...k-docs-with-sorting/docs/doc-3/doc-3-1.md → ...k-docs-with-sorting/docs/doc-3/doc-3-1.md
diff --git a/...h-sorting/docs/doc-3/doc-3-2/doc-3-2-1.md → ...h-sorting/docs/doc-3/doc-3-2/doc-3-2-1.md b/...h-sorting/docs/doc-3/doc-3-2/doc-3-2-1.md → ...h-sorting/docs/doc-3/doc-3-2/doc-3-2-1.md
diff --git a/...cs-with-sorting/docs/doc-3/docs.config.js → ...cs-with-sorting/docs/doc-3/docs.config.js b/...cs-with-sorting/docs/doc-3/docs.config.js → ...cs-with-sorting/docs/doc-3/docs.config.js
diff --git a/...ock-docs-with-sorting/docs/docs.config.js → ...ock-docs-with-sorting/docs/docs.config.js b/...ock-docs-with-sorting/docs/docs.config.js → ...ock-docs-with-sorting/docs/docs.config.js
diff --git a/...packages/packages/mock-package2/README.md → ...packages/packages/mock-package2/README.md b/...packages/packages/mock-package2/README.md → ...packages/packages/mock-package2/README.md
diff --git a/...kages/mock-package2/docs/extended-info.md → ...kages/mock-package2/docs/extended-info.md b/...kages/mock-package2/docs/extended-info.md → ...kages/mock-package2/docs/extended-info.md
diff --git a/...es/mock-package2/docs/special-usecase.mdx → ...es/mock-package2/docs/special-usecase.mdx b/...es/mock-package2/docs/special-usecase.mdx → ...es/mock-package2/docs/special-usecase.mdx
diff --git a/...ckages/mock-package2/examples/example1.js → ...ckages/mock-package2/examples/example1.js b/...ckages/mock-package2/examples/example1.js → ...ckages/mock-package2/examples/example1.js
diff --git a/...ckages/mock-package2/examples/example2.js → ...ckages/mock-package2/examples/example2.js b/...ckages/mock-package2/examples/example2.js → ...ckages/mock-package2/examples/example2.js
diff --git a/...ckages/mock-package2/examples/example3.js → ...ckages/mock-package2/examples/example3.js b/...ckages/mock-package2/examples/example3.js → ...ckages/mock-package2/examples/example3.js
diff --git a/...kages/packages/mock-package2/package.json → ...kages/packages/mock-package2/package.json b/...kages/packages/mock-package2/package.json → ...kages/packages/mock-package2/package.json
diff --git a/...kages/packages/mock-package2/src/index.js → ...kages/packages/mock-package2/src/index.js b/...kages/packages/mock-package2/src/index.js → ...kages/packages/mock-package2/src/index.js
diff --git a/...ckages/sub-folder/mock-package1/README.md → ...ckages/sub-folder/mock-package1/README.md b/...ckages/sub-folder/mock-package1/README.md → ...ckages/sub-folder/mock-package1/README.md
diff --git a/...older/mock-package1/docs/extended-info.md → ...older/mock-package1/docs/extended-info.md b/...older/mock-package1/docs/extended-info.md → ...older/mock-package1/docs/extended-info.md
diff --git a/...ome-subdirectory/nesting-now-supported.md → ...ome-subdirectory/nesting-now-supported.md b/...ome-subdirectory/nesting-now-supported.md → ...ome-subdirectory/nesting-now-supported.md
diff --git a/...er/mock-package1/docs/special-usecase.mdx → ...er/mock-package1/docs/special-usecase.mdx b/...er/mock-package1/docs/special-usecase.mdx → ...er/mock-package1/docs/special-usecase.mdx
diff --git a/...folder/mock-package1/examples/example1.js → ...folder/mock-package1/examples/example1.js b/...folder/mock-package1/examples/example1.js → ...folder/mock-package1/examples/example1.js
diff --git a/...folder/mock-package1/examples/example2.js → ...folder/mock-package1/examples/example2.js b/...folder/mock-package1/examples/example2.js → ...folder/mock-package1/examples/example2.js
diff --git a/...folder/mock-package1/examples/example3.js → ...folder/mock-package1/examples/example3.js b/...folder/mock-package1/examples/example3.js → ...folder/mock-package1/examples/example3.js
diff --git a/...mock-package1/examples/not-an-example.txt → ...mock-package1/examples/not-an-example.txt b/...mock-package1/examples/not-an-example.txt → ...mock-package1/examples/not-an-example.txt
diff --git a/...ge1/examples/utils-please-ignore/index.js → ...ge1/examples/utils-please-ignore/index.js b/...ge1/examples/utils-please-ignore/index.js → ...ge1/examples/utils-please-ignore/index.js
diff --git a/...ges/sub-folder/mock-package1/package.json → ...ges/sub-folder/mock-package1/package.json b/...ges/sub-folder/mock-package1/package.json → ...ges/sub-folder/mock-package1/package.json
diff --git a/...ges/sub-folder/mock-package1/src/index.js → ...ges/sub-folder/mock-package1/src/index.js b/...ges/sub-folder/mock-package1/src/index.js → ...ges/sub-folder/mock-package1/src/index.js
diff --git a/...examples/packages/mock-package1/README.md → ...examples/packages/mock-package1/README.md b/...examples/packages/mock-package1/README.md → ...examples/packages/mock-package1/README.md
diff --git a/...kages/mock-package1/docs/extended-info.md → ...kages/mock-package1/docs/extended-info.md b/...kages/mock-package1/docs/extended-info.md → ...kages/mock-package1/docs/extended-info.md
diff --git a/...ome-subdirectory/nesting-now-supported.md → ...ome-subdirectory/nesting-now-supported.md b/...ome-subdirectory/nesting-now-supported.md → ...ome-subdirectory/nesting-now-supported.md
diff --git a/...es/mock-package1/docs/special-usecase.mdx → ...es/mock-package1/docs/special-usecase.mdx b/...es/mock-package1/docs/special-usecase.mdx → ...es/mock-package1/docs/special-usecase.mdx
diff --git a/...ckages/mock-package1/examples/example1.js → ...ckages/mock-package1/examples/example1.js b/...ckages/mock-package1/examples/example1.js → ...ckages/mock-package1/examples/example1.js
diff --git a/...ckages/mock-package1/examples/example2.js → ...ckages/mock-package1/examples/example2.js b/...ckages/mock-package1/examples/example2.js → ...ckages/mock-package1/examples/example2.js
diff --git a/...ckages/mock-package1/examples/example3.js → ...ckages/mock-package1/examples/example3.js b/...ckages/mock-package1/examples/example3.js → ...ckages/mock-package1/examples/example3.js
diff --git a/...mock-package1/examples/not-an-example.txt → ...mock-package1/examples/not-an-example.txt b/...mock-package1/examples/not-an-example.txt → ...mock-package1/examples/not-an-example.txt
diff --git a/...ge1/examples/utils-please-ignore/index.js → ...ge1/examples/utils-please-ignore/index.js b/...ge1/examples/utils-please-ignore/index.js → ...ge1/examples/utils-please-ignore/index.js
diff --git a/...mples/packages/mock-package1/package.json → ...mples/packages/mock-package1/package.json b/...mples/packages/mock-package1/package.json → ...mples/packages/mock-package1/package.json
diff --git a/...es/packages/mock-package1/src/examples.js → ...es/packages/mock-package1/src/examples.js b/...es/packages/mock-package1/src/examples.js → ...es/packages/mock-package1/src/examples.js
diff --git a/...mples/packages/mock-package1/src/index.js → ...mples/packages/mock-package1/src/index.js b/...mples/packages/mock-package1/src/index.js → ...mples/packages/mock-package1/src/index.js
diff --git a/...ck-package1/src/test-examples/examples.js → ...ck-package1/src/test-examples/examples.js b/...ck-package1/src/test-examples/examples.js → ...ck-package1/src/test-examples/examples.js
diff --git a/...ckages/mock-package1/src/view/examples.js → ...ckages/mock-package1/src/view/examples.js b/...ckages/mock-package1/src/view/examples.js → ...ckages/mock-package1/src/view/examples.js
diff --git a/...ock-package1/src/view/sub-dir/examples.js → ...ock-package1/src/view/sub-dir/examples.js b/...ock-package1/src/view/sub-dir/examples.js → ...ock-package1/src/view/sub-dir/examples.js
diff --git a/...ixtures__/simple-mock-docs/docs/derpo.jpg → ...ixtures__/simple-mock-docs/docs/derpo.jpg b/...ixtures__/simple-mock-docs/docs/derpo.jpg → ...ixtures__/simple-mock-docs/docs/derpo.jpg
diff --git a/...fixtures__/simple-mock-docs/docs/doc-1.md → ...fixtures__/simple-mock-docs/docs/doc-1.md b/...fixtures__/simple-mock-docs/docs/doc-1.md → ...fixtures__/simple-mock-docs/docs/doc-1.md
diff --git a/...fixtures__/simple-mock-docs/docs/doc-2.md → ...fixtures__/simple-mock-docs/docs/doc-2.md b/...fixtures__/simple-mock-docs/docs/doc-2.md → ...fixtures__/simple-mock-docs/docs/doc-2.md
diff --git a/...__/simple-mock-docs/docs/doc-3/doc-3-1.md → ...__/simple-mock-docs/docs/doc-3/doc-3-1.md b/...__/simple-mock-docs/docs/doc-3/doc-3-1.md → ...__/simple-mock-docs/docs/doc-3/doc-3-1.md
diff --git a/...mock-docs/docs/doc-3/doc-3-2/doc-3-2-1.md → ...mock-docs/docs/doc-3/doc-3-2/doc-3-2-1.md b/...mock-docs/docs/doc-3/doc-3-2/doc-3-2-1.md → ...mock-docs/docs/doc-3/doc-3-2/doc-3-2-1.md
diff --git a/...kages/packages/mock-package1/CHANGELOG.md → ...kages/packages/mock-package1/CHANGELOG.md b/...kages/packages/mock-package1/CHANGELOG.md → ...kages/packages/mock-package1/CHANGELOG.md
diff --git a/...packages/packages/mock-package1/README.md → ...packages/packages/mock-package1/README.md b/...packages/packages/mock-package1/README.md → ...packages/packages/mock-package1/README.md
diff --git a/...kages/mock-package1/docs/extended-info.md → ...kages/mock-package1/docs/extended-info.md b/...kages/mock-package1/docs/extended-info.md → ...kages/mock-package1/docs/extended-info.md
diff --git a/...ome-subdirectory/nesting-now-supported.md → ...ome-subdirectory/nesting-now-supported.md b/...ome-subdirectory/nesting-now-supported.md → ...ome-subdirectory/nesting-now-supported.md
diff --git a/...es/mock-package1/docs/special-usecase.mdx → ...es/mock-package1/docs/special-usecase.mdx b/...es/mock-package1/docs/special-usecase.mdx → ...es/mock-package1/docs/special-usecase.mdx
diff --git a/...ckages/mock-package1/examples/example1.js → ...ckages/mock-package1/examples/example1.js b/...ckages/mock-package1/examples/example1.js → ...ckages/mock-package1/examples/example1.js
diff --git a/...ckages/mock-package1/examples/example2.js → ...ckages/mock-package1/examples/example2.js b/...ckages/mock-package1/examples/example2.js → ...ckages/mock-package1/examples/example2.js
diff --git a/...ckages/mock-package1/examples/example3.js → ...ckages/mock-package1/examples/example3.js b/...ckages/mock-package1/examples/example3.js → ...ckages/mock-package1/examples/example3.js
diff --git a/...mock-package1/examples/not-an-example.txt → ...mock-package1/examples/not-an-example.txt b/...mock-package1/examples/not-an-example.txt → ...mock-package1/examples/not-an-example.txt
diff --git a/...ge1/examples/utils-please-ignore/index.js → ...ge1/examples/utils-please-ignore/index.js b/...ge1/examples/utils-please-ignore/index.js → ...ge1/examples/utils-please-ignore/index.js
diff --git a/...kages/packages/mock-package1/package.json → ...kages/packages/mock-package1/package.json b/...kages/packages/mock-package1/package.json → ...kages/packages/mock-package1/package.json
diff --git a/...kages/packages/mock-package1/src/index.js → ...kages/packages/mock-package1/src/index.js b/...kages/packages/mock-package1/src/index.js → ...kages/packages/mock-package1/src/index.js
diff --git a/...packages/packages/mock-package2/README.md → ...packages/packages/mock-package2/README.md b/...packages/packages/mock-package2/README.md → ...packages/packages/mock-package2/README.md
diff --git a/...kages/mock-package2/docs/extended-info.md → ...kages/mock-package2/docs/extended-info.md b/...kages/mock-package2/docs/extended-info.md → ...kages/mock-package2/docs/extended-info.md
diff --git a/...es/mock-package2/docs/special-usecase.mdx → ...es/mock-package2/docs/special-usecase.mdx b/...es/mock-package2/docs/special-usecase.mdx → ...es/mock-package2/docs/special-usecase.mdx
diff --git a/...ckages/mock-package2/examples/example1.js → ...ckages/mock-package2/examples/example1.js b/...ckages/mock-package2/examples/example1.js → ...ckages/mock-package2/examples/example1.js
diff --git a/...ckages/mock-package2/examples/example2.js → ...ckages/mock-package2/examples/example2.js b/...ckages/mock-package2/examples/example2.js → ...ckages/mock-package2/examples/example2.js
diff --git a/...ckages/mock-package2/examples/example3.js → ...ckages/mock-package2/examples/example3.js b/...ckages/mock-package2/examples/example3.js → ...ckages/mock-package2/examples/example3.js
diff --git a/...kages/packages/mock-package2/package.json → ...kages/packages/mock-package2/package.json b/...kages/packages/mock-package2/package.json → ...kages/packages/mock-package2/package.json
diff --git a/...kages/packages/mock-package2/src/index.js → ...kages/packages/mock-package2/src/index.js b/...kages/packages/mock-package2/src/index.js → ...kages/packages/mock-package2/src/index.js
diff --git a/...kages/mock-package3/docs/extended-info.md → ...kages/mock-package3/docs/extended-info.md b/...kages/mock-package3/docs/extended-info.md → ...kages/mock-package3/docs/extended-info.md
diff --git a/...es/mock-package3/docs/special-usecase.mdx → ...es/mock-package3/docs/special-usecase.mdx b/...es/mock-package3/docs/special-usecase.mdx → ...es/mock-package3/docs/special-usecase.mdx
diff --git a/...ckages/mock-package3/examples/example1.js → ...ckages/mock-package3/examples/example1.js b/...ckages/mock-package3/examples/example1.js → ...ckages/mock-package3/examples/example1.js
diff --git a/...ckages/mock-package3/examples/example2.js → ...ckages/mock-package3/examples/example2.js b/...ckages/mock-package3/examples/example2.js → ...ckages/mock-package3/examples/example2.js
diff --git a/...ckages/mock-package3/examples/example3.js → ...ckages/mock-package3/examples/example3.js b/...ckages/mock-package3/examples/example3.js → ...ckages/mock-package3/examples/example3.js
diff --git a/...kages/packages/mock-package3/package.json → ...kages/packages/mock-package3/package.json b/...kages/packages/mock-package3/package.json → ...kages/packages/mock-package3/package.json
diff --git a/...kages/packages/mock-package3/src/index.js → ...kages/packages/mock-package3/src/index.js b/...kages/packages/mock-package3/src/index.js → ...kages/packages/mock-package3/src/index.js
diff --git a/...s/build-pipeline/1-scan-metadata-stage.md → ...line-stages/docs/1-scan-metadata-stage.md b/...s/build-pipeline/1-scan-metadata-stage.md → ...line-stages/docs/1-scan-metadata-stage.md
diff --git a/...pipeline/2-generate-website-info-stage.md → ...ges/docs/2-generate-website-info-stage.md b/...pipeline/2-generate-website-info-stage.md → ...ges/docs/2-generate-website-info-stage.md
diff --git a/.../build-pipeline/3-generate-pages-stage.md → ...ine-stages/docs/3-generate-pages-stage.md b/.../build-pipeline/3-generate-pages-stage.md → ...ine-stages/docs/3-generate-pages-stage.md
diff --git a/...y-generator/docs/build-pipeline/README.md → packages/pipeline-stages/docs/README.md b/...y-generator/docs/build-pipeline/README.md → packages/pipeline-stages/docs/README.md
@@ -7,5 +7,3 @@ Brisk docs uses a pipeline of build stages to take the docs in a codebase and tu
 - [Scan metadata stage](./1-scan-metadata-stage.md)
 - [Generate website info stage](./2-generate-website-info-stage.md)
 - [Generate pages stage](./3-generate-pages-stage.md)
-- [Build website stage](./4-build-website-stage.md)
-- [Start website stage](./5-start-website-stage.md)
diff --git a/packages/pipeline-stages/package.json b/packages/pipeline-stages/package.json
@@ -0,0 +1,28 @@
+{
+  "name": "@brisk-docs/pipeline-stages",
+  "version": "0.1.0",
+  "main": "dist/pipeline-stages.cjs.js",
+  "files": [
+    "default-pages",
+    "dist"
+  ],
+  "dependencies": {
+    "@babel/runtime": "^7.4.3",
+    "filenamify": "^4.0.0",
+    "fs-extra": "^7.0.1",
+    "glob": "^7.1.3",
+    "js-yaml": "^3.13.1",
+    "lodash.flatten": "^4.4.0",
+    "outdent": "^0.7.0",
+    "pkg-dir": "^4.2.0",
+    "remark-frontmatter": "^1.3.2",
+    "remark-parse": "^6.0.3",
+    "title-case": "^2.1.1",
+    "unified": "^7.1.0"
+  },
+  "peerDependencies": {},
+  "devDependencies": {
+    "jest-fixtures": "^0.6.0",
+    "mock-fs": "^4.10.1"
+  }
+}
diff --git a/...ne/stages/common/configuration-options.ts → ...tages/src/common/configuration-options.ts b/...ne/stages/common/configuration-options.ts → ...tages/src/common/configuration-options.ts
@@ -1,4 +1,4 @@
-import { TemplateSpecifier } from '../../../../types';
+import { TemplateSpecifier } from '../types';
 
 export interface ProjectDocsConfig {
   // absolute path to the docs in the filesystem

diff --git a/.../src/pipeline/stages/common/page-specs.ts → .../pipeline-stages/src/common/page-specs.ts b/.../src/pipeline/stages/common/page-specs.ts → .../pipeline-stages/src/common/page-specs.ts
diff --git a/...rc/pipeline/stages/common/project-info.ts → ...ipeline-stages/src/common/project-info.ts b/...rc/pipeline/stages/common/project-info.ts → ...ipeline-stages/src/common/project-info.ts
diff --git a/...s__/page-writers.integration.test.js.snap → ...s__/page-writers.integration.test.js.snap b/...s__/page-writers.integration.test.js.snap → ...s__/page-writers.integration.test.js.snap
diff --git a/...c/pipeline/stages/generate-pages/index.ts → ...peline-stages/src/generate-pages/index.ts b/...c/pipeline/stages/generate-pages/index.ts → ...peline-stages/src/generate-pages/index.ts
@@ -26,6 +26,8 @@ export type StageInput = {
   pagesPath: string;
   // The absolute path to the root of the package.
   packageRoot: string;
+  // The absolute path to the directory containing default pages
+  defaultPagesPath: string;
 } & WebsiteInfoSpec &
   BriskConfiguration;
 
@@ -47,9 +49,9 @@ const generateGenericPage = (
 export default createStage(
   'generate-pages',
   async (input: StageInput): Promise<StageOutput> => {
-    const { pagesPath, wrappersPath } = input;
+    const { pagesPath, wrappersPath, defaultPagesPath } = input;
     await cleanPages(pagesPath);
-    await addBasePages(input.packageRoot, pagesPath);
+    await addBasePages(defaultPagesPath, pagesPath);
 
     const generatorConfig = { pagesPath, wrappersPath };
 

diff --git a/...stages/generate-pages/integration.test.ts → ...es/src/generate-pages/integration.test.ts b/...stages/generate-pages/integration.test.ts → ...es/src/generate-pages/integration.test.ts
@@ -1,14 +1,16 @@
-import { createTempDir } from 'jest-fixtures';
+import { createTempDir, copyFixtureIntoTempDir } from 'jest-fixtures';
 import path from 'path';
 import fs from 'fs-extra';
 import generatePagesStage, { StageInput } from './index';
 
 describe('Generate pages build stage integration', () => {
   let pagesPath: string;
   let wrappersPath: string;
+  let defaultPagesPath: string;
 
   beforeEach(async () => {
     const cwd = await createTempDir();
+    defaultPagesPath = await copyFixtureIntoTempDir(__dirname, 'default-pages');
     pagesPath = path.join(cwd, 'pages');
     wrappersPath = path.join(cwd, 'wrappers');
   });
@@ -18,6 +20,7 @@ describe('Generate pages build stage integration', () => {
     const input: StageInput = {
       pagesPath,
       wrappersPath,
+      defaultPagesPath,
       pages: {
         packageDocPages: [
           {
@@ -79,7 +82,7 @@ describe('Generate pages build stage integration', () => {
           },
         ],
       },
-      packageRoot: path.resolve(__dirname, '..', '..', '..', '..'),
+      packageRoot: path.resolve(__dirname, '..', '..'),
       sitemap: { packages: [], docs: { docs: [] } },
       readmePageData: [],
       packagesMeta: [],
@@ -123,5 +126,8 @@ describe('Generate pages build stage integration', () => {
       path.join(pagesPath, 'package-home-pages'),
     );
     expect(packageHomePages).toEqual(['home1.js']);
+
+    const rootPages = await fs.readdir(pagesPath);
+    expect(rootPages).toContain('default-page.js');
   });
 });
diff --git a/...te-pages/page-writers.integration.test.js → ...te-pages/page-writers.integration.test.js b/...te-pages/page-writers.integration.test.js → ...te-pages/page-writers.integration.test.js