npmpackage.info

Gathering detailed insights and metrics for @startupjs/babel-plugin-dotenv-import

Other packages similar to @startupjs/babel-plugin-dotenv-import

@startupjs/babel-plugin-dotenv

0.55.8

Import .env files

Gathering detailed insights and metrics for @startupjs/babel-plugin-dotenv-import

@startupjs/babel-plugin-dotenv-import - 1002.0.0 | npmpackage.info

@startupjs/babel-plugin-dotenv-import

Load environment variables using import statements.

1002.0.0

MIT

JavaScript

16.11 kB

2.8

Installations

npm install @startupjs/babel-plugin-dotenv-import

Developer Guide

BETA

Typescript

No

Module System

CommonJS

Node Version

10.16.0

NPM Version

6.9.0 Pull Requests

Open

7

Total

369

Closed

125

Merged

237

Issues

Open

1

Total

10

Closed

9

Releases

v3.0.1

Updated on Oct 09, 2022

v3.0.0

Updated on Oct 09, 2022

v2.2.0

Updated on Feb 15, 2021

v2.1.0

Updated on May 28, 2020

v2.0.0

Updated on Aug 31, 2018

v1.4.0

Updated on Jun 28, 2018

View All 15 releases

Languages

JavaScript

Shell

JavaScript (96.13%)

Shell (3.87%)

Developer

tusbar

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

MIT License

78 Stars

507 Commits

8 Forks

1 Watchers

7 Branches

6 Contributors

Updated on Apr 24, 2025

Maintainers

View All 6 Contributors

Package Meta Information

Latest Version

1002.0.0

Package Id

@startupjs/babel-plugin-dotenv-import@1002.0.0

Unpacked Size

16.11 kB

Size

5.97 kB

File Count

NPM Version

6.9.0

Node Version

10.16.0

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

dotenv

Dev Dependencies

@babel/core codecov jest jest-junit xo

babel-plugin-dotenv-import

Load environment variables using import statements.

Installation

1$ npm install babel-plugin-dotenv-import

Usage

.babelrc

1{
2  "plugins": [
3    ["dotenv-import", {
4      "moduleName": "@env",
5      "path": ".env",
6      "blacklist": null,
7      "whitelist": null,
8      "safe": false,
9      "allowUndefined": false
10    }]
11  ]
12}

.env

1API_URL=https://api.example.org
2API_TOKEN=

In users.js

1import {API_URL, API_TOKEN} from "@env"
2
3fetch(`${API_URL}/users`, {
4  headers: {
5    'Authorization': `Bearer ${API_TOKEN}`
6  }
7})

White and black lists

It is possible to limit the scope of env variables that will be imported by specifying a whitelist and/or a blacklist as an array of strings.

1{
2  "plugins": [
3    ["dotenv-import", {
4      "blacklist": [
5        "GITHUB_TOKEN"
6      ]
7    }]
8  ]
9}

1{
2  "plugins": [
3    ["dotenv-import", {
4      "whitelist": [
5        "API_URL",
6        "API_TOKEN"
7      ]
8    }]
9  ]
10}

Safe mode

Enable safe mode to only allow environment variables defined in the .env file. This will completely ignore everything that is already defined in the environment.

The .env file has to exist.

1{
2  "plugins": [
3    ["dotenv-import", {
4      "safe": true
5    }]
6  ]
7}

Allow undefined

Allow importing undefined variables, their value will be undefined.

1{
2  "plugins": [
3    ["dotenv-import", {
4      "allowUndefined": true
5    }]
6  ]
7}

1import {UNDEFINED_VAR} from '@env'
2
3console.log(UNDEFINED_VAR === undefined) // true

When false (default behavior), an error will be thrown.

Caveats

When using with babel-loader with caching enabled you will run into issues where environment changes won’t be picked up. This is due to the fact that babel-loader computes a cacheIdentifier that does not take your environment into account.

You can easily clear the cache:

1rm -rf node_modules/.cache/babel-loader/*

Or you can override the default cacheIdentifier to include some of your environment variables.

Credits

Based on David Chang’s works on babel-plugin-dotenv.

Miscellaneous

    ╚⊙ ⊙╝
  ╚═(███)═╝
 ╚═(███)═╝
╚═(███)═╝
 ╚═(███)═╝
  ╚═(███)═╝
   ╚═(███)═╝

No vulnerabilities found.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

License

Determines if the project has defined a license.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

2.8

/10

Last Scanned on 2025-07-07

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More