Edit in GitHubLog an issue

Create environment file

Whether its a new storefront project or a fresh PWA Studio repository clone, PWA Studio requires a .env file to set up the environment for your site. The create-env-file subcommand for the buildpack CLI command automatically creates this file using pre-defined environment variables and default values.


Usage example with npx:

Copied to your clipboard
npx @magento/pwa-buildpack create-env-file <dir>

This command generates a .env file in the specified directory.

The .env file follows the dotenv file format and includes documentation comments for the environment variable declarations. The create-env-file command uses the envVarDefinitions.json file in the PWA Studio source code to create this file.

Command flags#

--use-examplesUse example values for all variables in the generated .env file.

Defining variables for the .env file#

Use any of the following methods to define the generated variables in the .env file:

  • Set one or more variables defined in the envVarDefinitions.json file before running create-env-file to override the default values written to the .env file. These values can be set using shell scripting or other OS-specific methods.
  • Call create-env-file with the --use-examples flag to use the example values for variables declared in the envVarDefinitions.json file. Calling the create-env-file command without this flag still writes the example values to the .env file, but the entry is commented out.

Variables with no environment definitions nor example values in the envVarDefinitions.json file are declared in the .env file with an empty value.


Copied to your clipboard

Programmatic API#

Adding the @magento/pwa-buildpack dependency to your project gives you access to the programmatic API for creating the .env file.

createDotEnvFile(directory, options)#

Uses the current environment variables and envVarDefinitions.json file to generate the contents of a .env file.


Copied to your clipboard
1const { createDotEnvFile } = require("@magento/pwa-buildpack");
3const fileContents = createDotEnvFile(process.cwd());


ParameterData typeDescription
dirOrEnvstring path or a process.env-like objectProvides the path to the project root.
optionsobjectAn object containing additional options.
options.loggerobjectThe object to use for logging.
options.useExamplesbooleanWhether to populate the .env file with example values.

If dirOrEnv is a string and the specified directory contains a .env file, it is read before being overwritten to preserve existing variables.

If dirOrEnv is a process.env-like object, the .env file is not parsed before being overwritten.

Return value#

The return value is the string value of a .env file.

Parse this value using the dotenv API or write it out to the filesystem.

  • Privacy
  • Terms of Use
  • Do not sell my personal information
  • AdChoices
Copyright © 2022 Adobe. All rights reserved.