Command reference

Command overview

Command	Alias	Description
analyze		Analyze the bundle size of the app.
build		Build the app.
create	c	Create a new app in the selected directory.
default		Output basic information about the App Toolkit.
deploy		Build the app and then deploy it to the specified environment.
dev		Build the app and start a local development server.
generate action	g a	Generate a custom workflow action.
generate function	g f	Generate an app function.
info		Output detailed information about the App Toolkit and the environment.
uninstall		Uninstall the app from the specified environment.
update		Update @dynatrace-scoped packages and the App Toolkit to the latest version and apply automatic migrations.
version		Print the version of the App Toolkit.
help		Display a set of dt-app commands with a description.

dt-app analyze

Analyze the bundle size of the app.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%"

dt-app build

Build the app.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--no-prod	Build in development mode.
--no-sdk-injection	Disable the automatic injection of the Dynatrace SDK.
--no-type-check	Skip type checking.
--prod	Build in production mode. Per default the build always gets executed in production mode.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%"

dt-app create

Create a new app in the selected directory.

Arguments

Argument	Description
[name]	The name of the app.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--dry-run	Do not write any changes to the file system.
--environment-url <name>	Specify your environment.
--no-embedded-templates	Specify whether the templates embedded with the CLI or the ones downloaded from an external source should be used.
--no-git	Do not initialize a git repository.
--oauth-client-id <id>	Specify the single sign-on client ID.
--package-manager [name]	Specify your package manager.
--skip-install	Do not install dependencies after initialization.
--skip-repository-check	Skip the safety check whether the project is generated inside an existing repository for headless execution.
--template [name]	Choose the template to generate the app from.
--template-dir <dir>	Specify the directory that contains the template your app should be created from.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%"

dt-app default

Output basic information about the App Toolkit.

Options

Option	Description
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%"
-v, --version	Print the version of the App Toolkit.

dt-app deploy

Build the app and then deploy it to the specified environment.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--dry-run	Do not actually deploy the app only perform a dry run.
--environment-url [url]	The environment that should be used.
--force-overwrite	Overwrite an existing app with the same id if it has been deployed by another user.
--no-type-check	Skip type checking.
--sign-archive	Sign the archive using the private key and certificates defined via environment variables DT_APP_SIGNING_PK and DT_APP_SIGNING_CERT or via --sign-archive-pk and --sign-archive-cert.
--sign-archive-cert [path]	Path to a file containing the certificate chain used for signing the app.
--sign-archive-pk [path]	Path to a file containing the private key used for signing the app.
--skip-build	Skip the build before deploying.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%".

dt-app dev

Build the app and start a local development server.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--environment-url [url]	The environment that should be used.
--host [name]	The host IP to bind the dev server on.
--legacy-runtime-simulator	Use the deprecated runtime-simulator in case you run into problems with the new setup.
--no-live-reload	Disable live reload on detected file changes.
--no-open	Do not open the browser with the dev server.
--no-sdk-injection	Disable automatic injection of the Dynatrace SDK.
--no-type-check	Skip type checking.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%"
-o, --open	Open the browser with the dev server.
-p, --port <number>	The port where the files should be served.
-w, --show-warnings	Display build warnings.

dt-app generate action

Generate a custom workflow action.

Arguments

Argument	Description
[name]	The name of the action.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--dry-run	Do not write any changes to the file system.
--skip-tests	Do not generate test files.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%"

dt-app generate function

Generate an app function.

Arguments

Argument	Description
[name]	The name of the function.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--dry-run	Do not write any changes to the file system.
--generate-tests	Generate test files for functions without tests.
--skip-tests	Do not generate test files.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%"

dt-app info

Output detailed information about the App Toolkit and the environment.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%"

dt-app uninstall

Uninstall the app from the specified environment.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--dry-run	Do not actually remove the app only perform a dry run.
--environment-url [url]	The environment that should be used.
--global	Remove the app in the global context.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%"

dt-app update

Update @dynatrace-scoped packages and the App Toolkit to the latest version and apply automatic migrations.

Arguments

Argument	Description
[packages...]	The packages that should be updated.

Options

Option	Description
--cwd [dir]	The current working directory where it should run.
--dry-run	Do not write any changes to the file system.
--skip-install	Do not install dependencies after migrations.
--verbose [context]	Output additional debug logs. Add optional context to filter. % at the end as wildcard possible. Example: "--verbose cli-%"
--yes	Update all outdated packages without prompt for confirmation.
-i, --interactive	Choose the packages you want to update manually.

dt-app version

Print the version of the App Toolkit.

dt-app help

Display a set of dt-app commands with a description.