AWS S3 Cache plugin for Nx

Usage no npm install needed!

<script type="module">
  import nxAwsPluginNxAwsCache from 'https://cdn.skypack.dev/@nx-aws-plugin/nx-aws-cache';



nx-aws is a set of plugins for NRWL NX (a set of Extensible Dev Tools for Monorepos).


A tool for using AWS S3 as a distributed computational cache for Nx.


Install the package by running:

yarn add @nx-aws-plugin/nx-aws-cache
npm i @nx-aws-plugin/nx-aws-cache

Then run the init schematic by running:

yarn nx generate @nx-aws-plugin/nx-aws-cache:init
npm run nx generate @nx-aws-plugin/nx-aws-cache:init

This will make the necessary changes to nx.json in your workspace to use nx-aws-cache runner.

AWS settings

There are two ways to set-up AWS options:

Using nx.json file (NOT recommended)

  "tasksRunnerOptions": {
  "default": {
    "runner": "@nx-aws-plugin/nx-aws-cache",
    "options": {
      "awsAccessKeyId": "[secret]",
      "awsSecretAccessKey": "[secret]",
      "awsRegion": "eu-central-1",
      "awsBucket": "bucket-name/cache-folder"

Using environment variables (recommended)


Additionally, AWS authentication can be set-up using default environment variables or using shared credentials, based on AWS documentation

Using environment variables


Using shared credentials file (~/.aws/credentials)

aws_access_key_id = [secret]
aws_secret_access_key = [secret]

Environment variables can be set using .env file - check dotenv documentation.


Run yarn nx build nx-aws-cache to build the plugin. The build artifacts will be stored in the dist/ directory. Use the --prod flag for a production build.

Running unit tests

Run yarn nx test nx-aws-cache to execute the unit tests via Jest.

Run yarn nx affected:test to execute the unit tests affected by a change.

Running end-to-end tests

Run yarn nx e2e nx-aws-cache to execute the end-to-end tests via Cypress.

Run yarn nx affected:e2e to execute the end-to-end tests affected by a change.


This repository is based on a similar NX plugin using Azure Storage @nx-azure/storage-cache which was inspired by Nx Cloud Plugin by Nrwl.