nx/docs/generated/devkit/NxJsonConfiguration.md

Interface: NxJsonConfiguration<T>

Nx.json configuration

Type parameters

Name	Type
T	"*" | string[]

Hierarchy

• NxJsonConfiguration

  ↳ Workspace

Table of contents

Properties

• affected: NxAffectedConfig
• cacheDirectory: string
• cli: Object
• defaultBase: string
• defaultProject: string
• extends: string
• generators: Object
• implicitDependencies: ImplicitDependencyEntry
• installation: NxInstallationConfiguration
• namedInputs: Object
• neverConnectToCloud: boolean
• nxCloudAccessToken: string
• nxCloudEncryptionKey: string
• nxCloudId: string
• nxCloudUrl: string
• parallel: number
• plugins: PluginConfiguration[]
• pluginsConfig: Record<string, Record<string, unknown>>
• release: NxReleaseConfiguration
• sync: NxSyncConfiguration
• targetDefaults: TargetDefaults
• tasksRunnerOptions: Object
• useDaemonProcess: boolean
• useInferencePlugins: boolean
• workspaceLayout: Object

Properties

affected

• Optional affected: NxAffectedConfig

Default options for nx affected

Deprecated

use defaultBase instead. For more information see https://nx.dev/deprecated/affected-config#affected-config

---

cacheDirectory

• Optional cacheDirectory: string

Changes the directory used by Nx to store its cache.

---

cli

• Optional cli: Object

Default generator collection. It is used when no collection is provided.

Type declaration

Name	Type
defaultProjectName?	string
packageManager?	PackageManager

---

defaultBase

• Optional defaultBase: string

Default value for --base used by nx affected and nx format.

---

defaultProject

• Optional defaultProject: string

Default project. When project isn't provided, the default project will be used. Convenient for small workspaces with one main application.

---

extends

• Optional extends: string

Optional (additional) Nx.json configuration file which becomes a base for this one

---

generators

• Optional generators: Object

List of default values used by generators.

These defaults are global. They are used when no other defaults are configured.

Example:

{
  "@nx/react": {
    "library": {
      "style": "scss"
    }
  }
}

Index signature

▪ [collectionName: string]: { [generatorName: string]: any; }

---

implicitDependencies

• Optional implicitDependencies: ImplicitDependencyEntry<T>

Map of files to projects that implicitly depend on them

Deprecated

use namedInputs instead. For more information see https://nx.dev/deprecated/global-implicit-dependencies#global-implicit-dependencies

---

installation

• Optional installation: NxInstallationConfiguration

Configures the Nx installation for a repo. Useful for maintaining a separate set of dependencies for Nx + Plugins compared to the base package.json, but also useful for workspaces that don't have a root package.json + node_modules.

---

namedInputs

• Optional namedInputs: Object

Named inputs targets can refer to reduce duplication

Index signature

▪ [inputName: string]: (string | InputDefinition)[]

---

neverConnectToCloud

• Optional neverConnectToCloud: boolean

Set this to false to disable connection to Nx Cloud

---

nxCloudAccessToken

• Optional nxCloudAccessToken: string

If specified Nx will use nx-cloud by default with the given token. To use a different runner that accepts an access token, define it in tasksRunnerOptions

---

nxCloudEncryptionKey

• Optional nxCloudEncryptionKey: string

Specifies the encryption key used to encrypt artifacts data before sending it to nx cloud.

---

nxCloudId

• Optional nxCloudId: string

If specified Nx will use nx-cloud by default with the given cloud id. To use a different runner that accepts a cloud id, define it in tasksRunnerOptions

---

nxCloudUrl

• Optional nxCloudUrl: string

Specifies the url pointing to an instance of nx cloud. Used for remote caching and displaying run links.

---

parallel

• Optional parallel: number

Specifies how many tasks can be run in parallel.

---

plugins

• Optional plugins: PluginConfiguration[]

Plugins for extending the project graph

---

pluginsConfig

• Optional pluginsConfig: Record<string, Record<string, unknown>>

Configuration for Nx Plugins

---

release

• Optional release: NxReleaseConfiguration

Configuration for nx release (versioning and publishing of applications and libraries)

---

sync

• Optional sync: NxSyncConfiguration

Configuration for the nx sync command.

---

targetDefaults

• Optional targetDefaults: TargetDefaults

Dependencies between different target names across all projects

---

tasksRunnerOptions

• Optional tasksRunnerOptions: Object

Available Task Runners

Index signature

▪ [tasksRunnerName: string]: { options?: any ; runner?: string }

---

useDaemonProcess

• Optional useDaemonProcess: boolean

Set this to false to disable the daemon.

---

useInferencePlugins

• Optional useInferencePlugins: boolean

Set this to false to disable adding inference plugins when generating new projects

---

workspaceLayout

• Optional workspaceLayout: Object

Where new apps + libs should be placed

Type declaration

Name	Type
appsDir?	string
libsDir?	string