next.js/examples/with-universal-configuration/README.md

With universal configuration

How to use

Using create-next-app

Execute create-next-app with Yarn or npx to bootstrap the example:

npx create-next-app --example with-universal-configuration with-universal-configuration-app
# or
yarn create next-app --example with-universal-configuration with-universal-configuration-app

Download manually

Download the example:

curl https://codeload.github.com/zeit/next.js/tar.gz/canary | tar -xz --strip=2 next.js-canary/examples/with-universal-configuration
cd with-universal-configuration

Install it and run:

npm install
npm run dev
# or
yarn
yarn dev

Deploy it to the cloud with now (download)

now

The idea behind the example

This example show how to set custom environment variables for your application based on NODE_ENV using transform-define.

Caveats

• Because a babel plugin is used the output is cached in node_modules/.cache by babel-loader. When modifying the configuration you will have to manually clear this cache to make changes visible. Alternately, you may skip caching for babel-loader as shown here.
• This example sets the environment configuration at build time, meaning the same build might not be used in e.g. both staging and production. For a solution which sets the environment at runtime, see here.