Interface: NxJsonConfiguration<T>
Nx.json configuration
Type parameters
| Name | Type |
|---|---|
T | "*" | string[] |
Hierarchy
NxJsonConfiguration
Table of contents
Properties
- $schema: string
- affected: NxAffectedConfig
- cacheDirectory: string
- cli: Object
- defaultBase: string
- defaultProject: string
- extends: string
- generators: Object
- implicitDependencies: ImplicitDependencyEntry<T>
- installation: NxInstallationConfiguration
- maxCacheSize: string
- 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
- tui: Object
- useDaemonProcess: boolean
- useInferencePlugins: boolean
- useLegacyCache: boolean
- workspaceLayout: Object
Properties
$schema
• Optional $schema: string
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:
1{
2 "@nx/react": {
3 "library": {
4 "style": "scss"
5 }
6 }
7}
8Index 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.
maxCacheSize
• Optional maxCacheSize: string
Sets the maximum size of the local cache. Accepts a number followed by a unit (e.g. 100MB). Accepted units are B, KB, MB, and GB.
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 true 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
Deprecated
Custom task runners will be replaced by a new API starting with Nx 21. More info: https://nx.dev/deprecated/custom-tasks-runner Available Task Runners for Nx to use
Index signature
▪ [tasksRunnerName: string]: { options?: any ; runner?: string }
tui
• Optional tui: Object
Settings for the Nx Terminal User Interface (TUI)
Type declaration
| Name | Type | Description |
|---|---|---|
autoExit? | number | boolean | Whether to exit the TUI automatically after all tasks finish. - If set to true, the TUI will exit immediately. - If set to false the TUI will not automatically exit. - If set to a number, an interruptible countdown popup will be shown for that many seconds before the TUI exits. |
enabled? | boolean | Whether to enable the TUI whenever possible (based on the current environment and terminal). |
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
useLegacyCache
• Optional useLegacyCache: boolean
Use the legacy file system cache instead of the db cache
workspaceLayout
• Optional workspaceLayout: Object
Where new apps + libs should be placed
Type declaration
| Name | Type |
|---|---|
appsDir? | string |
libsDir? | string |