dotenv for environment configuration in Node.js - Step-by-Step Execution

Concept Flow - dotenv for environment configuration

Start Node.js app

↓

Load dotenv package

↓

Read .env file

↓

Parse key=value pairs

↓

Set process.env variables

↓

App uses process.env variables

↓

App runs with config values

The app starts, dotenv reads the .env file, sets environment variables, then the app uses those variables.

Execution Sample

Node.js

import dotenv from 'dotenv';
dotenv.config();
console.log(process.env.API_KEY);

Loads .env file and prints the API_KEY environment variable.

Execution Table

Step	Action	Input/State	Output/State Change
1	Start app	No env vars loaded	App begins execution
2	Import dotenv	dotenv module available	Ready to use dotenv
3	Call dotenv.config()	.env file present with API_KEY=12345	process.env.API_KEY set to '12345'
4	Access process.env.API_KEY	process.env.API_KEY='12345'	Console logs '12345'
5	App continues	Env vars set	App uses env vars as needed
6	End	No more code	Execution stops

💡 App finishes running after environment variables are loaded and used.

Variable Tracker

Variable	Start	After dotenv.config()	After console.log()
process.env.API_KEY	undefined	'12345'	'12345'

Key Moments - 3 Insights

Why is process.env.API_KEY undefined before calling dotenv.config()?

Because dotenv.config() reads the .env file and sets the variables. Before that, process.env does not have those keys (see execution_table step 3).

What happens if the .env file is missing?

dotenv.config() will not set any new variables, so process.env.API_KEY remains undefined (no change in variable_tracker).

Can we access environment variables directly without dotenv?

Yes, if the variables are set in the system environment. dotenv helps load them from a file during development (see concept_flow).

Visual Quiz - 3 Questions

Look at the execution_table, what is the value of process.env.API_KEY right after step 2?

A undefined

B '12345'

C null

D Error

💡 Hint

Check the 'Output/State Change' column at step 2 in execution_table.

At which step does dotenv set the environment variables from the .env file?

A Step 4

B Step 1

C Step 3

D Step 5

💡 Hint

Look for when dotenv.config() is called in execution_table.

If the .env file had API_KEY=abcde instead of 12345, what would console.log output at step 4?

A '12345'

B 'abcde'

C undefined

D Error

💡 Hint

Refer to variable_tracker and how dotenv.config() sets process.env.API_KEY.

Concept Snapshot

dotenv loads environment variables from a .env file into process.env.
Use import dotenv from 'dotenv'; then call dotenv.config() at app start.
Access variables via process.env.VAR_NAME.
If .env is missing, variables stay undefined.
Useful for config without hardcoding secrets.

Full Transcript

This visual trace shows how the dotenv package works in a Node.js app. First, the app starts with no environment variables loaded from .env. Then, dotenv is imported and its config() function is called. This reads the .env file, parses key=value pairs, and sets them on process.env. After this, accessing process.env.API_KEY returns the value from .env, such as '12345'. The app can then use these variables safely. If the .env file is missing, no variables are set. This method helps keep configuration separate from code.