Socket
Socket
Sign inDemoInstall

docusaurus2-dotenv

Package Overview
Dependencies
1
Maintainers
1
Versions
5
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

docusaurus2-dotenv


Version published
Maintainers
1
Created

Readme

Source

A Docusaurus2 plugin that supports dotenv and other environment variables and only exposes what you choose and use

Installation

Install the package in your repository

npm install docusaurus2-dotenv

or

yarn add docusaurus2-dotenv

Description

The docusaurus2-dotenv plugin wraps the dotenv-webpack library to allow the usage of .env files in Docusaurus2 projects. This allows you to access your environment variables via process.env.VARIABLE_NAME in your code.

Usage

The plugin can be used "out of the box" using the standard configuration. In your docusaurus.config.js file, add the following to your plugins block.

docusaurus.config.js

module.exports = {
    ..., // other Docusaurus2 settings
    plugins: [
        'docusaurus2-dotenv'
    ],
    ... // other Docusaurus2 settings
}

Properties

Use the following properties to configure your instance.

  • path ('./.env') - The path to your environment variables.
  • safe (false) - If true, load '.env.example' to verify the '.env' variables are all set. Can also be a string to a different file.
  • systemvars (false) - Set to true if you would rather load all system variables as well (useful for CI purposes).
  • silent (false) - If true, all warnings will be suppressed.
  • expand (false) - Allows your variables to be "expanded" for reusability within your .env file.
  • defaults (false) - Adds support for dotenv-defaults. If set to true, uses ./.env.defaults. If a string, uses that location for a defaults file.
docusaurus.config.js

module.exports = {
    ..., // other Docusaurus2 settings
    plugins: [
        [
            'docusaurus2-dotenv',
            {
                path: "./.env", // The path to your environment variables.
                safe: false, // If false ignore safe-mode, if true load './.env.example', if a string load that file as the sample
                systemvars: false, // Set to true if you would rather load all system variables as well (useful for CI purposes)
                silent: false, //  If true, all warnings will be suppressed
                expand: false, // Allows your variables to be "expanded" for reusability within your .env file
                defaults: false, //  Adds support for dotenv-defaults. If set to true, uses ./.env.defaults
            }
        ]
    ],
    ... // other Docusaurus2 settings
}

Add .env to your .gitignore file

Keywords

FAQs

Last updated on 08 May 2020

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc