How to use Environment Variables in Vite(React Template Example)

tl:dr — Use import.meta.env instead of process.env

Vite is a handy build tool when you want to spin up a quick react application. In this guide, I will walk you through how to use environment variables inside a react application template created though vite.

Prerequisites:

This guide assumes that you know some basics of scaffolding a vite application template and also the workings of environment variables . A brief disclaimer, environment variables only store secrets during the development phase of your project. Secret or sensitive keys will be visible after a production build so be careful not to expose sensitive keys at build time.

The Problem:

Sometime back when doing a live code presentation, I wanted to use some keys from a database that was to initialize a connection to the database. The best approach would be to write all the keys inside a .env file and create a connection that makes a reference to the values inside this file. Normally when creating and using environment variables, you write the JavaScript statement process.env.SOME_VALUE or process.env.REACT_APP_SOME_VALUE but in this instance, the react application stopped rendering information on the screen. The console error read "process is not defined". Even after installing the npm package dotenv, the error still persisted.

The Solution:

The solution is actually inside the official vite documentation. Instead of using process.env.SOME_VALUE or process.env.REACT_APP_SOME_VALUE which is common with other projects, inside vite we use import.meta.env.SOME_VALUE. When you want to expose some info inside the frontend you will have to append the statement with VITE i.e. import.meta.env.VITE_SOME_VALUE.

With the import.meta.env.VITE_SOME_VALUE statement, we can now use environment variables inside a react application initialized inside of vite. Thank you for reading this brief writeup and hope this comes in handy when working with react inside vite.

Happy Coding!