@devmy/cypress-dotenv

@devmy/cypress-dotenv is a TypeScript library designed to integrate dotenv configuration with @dotenv-run/core into your Cypress setup, simplifying the management of environment variables for both component and end-to-end (E2E) tests.

• ✅ Load environment variables from .env files
• ✅ Load environment variables from .env.vault files
• ✅ Expand environment variables API_URL=$API_BASE/users
• ✅ Define environment variables for a specific environment (e.g. .env.production)
• ✅ Load priorities of .env.* files (e.g. .env.production > .env)
• ✅ Hierarchical cascading configuration in monorepo projects (Nx, Turbo, etc.) apps/next-app/.env > apps/.env > .env

Installation

Install the package via npm:

1npm install @devmy/cypress-dotenv

or via yarn:

1yarn add @devmy/cypress-dotenv

or via pnpm:

1pnpm add @devmy/cypress-dotenv

Usage

Dotenv Configuration

The dotenv configuration options in this library use DotenvRunOptions of dotenv-run/core.

defineConfigWithDotenv

The defineConfigWithDotenv function invokes Cypress's defineConfig, loading environment variables from dotenv.

Example:

1import { defineConfigWithDotenv } from '@devmy/cypress-dotenv';
2
3export default defineConfigWithDotenv({
4   dotenv: {
5    prefix: 'FRONTEND_E2E_',
6    root: '../../',
7  },
8  component: {
9    specPattern: 'src/**/*.cy.ts',
10  },
11  e2e: {
12    baseUrl: 'http://localhost:3000',
13  },
14});

dotenvComponentPreset

The dotenvComponentPreset function loads dotenv for component tests in Cypress.

Example:

1import { dotenvComponentPreset } from '@devmy/cypress-dotenv';
2
3export default dotenvComponentPreset({
4  dotenv: {
5    prefix: 'FRONTEND_E2E_',
6    root: '../../',
7  },
8  devServer: {
9    framework: 'react',
10    bundler: 'webpack',
11  },
12});

dotenvE2EPreset

The dotenvE2EPreset function loads dotenv for E2E tests in Cypress.

Example:

1import { dotenvE2EPreset } from '@devmy/cypress-dotenv';
2
3export default dotenvE2EPreset({
4  dotenv: {
5    prefix: 'FRONTEND_E2E_',
6    root: '../../',
7  },
8  baseUrl: 'http://localhost:3000',
9});

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any changes.