Enterprise Grade Testing with Verdaccio and Nx

🚀 Enterprise Grade Testing with Verdaccio and Nx ⚡

Welcome to the Verdaccio Testing Environments Nx Plugin — your one-stop solution for running blazingly fast, isolated, and scalable end-to-end (e2e) tests with zero configuration. Yeah, you heard that right: ZERO configuration.

With this plugin, say goodbye to the old days of waiting around for your tests and hello to next-level speed. Plug it in, and you're good to go.

Why You NEED This Plugin 🔥

Key Features:

• ⚙️ ZERO Config — You won’t need any global setup or teardown scripts.
• 🔥 BRUTALLY FAST — Up to ⚡110x faster⚡ than traditional setups. Yes, you read that right.
• 🛡️ Isolated — No more conflicts with local file systems. Everything’s clean.
• 🚀 Scalable — Run your tests in parallel, no matter how big your project.
• 🕒 Optimized — We cache everything we can, so your tests run faster over time.
• ⚡ Developer Experience — Streamlined and simplified. You focus on the code, we handle the setup.
• 🧪 Easier Debugging — Debugging e2e tests is now a piece of cake 🍰.

🏎️ Speed Benchmarks 🕒️

🧪 Test Architecture Comparison 📐

Default Test Architecture	Decoupled Test Architecture

🔗 Tasks Architecture Comparison 📐

Default Task Architecture	Decoupled Task Architecture

🔗 Testing Dx Comparison 🤓

Default Testing Dx	Cacheable Testing Dx

🔗 Debug Dx Comparison 🐞

Default Debug Dx	Excellent Debug Dx

Getting Started 🏁

Step 1: Register and Configure in nx.json:

{
  "plugins": [
    {
      "plugin": "@push-based/nx-verdaccio",
      "options": {
        "environments": {
          "environmentsDir": "tmp/environments", // Optional
          "targetNames": ["e2e"] // Optional
        }
      }
    }
  ]
}

[!NOTE] Your configured targets now has a new dependency configured:

{
  "name": "utils-e2e",
  "targets": {
    "e2e": {
      "dependsOn": [
        // dynamically aded
        { "target": "env-setup", "params": "forward" }
      ]
      // ...
    }
  }
  // ...
}

Optional: Add the Package Under Test as implicitDependency (OPTIONAL)

Let the plugin detect your implicit dependencies:

// projects/utils-e2e/project.json
{
  "name": "utils-e2e",
  "implicitDependency": ["utils"]
}

Step 3: Run the E2E Test

nx run utils-e2e:e2e

Tadaaaa! 🎉 You’re now testing at light speed!

Configuration Options 🛠️

Fine-Grained Control for Publishable Projects 🚀

Out of the box, all library-type projects get these targets:

• nx-verdaccio--pkg-publish
• nx-verdaccio--pkg-install

But if you want to narrow it down:

{
  "plugins": [
    {
      "plugin": "@push-based/nx-verdaccio",
      "options": {
        "packages": {
          "filterByTags": ["publishable"]
        }
      }
    }
  ]
}

Tag your projects accordingly:

// projects/utils/project.json
{
  "name": "utils",
  //
  "tags": ["publishable"]
  // ...
}

Custom Test Environment Setup 🧪

Filter by target names

Want more control over which projects get their environments set up?

{
  "plugins": [
    {
      "plugin": "@push-based/nx-verdaccio",
      "options": {
        "environments": {
          "targetNames": ["e2e", "e2e-static"]
        }
      }
    }
  ]
}

Filter by tags

Filter projects by tags to apply environment setup:

{
  "plugins": [
    {
      "plugin": "@push-based/nx-verdaccio",
      "options": {
        "environments": {
          "filterByTags": ["npm-env"]
        }
      }
    }
  ]
}

Tag those projects accordingly:

// projects/utils/project.json
{
  "name": "lib-e2e",
  //
  "tags": ["npm-env"]
  // ...
}

Example Usage:

• Run the E2E test forutils-e2e:
  nx run utils-e2e:e2e
• Run E2E with specific environments:
  nx run utils-static-e2e:e2e --environmentRoot static-environments/user-lists

Benchmarks

This is a first draft of how the benchmarks will look. ATM the data set it not big proper.

[!warn] The data is a first draft of the structure and does not reflect a clean data set. Work on the real benchmark data in progress

Next Steps

• configure cacheable environments
• static environments
• debugging

Stay Connected! 🔗

• Check out our services
• Follow us on Twitter