Topics/output dir

docs/docs/building-with-components.md

@@ -161,9 +161,10 @@ import React from "react";
 import favicon from "./favicon.png";
 
 let inlinedStyles = "";
+const buildDirectory = process.env.GATSBY_BUILD_DIR || `public`
 if (process.env.NODE_ENV === "production") {
   try {
-    inlinedStyles = require("!raw-loader!../public/styles.css");
+    inlinedStyles = require(`!raw-loader!../${buildDirectory}/styles.css`);
   } catch (e) {
     console.log(e);
   }

examples/client-only-paths/src/html.js

@@ -4,9 +4,10 @@ import { TypographyStyle } from "react-typography"
 import typography from "./utils/typography"
 
 let stylesStr
+const buildDirectory = process.env.GATSBY_BUILD_DIR || `public`
 if (process.env.NODE_ENV === `production`) {
   try {
-    stylesStr = require(`!raw-loader!../public/styles.css`)
+    stylesStr = require(`!raw-loader!../${buildDirectory}/styles.css`)
   } catch (e) {
     console.log(e)
   }

examples/using-postcss-sass/src/html.js

@@ -6,9 +6,10 @@ import { TypographyStyle } from "react-typography"
 const typography = new Typography()
 
 let stylesStr
+const buildDirectory = process.env.GATSBY_BUILD_DIR || `public`
 if (process.env.NODE_ENV === `production`) {
   try {
-    stylesStr = require(`!raw-loader!../public/styles.css`)
+    stylesStr = require(`!raw-loader!../${buildDirectory}/styles.css`)
   } catch (e) {
     console.log(e)
   }

examples/using-remark/src/html.js

@@ -4,9 +4,10 @@ import { TypographyStyle } from "react-typography"
 import typography from "./utils/typography"
 
 let stylesStr
+const buildDirectory = process.env.GATSBY_BUILD_DIR || `public`
 if (process.env.NODE_ENV === `production`) {
   try {
-    stylesStr = require(`!raw-loader!../public/styles.css`)
+    stylesStr = require(`!raw-loader!../${buildDirectory}/styles.css`)
   } catch (e) {
     console.log(e)
   }

examples/using-sass/src/html.js

@@ -6,9 +6,10 @@ import { TypographyStyle } from "react-typography"
 const typography = new Typography()
 
 let stylesStr
+const buildDirectory = process.env.GATSBY_BUILD_DIR || `public`
 if (process.env.NODE_ENV === `production`) {
   try {
-    stylesStr = require(`!raw-loader!../public/styles.css`)
+    stylesStr = require(`!raw-loader!../${buildDirectory}/styles.css`)
   } catch (e) {
     console.log(e)
   }

examples/using-styled-components/src/html.js

@@ -6,7 +6,8 @@ import typography from "./utils/typography"
 let stylesStr
 if (process.env.NODE_ENV === `production`) {
   try {
-    stylesStr = require(`!raw-loader!../public/styles.css`)
+    const buildDirectory = process.env.GATSBY_BUILD_DIR || `public`
+    stylesStr = require(`!raw-loader!../${buildDirectory}/styles.css`)
   } catch (e) {
     console.log(e)
   }

examples/using-styletron/src/html.js

@@ -4,9 +4,10 @@ import { TypographyStyle } from "react-typography"
 import typography from "./utils/typography"
 
 let stylesStr
+const buildDirectory = process.env.GATSBY_BUILD_DIR || `public`
 if (process.env.NODE_ENV === `production`) {
   try {
-    stylesStr = require(`!raw-loader!../public/styles.css`)
+    stylesStr = require(`!raw-loader!../${buildDirectory}/styles.css`)
   } catch (e) {
     console.log(e)
   }

examples/using-stylus/src/html.js

@@ -6,9 +6,10 @@ import { TypographyStyle } from "react-typography"
 const typography = new Typography()
 
 let stylesStr
+const buildDirectory = process.env.GATSBY_BUILD_DIR || `public`
 if (process.env.NODE_ENV === `production`) {
   try {
-    stylesStr = require(`!raw-loader!../public/styles.css`)
+    stylesStr = require(`!raw-loader!../${buildDirectory}/styles.css`)
   } catch (e) {
     console.log(e)
   }

examples/using-typescript/src/html.tsx

@@ -5,9 +5,10 @@ import * as React from "react";
 
 // Load production style
 let styles: string;
+const buildDirectory = process.env.GATSBY_BUILD_DIR || `public`
 if (process.env.NODE_ENV === `production`) {
   try {
-    styles = require("!raw-loader!../public/styles.css");
+    styles = require(`!raw-loader!../${buildDirectory}/styles.css`);
   } catch (err) {
     console.log(err);
   }

infrastructure/build-site.js

@@ -142,7 +142,8 @@ const Main = async () => {
       updateBuild(buildId, "FAILURE")
       process.exit(code)
     }
-    const publicDir = `${pathToSite}/public`
+    const buildDirectory = process.env.GATSBY_BUILD_DIR || `public`
+    const publicDir = `${pathToSite}/${buildDirectory}`
     console.log(`uploading files from ${publicDir}`)
 
     // 1. Push built files to s3 bucket

packages/gatsby-cli/src/create-cli.js

@@ -103,10 +103,22 @@ function buildLocalCommands(cli, isLocalSite) {
           alias: `https`,
           type: `boolean`,
           describe: `Use HTTPS. See https://www.gatsbyjs.org/docs/local-https/ for an initial setup guide`,
+        })
+        .option(`build-dir`, {
+          alias: `buildDirectory`,
+          type: `string`,
+          default: `public`,
+          describe: `Set build directory. Defaults to public`,
         }),
     handler: handlerP(
       getCommandHandler(`develop`, (args, cmd) => {
         process.env.NODE_ENV = process.env.NODE_ENV || `development`
+
+        process.env.GATSBY_BUILD_DIR = path.resolve(args.buildDirectory) || `public`
+        if (!fs.existsSync(process.env.GATSBY_BUILD_DIR)) {
+          fs.mkdirSync(process.env.GATSBY_BUILD_DIR)
+        }
+
         cmd(args)
         // Return an empty promise to prevent handlerP from exiting early.
         // The development server shouldn't ever exit until the user directly
@@ -128,10 +140,21 @@ function buildLocalCommands(cli, isLocalSite) {
         type: `boolean`,
         default: false,
         describe: `Build site without uglifying JS bundles (for debugging).`,
+      }).option(`build-dir`, {
+        alias: `buildDirectory`,
+        type: `string`,
+        default: `public`,
+        describe: `Set build directory. Defaults to public`,
       }),
     handler: handlerP(
       getCommandHandler(`build`, (args, cmd) => {
         process.env.NODE_ENV = `production`
+
+        process.env.GATSBY_BUILD_DIR = path.resolve(args.buildDirectory) || `public`
+        if (!fs.existsSync(process.env.GATSBY_BUILD_DIR)) {
+          fs.mkdirSync(process.env.GATSBY_BUILD_DIR)
+        }
+
         return cmd(args)
       })
     ),

packages/gatsby-plugin-feed/src/gatsby-node.js

@@ -3,7 +3,8 @@ import RSS from "rss"
 import merge from "lodash.merge"
 import { defaultOptions, runQuery, writeFile } from "./internals"
 
-const publicPath = `./public`
+const buildDirectory = process.env.GATSBY_BUILD_DIR || `public`
+const publicPath = `./${buildDirectory}`
 
 // A default function to transform query data into feed entries.
 const serialize = ({ query: { site, allMarkdownRemark } }) =>

packages/gatsby-plugin-manifest/src/gatsby-node.js

@@ -3,13 +3,14 @@ const path = require(`path`)
 const Promise = require(`bluebird`)
 const sharp = require(`sharp`)
 const defaultIcons = require(`./common.js`).defaultIcons
+const buildDirectory = process.env.GATSBY_BUILD_DIR || `public`
 
 sharp.simd(true)
 
 function generateIcons(icons, srcIcon) {
   return Promise.map(icons, icon => {
     const size = parseInt(icon.sizes.substring(0, icon.sizes.lastIndexOf(`x`)))
-    const imgPath = path.join(`public`, icon.src)
+    const imgPath = path.join(buildDirectory, icon.src)
 
     return sharp(srcIcon)
       .resize(size)
@@ -34,7 +35,7 @@ exports.onPostBuild = (args, pluginOptions) =>
 
     // Determine destination path for icons.
     const iconPath = path.join(
-      `public`,
+      buildDirectory,
       manifest.icons[0].src.substring(0, manifest.icons[0].src.lastIndexOf(`/`))
     )
 
@@ -44,7 +45,7 @@ exports.onPostBuild = (args, pluginOptions) =>
     }
 
     fs.writeFileSync(
-      path.join(`public`, `manifest.json`),
+      path.join(buildDirectory, `manifest.json`),
       JSON.stringify(manifest)
     )
 

packages/gatsby-plugin-netlify/README.md

@@ -76,7 +76,7 @@ An example:
 Link paths are specially handed by this plugin. Since most files are processed
 and cache-busted through Gatsby (with a file hash), the plugin will transform
 any base file names to the hashed variants. If the file is not hashed, it will
-ensure the path is valid relative to the output `public` folder. You should be
+ensure the path is valid relative to the build `public` folder. You should be
 able to reference assets imported through javascript in the `static` folder.
 
 Do not specify the public path in the config, as the plugin will provide it for

packages/gatsby-plugin-netlify/src/plugin-data.js

@@ -31,7 +31,8 @@ function applyLayouts(pages, layouts) {
 // hashed filenames and ensure we pull in the componentChunkName and layoutComponentChunkName.
 export default function makePluginData(store, assetsManifest, pathPrefix) {
   const { program, layouts, pages: storePages } = store.getState()
-  const publicFolder = buildPrefixer(program.directory, `public`)
+  const buildDirectory = process.env.GATSBY_BUILD_DIR || `public`
+  const publicFolder = buildPrefixer(program.directory, buildDirectory)
   const stats = require(publicFolder(`stats.json`))
   const chunkManifest = normalizeStats(stats)
   const pages = applyLayouts(storePages, layouts)

packages/gatsby-plugin-offline/src/gatsby-node.js

@@ -14,7 +14,7 @@ exports.createPages = ({ boundActionCreators }) => {
 }
 
 exports.onPostBuild = (args, pluginOptions) => {
-  const rootDir = `public`
+  const rootDir = process.env.GATSBY_BUILD_DIR || `public`
 
   const options = {
     staticFileGlobs: [
@@ -27,7 +27,7 @@ exports.onPostBuild = (args, pluginOptions) => {
     ],
     stripPrefix: rootDir,
     // If `pathPrefix` is configured by user, we should replace
-    // the `public` prefix with `pathPrefix`.
+    // the build directory (default: `public`) prefix with `pathPrefix`.
     // See more at:
     // https://github.com/GoogleChrome/sw-precache#replaceprefix-string
     replacePrefix: args.pathPrefix || ``,
@@ -56,5 +56,5 @@ exports.onPostBuild = (args, pluginOptions) => {
 
   const combinedOptions = _.defaults(pluginOptions, options)
 
-  return precache.write(`public/sw.js`, combinedOptions)
+  return precache.write(`${rootDir}/sw.js`, combinedOptions)
 }

packages/gatsby-plugin-sharp/src/index.js

@@ -173,7 +173,7 @@ const processFile = (file, jobs, cb, reporter) => {
               ],
             })
             .then(imageminBuffer => {
-              fs.writeFile(job.outputPath, imageminBuffer, onFinish)
+              fs.writeFile(job.buildPath, imageminBuffer, onFinish)
             })
             .catch(onFinish)
         )
@@ -191,14 +191,14 @@ const processFile = (file, jobs, cb, reporter) => {
               plugins: [imageminWebp({ quality: args.quality })],
             })
             .then(imageminBuffer => {
-              fs.writeFile(job.outputPath, imageminBuffer, onFinish)
+              fs.writeFile(job.buildPath, imageminBuffer, onFinish)
             })
             .catch(onFinish)
         )
         .catch(onFinish)
       // any other format (jpeg, tiff) - don't compress it just handle output
     } else {
-      clonedPipeline.toFile(job.outputPath, onFinish)
+      clonedPipeline.toFile(job.buildPath, onFinish)
     }
   })
 }
@@ -210,7 +210,7 @@ const q = queue((task, callback) => {
 
 const queueJob = (job, reporter) => {
   const inputFileKey = job.file.absolutePath.replace(/\./g, `%2E`)
-  const outputFileKey = job.outputPath.replace(/\./g, `%2E`)
+  const outputFileKey = job.buildPath.replace(/\./g, `%2E`)
   const jobPath = `${inputFileKey}.${outputFileKey}`
 
   // Check if the job has already been queued. If it has, there's nothing
@@ -220,7 +220,7 @@ const queueJob = (job, reporter) => {
   }
 
   // Check if the output file already exists so we don't redo work.
-  if (fs.existsSync(job.outputPath)) {
+  if (fs.existsSync(job.buildPath)) {
     return
   }
 
@@ -304,7 +304,8 @@ function queueImageResizing({ file, args = {}, reporter }) {
   const imgSrc = `/${file.name}-${
     file.internal.contentDigest
   }-${argsDigestShort}.${fileExtension}`
-  const filePath = path.join(process.cwd(), `public`, `static`, imgSrc)
+  const buildDirectory = process.env.GATSBY_BUILD_DIR || `public`
+  const filePath = path.join(process.cwd(), buildDirectory, `static`, imgSrc)
 
   // Create function to call when the image is finished.
   let outsideResolve, outsideReject
@@ -342,7 +343,7 @@ function queueImageResizing({ file, args = {}, reporter }) {
     outsideResolve,
     outsideReject,
     inputPath: file.absolutePath,
-    outputPath: filePath,
+    buildPath: filePath,
   }
 
   queueJob(job, reporter)

packages/gatsby-plugin-sitemap/src/gatsby-node.js

@@ -2,7 +2,8 @@ import path from "path"
 import sitemap from "sitemap"
 import { defaultOptions, runQuery, writeFile } from "./internals"
 
-const publicPath = `./public`
+const buildDirectory = process.env.GATSBY_BUILD_DIR || `public`
+const publicPath = `./${buildDirectory}`
 
 exports.onPostBuild = async ({ graphql, pathPrefix }, pluginOptions) => {
   const options = { ...pluginOptions }

packages/gatsby-remark-copy-linked-files/src/__tests__/index.js

@@ -171,8 +171,9 @@ describe(`gatsby-remark-copy-linked-files`, () => {
 
   describe(`options.destinationDir`, () => {
     const imagePath = `images/sample-image.gif`
+    const buildDirectory = process.env.GATSBY_BUILD_DIR || `public`
 
-    it(`throws an error if the destination directory is not within 'public'`, async () => {
+    it(`throws an error if the destination directory is not within '${buildDirectory}'`, async () => {
       const markdownAST = remark.parse(`![some absolute image](${imagePath})`)
       const invalidDestinationDir = `../destination`
       expect.assertions(2)
@@ -192,7 +193,7 @@ describe(`gatsby-remark-copy-linked-files`, () => {
       const validDestinationDir = `path/to/dir`
       const expectedNewPath = path.posix.join(
         process.cwd(),
-        `public`,
+        buildDirectory,
         validDestinationDir,
         `/undefined-undefined.gif`
       )
@@ -246,7 +247,7 @@ describe(`gatsby-remark-copy-linked-files`, () => {
       const markdownAST = remark.parse(`![some absolute image](${imagePath})`)
       const expectedNewPath = path.posix.join(
         process.cwd(),
-        `public`,
+        buildDirectory,
         `/undefined-undefined.gif`
       )
       expect.assertions(3)

packages/gatsby-remark-copy-linked-files/src/index.js

@@ -7,8 +7,6 @@ const _ = require(`lodash`)
 const cheerio = require(`cheerio`)
 const imageSize = require(`probe-image-size`)
 
-const DEPLOY_DIR = `public`
-
 const invalidDestinationDirMessage = dir =>
   `[gatsby-remark-copy-linked-files You have supplied an invalid destination directory. The destination directory must be a child but was: ${dir}`
 
@@ -22,15 +20,16 @@ const newFileName = linkNode =>
   `${linkNode.name}-${linkNode.internal.contentDigest}.${linkNode.extension}`
 
 const newPath = (linkNode, destinationDir) => {
+  const buildDirectory = process.env.GATSBY_BUILD_DIR || `public`
   if (destinationDir) {
     return path.posix.join(
       process.cwd(),
-      DEPLOY_DIR,
+      buildDirectory,
       destinationDir,
       newFileName(linkNode)
     )
   }
-  return path.posix.join(process.cwd(), DEPLOY_DIR, newFileName(linkNode))
+  return path.posix.join(process.cwd(), buildDirectory, newFileName(linkNode))
 }
 
 const newLinkURL = (linkNode, destinationDir, pathPrefix) => {