netlify-plugin-replace

KO | EN

gitlite — search

#hacktoberfest #react #ai #go #golang #android #rust #deep-learning #docker #macos #java #awesome #vue #openai

netlify-plugin-replace

(★ 10)

Netlify build plugin that replaces ENV variables in your publish directory

netlify-plugin-replace Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# netlify-plugin-replace

[![build status](https://api.travis-ci.com/ample/netlify-plugin-replace.svg)](https://travis-ci.com/github/ample/netlify-plugin-replace) [![npm version](https://badge.fury.io/js/%40helloample%2Fnetlify-plugin-replace.svg)](https://www.npmjs.com/package/@helloample/netlify-plugin-replace)

Replace environment variables in your publish directory _before_ Netlify processes your build. Check out an example implementation [here](https://github.com/ample/netlify-plugin-replace-demo).

## Why?

Netlify will deploy whatever you stick in your publish directory. This is great for simple use-cases but for projects that span multiple environments or rely heavily on environment variables, it can be tricky manage those differences without resorting to gnarly sed scripts or other unmentionable approaches.

This build plugin solves that problem by replacing references to environment variables _after_ your project is built. A great example of this plugin's power is dynamically updating your `_redirects` file based on its deployment context.

## Install

Add the plugin to your project's `package.json` file...

```
$ npm i @helloample/netlify-plugin-replace -D
```

Add the plugin to your project's `netlify.toml` file (see [configuration](https://github.com/ample/netlify-plugin-replace#configuration) for available options)...

```
[[plugins]]
  package = "@helloample/netlify-plugin-replace"
```

Commit & push changes back to your repository.

## Usage

By default, this plugin will look for strings that match the following pattern...

```
${env:SOME_VALUE}
```

...and will attempt to replace that string with the value of the ENV variable by the same name. If the variable doesn't exist, it will not be replaced.

Following this example, any file in your build's output directory containing the string `${env:SOME_VALUE}` will have that string replaced with the contents of `process.env.SOME_VALUE` when this plugin runs.

## Configuration

This plugin offers some limited customization options as described below. Simply add these key/values to `netlify.toml` to customize the behavior for your needs.

- `delimiter`: Regex pattern that tells the plugin how to find values to replace. Note, this pattern should contain a single capture group which encapsulates the entire name of the variable
- `fileTypes`: Regex pattern defining the extension of the files to operate upon

The default configuration, if none is specified, is:

```
[[plugins]]
  package = "@helloample/netlify-plugin-replace"
  [plugins.inputs]
    delimiter = "\${env:([^}]_)}"
    fileTypes = ".*$"
```

## License

This project is licensed under the [MIT License](https://github.com/ample/netlify-plugin-replace/blob/main/LICENSE).

netlify-plugin-replace

netlify-plugin-replace Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

netlify-plugin-replace

netlify-plugin-replace Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README