A nuxt.js module that loads your .env file into your context options
The module loads variables from your .env file directly into your nuxt.js application context
and process.env
.
- Add
@nuxtjs/dotenv
dependency using yarn or npm to your project - Add
@nuxtjs/dotenv
tomodules
section ofnuxt.config.js
{
modules: [
// Simple usage
'@nuxtjs/dotenv',
// With options
['@nuxtjs/dotenv', { /* module options */ }],
]
}
After creating your .env file in the project root, simply run your usual npm run dev
. The variable inside the .env file will be added to the context (context.env
) and process (process.env
)
If you want to restrict what's accessible into the context, you can can pass to the module options an only
array with the keys you want to allow.
{
modules: [
['@nuxtjs/dotenv', { only: ['some_key'] }],
]
}
By default, the we'll be loading the .env
file from the root of your project. If you want to change the path of the folder where we can find the .env
file, then use the path
option.
{
modules: [
['@nuxtjs/dotenv', { path: '/path/to/my/global/env/' }],
]
}
Note that this is the path to the folder where the .env
file live, not to the .env
file itself.
The path can be absolute or relative.
We can override the filename when we need to use different config files for different environments.
{
modules: [
['@nuxtjs/dotenv', { filename: '.env.prod' }],
]
}
The dotenv-module
won't overload the environment variables of the process running your build.
If you need to use variables from your .env file at this moment, just append require('dotenv').config()
to your nuxt.config.js
:
require('dotenv').config()
module.exports = {
// your usual nuxt config.
}
This will works thanks to the dotenv
library provided by this module as a dependency. If you decided to ignore some values from your .env
file in the module configuration, this won't apply here.
Copyright (c) Julien Tant [email protected]