# @remy/envy

> The create-react-app environment loader, enhanced and separated for consistent reuse in other projects.

Latest version **4.0.2** (published 2018-08-11) · MIT license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install @remy/envy
pnpm add @remy/envy
yarn add @remy/envy
bun add @remy/envy
```

Provides the command `envy`.

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 4.0.2 |
| Published | 2018-08-11 |
| First published | 2017-11-15 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 8.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 11 |
| Author | Remy Sharp |
| Maintainers | remy |
| Keywords | env, environment, dotenv, .env, config |

## Links

- npm: https://www.npmjs.com/package/@remy/envy
- Repository: https://github.com/remy/envy
- Homepage: https://github.com/remy/envy#readme
- Issues: https://github.com/remy/envy/issues
- npm.io page: https://npm.io/package/@remy/envy

## Dependencies (2)

- [dotenv](https://npm.io/package/dotenv.md) ^4.0.0
- [dotenv-expand](https://npm.io/package/dotenv-expand.md) ^4.2.0

## Alternatives

- [replicas-cli](https://npm.io/package/replicas-cli.md) — 3.0K weekly downloads
- [env-contract](https://npm.io/package/env-contract.md) — 133 weekly downloads
- [@openveo/api](https://npm.io/package/@openveo/api.md) — 61 weekly downloads
- [@ryniaubenpm2/cumque-error-reiciendis](https://npm.io/package/@ryniaubenpm2/cumque-error-reiciendis.md) — 54 weekly downloads
- [ts-global-type-extra](https://npm.io/package/ts-global-type-extra.md) — 11 weekly downloads

## Recent versions

- 4.0.2 (latest) — 2018-08-11
- 4.0.1 — 2018-08-03
- 4.0.0 — 2018-08-03
- 3.1.1 — 2018-02-02
- 3.1.0 — 2018-02-02
- 3.0.0 — 2018-01-16
- 2.1.2 — 2018-01-16
- 2.1.1 — 2018-01-16
- 2.1.0 — 2018-01-16
- 2.0.0 — 2017-12-09
- 1.0.1 — 2017-11-15
- 1.0.0 — 2017-11-15

## README

# envy

The [create-react-app](https://github.com/facebookincubator/create-react-app) environment loader for consistent reuse in other projects with additions for command line usage.

**Important:** envy will default to `NODE_ENV=development` if there is no value on `NODE_ENV`.

## Installation

```shell
npm install --save @remy/envy
```

## Typical usage

```js
// populates process.env
require('@remy/envy'); // do this as early as possible in the code

// Also populate and return
const { raw, stringified } = require('@remy/envy');
```

<details><summary>What `.env` files can be used?</summary>

* `.env`: Default.
* `.env.local`: Local overrides. **This file is loaded for all environments except test.**
* `.env.development`, `.env.test`, `.env.production`: Environment-specific settings.
* `.env.development.local`, `.env.test.local`, `.env.production.local`: Local overrides of environment-specific settings.

Files on the left have more priority than files on the right:

* `npm start`: `.env.development.local`, `.env.development`, `.env.local`, `.env`
* `npm run build`: `.env.production.local`, `.env.production`, `.env.local`, `.env`
* `npm test`: `.env.test.local`, `.env.test`, `.env` (note `.env.local` is missing)

These variables will act as the defaults if the machine does not explicitly set them.

Please refer to the [dotenv documentation](https://github.com/motdotla/dotenv) for more details.

>Note: If you are defining environment variables for development, your CI and/or hosting platform will most likely need
these defined as well. Consult their documentation how to do this. For example, see the documentation for [Travis CI](https://docs.travis-ci.com/user/environment-variables/) or [Heroku](https://devcenter.heroku.com/articles/config-vars).

</details>

## Features

- Expands `$VAR` by default (via [dotenv-expand](https://github.com/motdotla/dotenv-expand)). **Important** escaped `\$` does not work, and is expanded to `undefined`. To disable env expansion, set environment value `NO_EXPAND=true`.
- Supports `.env.example` if the file is found in the current working directory (very similar to [dotenv-safe](https://github.com/rolodato/dotenv-safe/blob/master/index.js) - but merges environment values first, then checks)


## CLI usage

Beyond using the package as a dependency, a CLI utility is provided for testing environment values and _also_ injecting the environment variables into a command.

Assuming the package was installed locally to your project, and using [npx](https://www.npmjs.com/package/npx) to run a `.bin` command:

```shell
$ NODE_ENV=test npx envy
> # prints entire environment loaded

$ NODE_ENV=test npx envy NODE_ENV
> test

$ NODE_ENV=test npx envy -- node -e "console.log(process.env.NODE_ENV)"
> test
```

### `--` Double dash to signify the end of the options

When passing `--` to `envy` everything afterwards will be executed with the modified environment (a bit like the `foreman` command line too).

---
_Source: https://npm.io/package/@remy/envy · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
