admin-env-vars-import-meta - ESLint plugin rules

This rule requires admin code to use import.meta.env instead of process.env for environment variables, since admin code is bundled for the browser by Vite.

Severity#

warn. This rule is enabled in the recommended preset.

What it Targets#

This rule targets files in your project's src/admin directory. It reports access to process.env.

The following code is reported by the rule:

src/admin/widgets/product-widget.tsx
const url = process.env.VITE_BACKEND_URL

Instead, use import.meta.env:

src/admin/widgets/product-widget.tsx
const url = import.meta.env.VITE_BACKEND_URL

Why it's Important#

Admin code runs in the browser via Vite, where process.env is undefined. Using import.meta.env ensures your environment variables resolve correctly at runtime.

Learn more in the Environment Variables in Admin Development documentation.

Fixable#

This rule is auto-fixable. Run the linter with the --fix option to apply the fix automatically.

Turn it Off#

To turn off this rule, set it to off in your ESLint configuration:

eslint.config.ts
1import { defineConfig } from "eslint/config"2import medusa from "@medusajs/eslint-plugin"3
4export default defineConfig([5  ...medusa.configs.recommended,6  {7    rules: {8      "@medusajs/admin-env-vars-import-meta": "off",9    },10  },11])

Or disable it for a single line using an inline comment:

Code
1// eslint-disable-next-line @medusajs/admin-env-vars-import-meta2console.log(process.env.MEDUSA_BACKEND_URL)