# azure-env-app-configuration

> **azure-env-app-configuration** is a utility library to the *Azure Application Configuration* service, and the *@azure/app-configuration* package, that allows you to easy import configurations into your node environment variables (`process.env`).

Latest version **1.4.0** (published 2021-04-15) · MIT license · 0 weekly downloads

## Install

```sh
npm install azure-env-app-configuration
pnpm add azure-env-app-configuration
yarn add azure-env-app-configuration
bun add azure-env-app-configuration
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.4.0 |
| Published | 2021-04-15 |
| First published | 2020-08-26 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 4 |
| Unpacked size | 13 KB |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| Author | Wictor Wilén |
| Maintainers | wictorwilen |

## Links

- npm: https://www.npmjs.com/package/azure-env-app-configuration
- Funding: https://github.com/sponsors/wictorwilen
- npm.io page: https://npm.io/package/azure-env-app-configuration

## Dependencies (4)

- [vscode-uri](https://npm.io/package/vscode-uri.md) ^3.0.2
- [@azure/identity](https://npm.io/package/@azure/identity.md) ^1.3.0
- [@azure/keyvault-secrets](https://npm.io/package/@azure/keyvault-secrets.md) ^4.1.0
- [@azure/app-configuration](https://npm.io/package/@azure/app-configuration.md) ^1.1.1

## Recent versions

- 1.4.0 (latest) — 2021-04-15
- 1.4.0-preview2 (preview) — 2021-03-25
- 1.4.0-preview — 2021-03-25
- 1.3.0 — 2021-01-11
- 1.2.0 — 2020-09-24
- 1.0.0 — 2020-08-26

## README

# Nodes environment variables with Azure Application Configuration

**azure-env-app-configuration** is a utility library to the *Azure Application Configuration* service, and the *@azure/app-configuration* package, that allows you to easy import configurations into your node environment variables (`process.env`).

## Options

| Option | Description |
|--------|-------------|
|`appConfigConnectionString`*| Connection string to App Config |
|`appConfigOptions` | Options for App Config |
|`endpoint`* | Endpoint for App Config |
|`tokenCredential`*| Credentials to use with `endpoint`|
|`includeKeyVaultSecrets`| Also read connected Key Vault secrets|
|`ignore` | An array of configuration names to ignore |
|`ignoreIfDefined`| An array of configuration names to ignore, if already set|

*) Either use `appConfigConnectionString` or `endpoint`/`tokenCredential`

## Example

Simple configuration that imports all available configurations into `process.env`:

``` TypeScript
import { envAppConfiguration } from "azure-env-app-configuration";
await envAppConfiguration({
    appConfigConnectionString: "..." // Azure Application Configuration connection string
});
```

Just import configurations with the label `env`:

``` TypeScript
import { envAppConfiguration } from "azure-env-app-configuration";
await envAppConfiguration({
    appConfigConnectionString: "...",
    labelFilter: "env"
});
```

Used together with packages such as `dotenv`, where in this case the Azure Application Configuration settings will overwrite any definitions in the local `.env` file:

``` TypeScript
import { envAppConfiguration } from "azure-env-app-configuration";

require("dotenv").config();

await envAppConfiguration({
    appConfigConnectionString: "...",
    labelFilter: "env"
});
```

## Installation

Install it to your solution by using:

``` bash
npm install azure-env-app-configuration --save
```

## About

**azure-env-app-configuration** is created and maintained by [Wictor Wilen](https://www.wictorwilen.se)

## License

MIT

---
_Source: https://npm.io/package/azure-env-app-configuration · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._