Classes
| Name | Description |
|---|---|
| CdkPipelineAspect | No description |
| PrivateTaimosCdkApp | Private AWS CDK app in TypeScript. |
| SopsAspect | No description |
| TaimosCdkApp | AWS CDK app in TypeScript. |
| TaimosCdkConstructLibrary | TypeScript library. |
| TaimosPrivateTypescriptLibrary | Private TypeScript library. |
| TaimosTypescriptLibrary | TypeScript library. |
Structs
| Name | Description |
|---|---|
| PrivateTaimosCdkAppOptions | No description |
| SopsAspectOptions | No description |
| TaimosCdkAppOptions | No description |
| TaimosCdkConstructLibraryOptions | No description |
| TaimosPrivateTypescriptLibraryOptions | No description |
| TaimosTypescriptLibraryOptions | No description |
Extends: Component
new CdkPipelineAspect(app: TaimosCdkApp)- app (
TaimosCdkApp) No description
Private AWS CDK app in TypeScript.
Extends: TaimosCdkApp
new PrivateTaimosCdkApp(options: PrivateTaimosCdkAppOptions)- options (
PrivateTaimosCdkAppOptions) No description- name (
string) This is the name of your project. - logging (
LoggerOptions) Configure logging options such as verbosity. Default: {} - outdir (
string) The root directory of the project. Default: "." - parent (
Project) The parent project, if this project is part of a bigger project. Optional - projenCommand (
string) The shell command to use in order to run the projen CLI. Default: "npx projen" - projenrcJson (
boolean) Generate (once) .projenrc.json (in JSON). Set tofalsein order to disable .projenrc.json generation. Default: false - projenrcJsonOptions (
ProjenrcOptions) Options for .projenrc.json. Default: default options - autoApproveOptions (
github.AutoApproveOptions) Enable and configure the 'auto approve' workflow. Default: auto approve is disabled - autoMerge (
boolean) Enable automatic merging on GitHub. Default: true - autoMergeOptions (
github.AutoMergeOptions) Configure options for automatic merging on GitHub. Default: see defaults inAutoMergeOptions - clobber (
boolean) Add aclobbertask which resets the repo to origin. Default: true - devContainer (
boolean) Add a VSCode development environment (used for GitHub Codespaces). Default: false - github (
boolean) Enable GitHub integration. Default: true - githubOptions (
github.GitHubOptions) Options for GitHub integration. Default: see GitHubOptions - gitpod (
boolean) Add a Gitpod development environment. Default: false - mergify (
boolean) Whether mergify should be enabled on this repository or not. Default: true - mergifyOptions (
github.MergifyOptions) Options for mergify. Default: default options - projectType (
ProjectType) Which type of project this is (library/app). Default: ProjectType.UNKNOWN - projenCredentials (
github.GithubCredentials) Choose a method of providing GitHub API access for projen workflows. Default: use a personal access token named PROJEN_GITHUB_TOKEN - projenTokenSecret (
string) The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows. Default: "PROJEN_GITHUB_TOKEN" - readme (
SampleReadmeProps) The README setup. Default: { filename: 'README.md', contents: '# replace this' } - stale (
boolean) Auto-close of stale issues and pull request. Default: false - staleOptions (
github.StaleOptions) Auto-close stale issues and pull requests. Default: see defaults inStaleOptions - vscode (
boolean) Enable VSCode integration. Default: true - allowLibraryDependencies (
boolean) Allow the project to includepeerDependenciesandbundledDependencies. Default: true - authorEmail (
string) Author's e-mail. Optional - authorName (
string) Author's name. Optional - authorOrganization (
boolean) Author's Organization. Optional - authorUrl (
string) Author's URL / Website. Optional - autoDetectBin (
boolean) Automatically add all executables under thebindirectory to yourpackage.jsonfile under thebinsection. Default: true - bin (
Map<string, string>) Binary programs vended with your module. Optional - bugsEmail (
string) The email address to which issues should be reported. Optional - bugsUrl (
string) The url to your project's issue tracker. Optional - bundledDeps (
Array) List of dependencies to bundle into this module. Optional - codeArtifactOptions (
javascript.CodeArtifactOptions) Options for npm packages using AWS CodeArtifact. Default: undefined - deps (
Array) Runtime dependencies of this module. Default: [] - description (
string) The description is just a string that helps people understand the purpose of the package. Optional - devDeps (
Array) Build dependencies for this module. Default: [] - entrypoint (
string) Module entrypoint (maininpackage.json). Default: "lib/index.js" - homepage (
string) Package's Homepage / Website. Optional - keywords (
Array) Keywords to include inpackage.json. Optional - license (
string) License's SPDX identifier. Default: "Apache-2.0" - licensed (
boolean) Indicates if a license should be added. Default: true - maxNodeVersion (
string) Minimum node.js version to require viaengines(inclusive). Default: no max - minNodeVersion (
string) Minimum Node.js version to require via package.jsonengines(inclusive). Default: no "engines" specified - npmAccess (
javascript.NpmAccess) Access level of the npm package. Default: for scoped packages (e.g.foo@bar), the default isNpmAccess.RESTRICTED, for non-scoped packages, the default isNpmAccess.PUBLIC. - npmRegistry (
string) The host name of the npm registry to publish to. Optional - npmRegistryUrl (
string) The base URL of the npm package registry. Default: "https://registry.npmjs.org" - npmTokenSecret (
string) GitHub secret which contains the NPM token to use when publishing packages. Default: "NPM_TOKEN" - packageManager (
javascript.NodePackageManager) The Node Package Manager used to execute scripts. Default: NodePackageManager.YARN - packageName (
string) The "name" in package.json. Default: defaults to project name - peerDependencyOptions (
javascript.PeerDependencyOptions) Options forpeerDeps. Optional - peerDeps (
Array) Peer dependencies for this module. Default: [] - repository (
string) The repository is the location where the actual code for your package lives. Optional - repositoryDirectory (
string) If the package.json for your package is not in the root directory (for example if it is part of a monorepo), you can specify the directory in which it lives. Optional - scopedPackagesOptions (
Array<javascript.ScopedPackagesOptions>) Options for privately hosted scoped packages. Default: fetch all scoped packages from the public npm registry - scripts (
Map<string, string>) npm scripts to include. Default: {} - stability (
string) Package's Stability. Optional - jsiiReleaseVersion (
string) Version requirement ofpublibwhich is used to publish modules to npm. Default: "latest" - majorVersion (
number) Major version to release from the default branch. Default: Major version is not enforced. - npmDistTag (
string) The npmDistTag to use when publishing from the default branch. Default: "latest" - postBuildSteps (
Array<github.workflows.JobStep>) Steps to execute after build as part of the release workflow. Default: [] - prerelease (
string) Bump versions from the default branch as pre-releases (e.g. "beta", "alpha", "pre"). Default: normal semantic versions - publishDryRun (
boolean) Instead of actually publishing to package managers, just print the publishing command. Default: false - publishTasks (
boolean) Define publishing tasks that can be executed manually as well as workflows. Default: false - releaseBranches (
Map<string, release.BranchOptions>) Defines additional release branches. Default: no additional branches are used for release. you can useaddBranch()to add additional branches. - releaseEveryCommit (
boolean) Automatically release new versions every commit to one of branches inreleaseBranches. Default: true - releaseFailureIssue (
boolean) Create a github issue on every failed publishing task. Default: false - releaseFailureIssueLabel (
string) The label to apply to issues indicating publish failures. Default: "failed-release" - releaseSchedule (
string) CRON schedule to trigger new releases. Default: no scheduled releases - releaseTagPrefix (
string) Automatically add the given prefix to release tags. Useful if you are releasing on multiple branches with overlapping version numbers. Default: no prefix - releaseTrigger (
release.ReleaseTrigger) The release trigger to use. Default: Continuous releases (ReleaseTrigger.continuous()) - releaseWorkflowName (
string) The name of the default release workflow. Default: "Release" - releaseWorkflowSetupSteps (
Array<github.workflows.JobStep>) A set of workflow steps to execute in order to setup the workflow container. Optional - versionrcOptions (
Map<string, any>) Custom configuration used when creating changelog with standard-version package. Default: standard configuration applicable for GitHub repositories - workflowContainerImage (
string) Container image to use for GitHub workflows. Default: default image - workflowRunsOn (
Array) Github Runner selection labels. Default: ["ubuntu-latest"] - defaultReleaseBranch (
string) The name of the main release branch. - artifactsDirectory (
string) A directory which will contain build artifacts. Default: "dist" - autoApproveUpgrades (
boolean) Automatically approve deps upgrade PRs, allowing them to be merged by mergify (if configued). Default: true - buildWorkflow (
boolean) Define a GitHub workflow for building PRs. Default: true if not a subproject - buildWorkflowTriggers (
github.workflows.Triggers) Build workflow triggers. Default: "{ pullRequest: {}, workflowDispatch: {} }" - bundlerOptions (
javascript.BundlerOptions) Options forBundler. Optional - codeCov (
boolean) Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/ Uses codecov/codecov-action@v1 A secret is required for private repos. Configured with @codeCovTokenSecret. Default: false - codeCovTokenSecret (
string) Define the secret name for a specified https://codecov.io/ token A secret is required to send coverage for private repositories. Default: if this option is not specified, only public repositories are supported - copyrightOwner (
string) License copyright owner. Default: defaults to the value of authorName or "" ifauthorNameis undefined. - copyrightPeriod (
string) The copyright years to put in the LICENSE file. Default: current year - dependabot (
boolean) Use dependabot to handle dependency upgrades. Default: false - dependabotOptions (
github.DependabotOptions) Options for dependabot. Default: default options - depsUpgrade (
boolean) Use github workflows to handle dependency upgrades. Default: true - depsUpgradeOptions (
javascript.UpgradeDependenciesOptions) Options forUpgradeDependencies. Default: default options - gitignore (
Array) Additional entries to .gitignore. Optional - jest (
boolean) Setup jest unit tests. Default: true - jestOptions (
javascript.JestOptions) Jest options. Default: default options - mutableBuild (
boolean) Automatically update files modified during builds to pull-request branches. Default: true - npmignore (
Array) Additional entries to .npmignore. Optional - npmignoreEnabled (
boolean) Defines an .npmignore file. Normally this is only needed for libraries that are packaged as tarballs. Default: true - package (
boolean) Defines apackagetask that will produce an npm tarball under the artifacts directory (e.g.dist). Default: true - prettier (
boolean) Setup prettier. Default: false - prettierOptions (
javascript.PrettierOptions) Prettier options. Default: default options - projenDevDependency (
boolean) Indicates of "projen" should be installed as a devDependency. Default: true - projenrcJs (
boolean) Generate (once) .projenrc.js (in JavaScript). Set tofalsein order to disable .projenrc.js generation. Default: true if projenrcJson is false - projenrcJsOptions (
javascript.ProjenrcOptions) Options for .projenrc.js. Default: default options - projenVersion (
string) Version of projen to install. Default: Defaults to the latest version. - pullRequestTemplate (
boolean) Include a GitHub pull request template. Default: true - pullRequestTemplateContents (
Array) The contents of the pull request template. Default: default content - release (
boolean) Add release management to this project. Default: true (false for subprojects) - releaseToNpm (
boolean) Automatically release to npm when new versions are introduced. Default: false - releaseWorkflow (
boolean) DEPRECATED: renamed torelease. Default: true if not a subproject - workflowBootstrapSteps (
Array<github.workflows.JobStep>) Workflow steps to use in order to bootstrap this repo. Default: "yarn install --frozen-lockfile && yarn projen" - workflowGitIdentity (
github.GitIdentity) The git identity to use in workflows. Default: GitHub Actions - workflowNodeVersion (
string) The node version to use in GitHub workflows. Default: same asminNodeVersion - disableTsconfig (
boolean) Do not generate atsconfig.jsonfile (used by jsii projects since tsconfig.json is generated by the jsii compiler). Default: false - docgen (
boolean) Docgen by Typedoc. Default: false - docsDirectory (
string) Docs directory. Default: "docs" - entrypointTypes (
string) The .d.ts file that includes the type declarations for this module. Default: .d.ts file derived from the project's entrypoint (usually lib/index.d.ts) - eslint (
boolean) Setup eslint. Default: true - eslintOptions (
javascript.EslintOptions) Eslint options. Default: opinionated default options - libdir (
string) Typescript artifacts output directory. Default: "lib" - projenrcTs (
boolean) Use TypeScript for your projenrc file (.projenrc.ts). Default: false - projenrcTsOptions (
typescript.ProjenrcOptions) Options for .projenrc.ts. Optional - sampleCode (
boolean) Generate one-time sample insrc/andtest/if there are no files there. Default: true - srcdir (
string) Typescript sources directory. Default: "src" - testdir (
string) Jest tests directory. Tests files should be namedxxx.test.ts. Default: "test" - tsconfig (
javascript.TypescriptConfigOptions) Custom TSConfig. Default: default options - tsconfigDev (
javascript.TypescriptConfigOptions) Custom tsconfig options for the development tsconfig.json file (used for testing). Default: use the production tsconfig options - tsconfigDevFile (
string) The name of the development tsconfig.json file. Default: "tsconfig.dev.json" - typescriptVersion (
string) TypeScript version to use. Default: "latest" - buildCommand (
string) A command to execute before synthesis. Default: no build command - cdkout (
string) cdk.out directory. Default: "cdk.out" - context (
Map<string, any>) Additional context to include incdk.json. Default: no additional context - featureFlags (
boolean) Include all feature flags in cdk.json. Default: true - requireApproval (
awscdk.ApprovalLevel) To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them. Default: ApprovalLevel.BROADENING - watchExcludes (
Array) Glob patterns to exclude fromcdk watch. Default: [] - watchIncludes (
Array) Glob patterns to include incdk watch. Default: [] - cdkVersion (
string) Minimum version of the AWS CDK to depend on. - cdkAssert (
boolean) Warning: NodeJS only. Default: will be included by default for AWS CDK >= 1.0.0 < 2.0.0 - cdkAssertions (
boolean) Install the assertions library? Default: will be included by default for AWS CDK >= 1.111.0 < 2.0.0 - cdkDependencies (
Array) Which AWS CDKv1 modules this project requires. Optional - cdkDependenciesAsDeps (
boolean) If this is enabled (default), all modules declared incdkDependencieswill be also added as normaldependencies(as well aspeerDependencies). Default: true - cdkTestDependencies (
Array) AWS CDK modules required for testing. Optional - cdkVersionPinning (
boolean) Use pinned version instead of caret version for CDK. Optional - constructsVersion (
string) Minimum version of theconstructslibrary to depend on. Default: for CDK 1.x the default is "3.2.27", for CDK 2.x the default is "10.0.5". - appEntrypoint (
string) The CDK app's entrypoint (relative to the source directory, which is "src" by default). Default: "main.ts" - integrationTestAutoDiscover (
boolean) Automatically discovers and creates integration tests for each.integ.tsfile in under your test directory. Default: true - lambdaAutoDiscover (
boolean) Automatically adds anawscdk.LambdaFunctionfor each.lambda.tshandler in your source tree. If this is disabled, you can manually add anawscdk.AutoDiscovercomponent to your project. Default: true - lambdaExtensionAutoDiscover (
boolean) Automatically adds anawscdk.LambdaExtensionfor each.lambda-extension.tsentrypoint in your source tree. If this is disabled, you can manually add anawscdk.AutoDiscovercomponent to your project. Default: true - lambdaOptions (
awscdk.LambdaFunctionCommonOptions) Common options for all AWS Lambda functions. Default: default options - cdkPipelines (
boolean) Enable CDK pipelines. Default: false - sops (
SopsAspectOptions) Enable storing secrets using Mozilla SOPS. Default: no SOPS config
- name (
| Name | Type | Description |
|---|---|---|
| npmConfig | javascript.NpmConfig |
Extends: Component
new SopsAspect(app: TypeScriptProject, options: SopsAspectOptions)- app (
typescript.TypeScriptProject) No description - options (
SopsAspectOptions) No description- secrets (
Map<string, string>) Define a mapping of SOPS files to SecretsManager secrets.
- secrets (
| Name | Type | Description |
|---|---|---|
| generatedCodeFile | SourceCode |
AWS CDK app in TypeScript.
Extends: awscdk.AwsCdkTypeScriptApp
new TaimosCdkApp(options: TaimosCdkAppOptions)- options (
TaimosCdkAppOptions) No description- name (
string) This is the name of your project. - logging (
LoggerOptions) Configure logging options such as verbosity. Default: {} - outdir (
string) The root directory of the project. Default: "." - parent (
Project) The parent project, if this project is part of a bigger project. Optional - projenCommand (
string) The shell command to use in order to run the projen CLI. Default: "npx projen" - projenrcJson (
boolean) Generate (once) .projenrc.json (in JSON). Set tofalsein order to disable .projenrc.json generation. Default: false - projenrcJsonOptions (
ProjenrcOptions) Options for .projenrc.json. Default: default options - autoApproveOptions (
github.AutoApproveOptions) Enable and configure the 'auto approve' workflow. Default: auto approve is disabled - autoMerge (
boolean) Enable automatic merging on GitHub. Default: true - autoMergeOptions (
github.AutoMergeOptions) Configure options for automatic merging on GitHub. Default: see defaults inAutoMergeOptions - clobber (
boolean) Add aclobbertask which resets the repo to origin. Default: true - devContainer (
boolean) Add a VSCode development environment (used for GitHub Codespaces). Default: false - github (
boolean) Enable GitHub integration. Default: true - githubOptions (
github.GitHubOptions) Options for GitHub integration. Default: see GitHubOptions - gitpod (
boolean) Add a Gitpod development environment. Default: false - mergify (
boolean) Whether mergify should be enabled on this repository or not. Default: true - mergifyOptions (
github.MergifyOptions) Options for mergify. Default: default options - projectType (
ProjectType) Which type of project this is (library/app). Default: ProjectType.UNKNOWN - projenCredentials (
github.GithubCredentials) Choose a method of providing GitHub API access for projen workflows. Default: use a personal access token named PROJEN_GITHUB_TOKEN - projenTokenSecret (
string) The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows. Default: "PROJEN_GITHUB_TOKEN" - readme (
SampleReadmeProps) The README setup. Default: { filename: 'README.md', contents: '# replace this' } - stale (
boolean) Auto-close of stale issues and pull request. Default: false - staleOptions (
github.StaleOptions) Auto-close stale issues and pull requests. Default: see defaults inStaleOptions - vscode (
boolean) Enable VSCode integration. Default: true - allowLibraryDependencies (
boolean) Allow the project to includepeerDependenciesandbundledDependencies. Default: true - authorEmail (
string) Author's e-mail. Optional - authorName (
string) Author's name. Optional - authorOrganization (
boolean) Author's Organization. Optional - authorUrl (
string) Author's URL / Website. Optional - autoDetectBin (
boolean) Automatically add all executables under thebindirectory to yourpackage.jsonfile under thebinsection. Default: true - bin (
Map<string, string>) Binary programs vended with your module. Optional - bugsEmail (
string) The email address to which issues should be reported. Optional - bugsUrl (
string) The url to your project's issue tracker. Optional - bundledDeps (
Array) List of dependencies to bundle into this module. Optional - codeArtifactOptions (
javascript.CodeArtifactOptions) Options for npm packages using AWS CodeArtifact. Default: undefined - deps (
Array) Runtime dependencies of this module. Default: [] - description (
string) The description is just a string that helps people understand the purpose of the package. Optional - devDeps (
Array) Build dependencies for this module. Default: [] - entrypoint (
string) Module entrypoint (maininpackage.json). Default: "lib/index.js" - homepage (
string) Package's Homepage / Website. Optional - keywords (
Array) Keywords to include inpackage.json. Optional - license (
string) License's SPDX identifier. Default: "Apache-2.0" - licensed (
boolean) Indicates if a license should be added. Default: true - maxNodeVersion (
string) Minimum node.js version to require viaengines(inclusive). Default: no max - minNodeVersion (
string) Minimum Node.js version to require via package.jsonengines(inclusive). Default: no "engines" specified - npmAccess (
javascript.NpmAccess) Access level of the npm package. Default: for scoped packages (e.g.foo@bar), the default isNpmAccess.RESTRICTED, for non-scoped packages, the default isNpmAccess.PUBLIC. - npmRegistry (
string) The host name of the npm registry to publish to. Optional - npmRegistryUrl (
string) The base URL of the npm package registry. Default: "https://registry.npmjs.org" - npmTokenSecret (
string) GitHub secret which contains the NPM token to use when publishing packages. Default: "NPM_TOKEN" - packageManager (
javascript.NodePackageManager) The Node Package Manager used to execute scripts. Default: NodePackageManager.YARN - packageName (
string) The "name" in package.json. Default: defaults to project name - peerDependencyOptions (
javascript.PeerDependencyOptions) Options forpeerDeps. Optional - peerDeps (
Array) Peer dependencies for this module. Default: [] - repository (
string) The repository is the location where the actual code for your package lives. Optional - repositoryDirectory (
string) If the package.json for your package is not in the root directory (for example if it is part of a monorepo), you can specify the directory in which it lives. Optional - scopedPackagesOptions (
Array<javascript.ScopedPackagesOptions>) Options for privately hosted scoped packages. Default: fetch all scoped packages from the public npm registry - scripts (
Map<string, string>) npm scripts to include. Default: {} - stability (
string) Package's Stability. Optional - jsiiReleaseVersion (
string) Version requirement ofpublibwhich is used to publish modules to npm. Default: "latest" - majorVersion (
number) Major version to release from the default branch. Default: Major version is not enforced. - npmDistTag (
string) The npmDistTag to use when publishing from the default branch. Default: "latest" - postBuildSteps (
Array<github.workflows.JobStep>) Steps to execute after build as part of the release workflow. Default: [] - prerelease (
string) Bump versions from the default branch as pre-releases (e.g. "beta", "alpha", "pre"). Default: normal semantic versions - publishDryRun (
boolean) Instead of actually publishing to package managers, just print the publishing command. Default: false - publishTasks (
boolean) Define publishing tasks that can be executed manually as well as workflows. Default: false - releaseBranches (
Map<string, release.BranchOptions>) Defines additional release branches. Default: no additional branches are used for release. you can useaddBranch()to add additional branches. - releaseEveryCommit (
boolean) Automatically release new versions every commit to one of branches inreleaseBranches. Default: true - releaseFailureIssue (
boolean) Create a github issue on every failed publishing task. Default: false - releaseFailureIssueLabel (
string) The label to apply to issues indicating publish failures. Default: "failed-release" - releaseSchedule (
string) CRON schedule to trigger new releases. Default: no scheduled releases - releaseTagPrefix (
string) Automatically add the given prefix to release tags. Useful if you are releasing on multiple branches with overlapping version numbers. Default: no prefix - releaseTrigger (
release.ReleaseTrigger) The release trigger to use. Default: Continuous releases (ReleaseTrigger.continuous()) - releaseWorkflowName (
string) The name of the default release workflow. Default: "Release" - releaseWorkflowSetupSteps (
Array<github.workflows.JobStep>) A set of workflow steps to execute in order to setup the workflow container. Optional - versionrcOptions (
Map<string, any>) Custom configuration used when creating changelog with standard-version package. Default: standard configuration applicable for GitHub repositories - workflowContainerImage (
string) Container image to use for GitHub workflows. Default: default image - workflowRunsOn (
Array) Github Runner selection labels. Default: ["ubuntu-latest"] - defaultReleaseBranch (
string) The name of the main release branch. - artifactsDirectory (
string) A directory which will contain build artifacts. Default: "dist" - autoApproveUpgrades (
boolean) Automatically approve deps upgrade PRs, allowing them to be merged by mergify (if configued). Default: true - buildWorkflow (
boolean) Define a GitHub workflow for building PRs. Default: true if not a subproject - buildWorkflowTriggers (
github.workflows.Triggers) Build workflow triggers. Default: "{ pullRequest: {}, workflowDispatch: {} }" - bundlerOptions (
javascript.BundlerOptions) Options forBundler. Optional - codeCov (
boolean) Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/ Uses codecov/codecov-action@v1 A secret is required for private repos. Configured with @codeCovTokenSecret. Default: false - codeCovTokenSecret (
string) Define the secret name for a specified https://codecov.io/ token A secret is required to send coverage for private repositories. Default: if this option is not specified, only public repositories are supported - copyrightOwner (
string) License copyright owner. Default: defaults to the value of authorName or "" ifauthorNameis undefined. - copyrightPeriod (
string) The copyright years to put in the LICENSE file. Default: current year - dependabot (
boolean) Use dependabot to handle dependency upgrades. Default: false - dependabotOptions (
github.DependabotOptions) Options for dependabot. Default: default options - depsUpgrade (
boolean) Use github workflows to handle dependency upgrades. Default: true - depsUpgradeOptions (
javascript.UpgradeDependenciesOptions) Options forUpgradeDependencies. Default: default options - gitignore (
Array) Additional entries to .gitignore. Optional - jest (
boolean) Setup jest unit tests. Default: true - jestOptions (
javascript.JestOptions) Jest options. Default: default options - mutableBuild (
boolean) Automatically update files modified during builds to pull-request branches. Default: true - npmignore (
Array) Additional entries to .npmignore. Optional - npmignoreEnabled (
boolean) Defines an .npmignore file. Normally this is only needed for libraries that are packaged as tarballs. Default: true - package (
boolean) Defines apackagetask that will produce an npm tarball under the artifacts directory (e.g.dist). Default: true - prettier (
boolean) Setup prettier. Default: false - prettierOptions (
javascript.PrettierOptions) Prettier options. Default: default options - projenDevDependency (
boolean) Indicates of "projen" should be installed as a devDependency. Default: true - projenrcJs (
boolean) Generate (once) .projenrc.js (in JavaScript). Set tofalsein order to disable .projenrc.js generation. Default: true if projenrcJson is false - projenrcJsOptions (
javascript.ProjenrcOptions) Options for .projenrc.js. Default: default options - projenVersion (
string) Version of projen to install. Default: Defaults to the latest version. - pullRequestTemplate (
boolean) Include a GitHub pull request template. Default: true - pullRequestTemplateContents (
Array) The contents of the pull request template. Default: default content - release (
boolean) Add release management to this project. Default: true (false for subprojects) - releaseToNpm (
boolean) Automatically release to npm when new versions are introduced. Default: false - releaseWorkflow (
boolean) DEPRECATED: renamed torelease. Default: true if not a subproject - workflowBootstrapSteps (
Array<github.workflows.JobStep>) Workflow steps to use in order to bootstrap this repo. Default: "yarn install --frozen-lockfile && yarn projen" - workflowGitIdentity (
github.GitIdentity) The git identity to use in workflows. Default: GitHub Actions - workflowNodeVersion (
string) The node version to use in GitHub workflows. Default: same asminNodeVersion - disableTsconfig (
boolean) Do not generate atsconfig.jsonfile (used by jsii projects since tsconfig.json is generated by the jsii compiler). Default: false - docgen (
boolean) Docgen by Typedoc. Default: false - docsDirectory (
string) Docs directory. Default: "docs" - entrypointTypes (
string) The .d.ts file that includes the type declarations for this module. Default: .d.ts file derived from the project's entrypoint (usually lib/index.d.ts) - eslint (
boolean) Setup eslint. Default: true - eslintOptions (
javascript.EslintOptions) Eslint options. Default: opinionated default options - libdir (
string) Typescript artifacts output directory. Default: "lib" - projenrcTs (
boolean) Use TypeScript for your projenrc file (.projenrc.ts). Default: false - projenrcTsOptions (
typescript.ProjenrcOptions) Options for .projenrc.ts. Optional - sampleCode (
boolean) Generate one-time sample insrc/andtest/if there are no files there. Default: true - srcdir (
string) Typescript sources directory. Default: "src" - testdir (
string) Jest tests directory. Tests files should be namedxxx.test.ts. Default: "test" - tsconfig (
javascript.TypescriptConfigOptions) Custom TSConfig. Default: default options - tsconfigDev (
javascript.TypescriptConfigOptions) Custom tsconfig options for the development tsconfig.json file (used for testing). Default: use the production tsconfig options - tsconfigDevFile (
string) The name of the development tsconfig.json file. Default: "tsconfig.dev.json" - typescriptVersion (
string) TypeScript version to use. Default: "latest" - buildCommand (
string) A command to execute before synthesis. Default: no build command - cdkout (
string) cdk.out directory. Default: "cdk.out" - context (
Map<string, any>) Additional context to include incdk.json. Default: no additional context - featureFlags (
boolean) Include all feature flags in cdk.json. Default: true - requireApproval (
awscdk.ApprovalLevel) To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them. Default: ApprovalLevel.BROADENING - watchExcludes (
Array) Glob patterns to exclude fromcdk watch. Default: [] - watchIncludes (
Array) Glob patterns to include incdk watch. Default: [] - cdkVersion (
string) Minimum version of the AWS CDK to depend on. - cdkAssert (
boolean) Warning: NodeJS only. Default: will be included by default for AWS CDK >= 1.0.0 < 2.0.0 - cdkAssertions (
boolean) Install the assertions library? Default: will be included by default for AWS CDK >= 1.111.0 < 2.0.0 - cdkDependencies (
Array) Which AWS CDKv1 modules this project requires. Optional - cdkDependenciesAsDeps (
boolean) If this is enabled (default), all modules declared incdkDependencieswill be also added as normaldependencies(as well aspeerDependencies). Default: true - cdkTestDependencies (
Array) AWS CDK modules required for testing. Optional - cdkVersionPinning (
boolean) Use pinned version instead of caret version for CDK. Optional - constructsVersion (
string) Minimum version of theconstructslibrary to depend on. Default: for CDK 1.x the default is "3.2.27", for CDK 2.x the default is "10.0.5". - appEntrypoint (
string) The CDK app's entrypoint (relative to the source directory, which is "src" by default). Default: "main.ts" - integrationTestAutoDiscover (
boolean) Automatically discovers and creates integration tests for each.integ.tsfile in under your test directory. Default: true - lambdaAutoDiscover (
boolean) Automatically adds anawscdk.LambdaFunctionfor each.lambda.tshandler in your source tree. If this is disabled, you can manually add anawscdk.AutoDiscovercomponent to your project. Default: true - lambdaExtensionAutoDiscover (
boolean) Automatically adds anawscdk.LambdaExtensionfor each.lambda-extension.tsentrypoint in your source tree. If this is disabled, you can manually add anawscdk.AutoDiscovercomponent to your project. Default: true - lambdaOptions (
awscdk.LambdaFunctionCommonOptions) Common options for all AWS Lambda functions. Default: default options - cdkPipelines (
boolean) Enable CDK pipelines. Default: false - sops (
SopsAspectOptions) Enable storing secrets using Mozilla SOPS. Default: no SOPS config
- name (
TypeScript library.
Extends: awscdk.AwsCdkConstructLibrary
new TaimosCdkConstructLibrary(options: TaimosCdkConstructLibraryOptions)- options (
TaimosCdkConstructLibraryOptions) No description- name (
string) This is the name of your project. - logging (
LoggerOptions) Configure logging options such as verbosity. Default: {} - outdir (
string) The root directory of the project. Default: "." - parent (
Project) The parent project, if this project is part of a bigger project. Optional - projenCommand (
string) The shell command to use in order to run the projen CLI. Default: "npx projen" - projenrcJson (
boolean) Generate (once) .projenrc.json (in JSON). Set tofalsein order to disable .projenrc.json generation. Default: false - projenrcJsonOptions (
ProjenrcOptions) Options for .projenrc.json. Default: default options - autoApproveOptions (
github.AutoApproveOptions) Enable and configure the 'auto approve' workflow. Default: auto approve is disabled - autoMerge (
boolean) Enable automatic merging on GitHub. Default: true - autoMergeOptions (
github.AutoMergeOptions) Configure options for automatic merging on GitHub. Default: see defaults inAutoMergeOptions - clobber (
boolean) Add aclobbertask which resets the repo to origin. Default: true - devContainer (
boolean) Add a VSCode development environment (used for GitHub Codespaces). Default: false - github (
boolean) Enable GitHub integration. Default: true - githubOptions (
github.GitHubOptions) Options for GitHub integration. Default: see GitHubOptions - gitpod (
boolean) Add a Gitpod development environment. Default: false - mergify (
boolean) Whether mergify should be enabled on this repository or not. Default: true - mergifyOptions (
github.MergifyOptions) Options for mergify. Default: default options - projectType (
ProjectType) Which type of project this is (library/app). Default: ProjectType.UNKNOWN - projenCredentials (
github.GithubCredentials) Choose a method of providing GitHub API access for projen workflows. Default: use a personal access token named PROJEN_GITHUB_TOKEN - projenTokenSecret (
string) The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows. Default: "PROJEN_GITHUB_TOKEN" - readme (
SampleReadmeProps) The README setup. Default: { filename: 'README.md', contents: '# replace this' } - stale (
boolean) Auto-close of stale issues and pull request. Default: false - staleOptions (
github.StaleOptions) Auto-close stale issues and pull requests. Default: see defaults inStaleOptions - vscode (
boolean) Enable VSCode integration. Default: true - allowLibraryDependencies (
boolean) Allow the project to includepeerDependenciesandbundledDependencies. Default: true - authorEmail (
string) Author's e-mail. Optional - authorName (
string) Author's name. Optional - authorOrganization (
boolean) Author's Organization. Optional - authorUrl (
string) Author's URL / Website. Optional - autoDetectBin (
boolean) Automatically add all executables under thebindirectory to yourpackage.jsonfile under thebinsection. Default: true - bin (
Map<string, string>) Binary programs vended with your module. Optional - bugsEmail (
string) The email address to which issues should be reported. Optional - bugsUrl (
string) The url to your project's issue tracker. Optional - bundledDeps (
Array) List of dependencies to bundle into this module. Optional - codeArtifactOptions (
javascript.CodeArtifactOptions) Options for npm packages using AWS CodeArtifact. Default: undefined - deps (
Array) Runtime dependencies of this module. Default: [] - description (
string) The description is just a string that helps people understand the purpose of the package. Optional - devDeps (
Array) Build dependencies for this module. Default: [] - entrypoint (
string) Module entrypoint (maininpackage.json). Default: "lib/index.js" - homepage (
string) Package's Homepage / Website. Optional - keywords (
Array) Keywords to include inpackage.json. Optional - license (
string) License's SPDX identifier. Default: "Apache-2.0" - licensed (
boolean) Indicates if a license should be added. Default: true - maxNodeVersion (
string) Minimum node.js version to require viaengines(inclusive). Default: no max - minNodeVersion (
string) Minimum Node.js version to require via package.jsonengines(inclusive). Default: no "engines" specified - npmAccess (
javascript.NpmAccess) Access level of the npm package. Default: for scoped packages (e.g.foo@bar), the default isNpmAccess.RESTRICTED, for non-scoped packages, the default isNpmAccess.PUBLIC. - npmRegistry (
string) The host name of the npm registry to publish to. Optional - npmRegistryUrl (
string) The base URL of the npm package registry. Default: "https://registry.npmjs.org" - npmTokenSecret (
string) GitHub secret which contains the NPM token to use when publishing packages. Default: "NPM_TOKEN" - packageManager (
javascript.NodePackageManager) The Node Package Manager used to execute scripts. Default: NodePackageManager.YARN - packageName (
string) The "name" in package.json. Default: defaults to project name - peerDependencyOptions (
javascript.PeerDependencyOptions) Options forpeerDeps. Optional - peerDeps (
Array) Peer dependencies for this module. Default: [] - repository (
string) The repository is the location where the actual code for your package lives. Optional - repositoryDirectory (
string) If the package.json for your package is not in the root directory (for example if it is part of a monorepo), you can specify the directory in which it lives. Optional - scopedPackagesOptions (
Array<javascript.ScopedPackagesOptions>) Options for privately hosted scoped packages. Default: fetch all scoped packages from the public npm registry - scripts (
Map<string, string>) npm scripts to include. Default: {} - stability (
string) Package's Stability. Optional - jsiiReleaseVersion (
string) Version requirement ofpublibwhich is used to publish modules to npm. Default: "latest" - majorVersion (
number) Major version to release from the default branch. Default: Major version is not enforced. - npmDistTag (
string) The npmDistTag to use when publishing from the default branch. Default: "latest" - postBuildSteps (
Array<github.workflows.JobStep>) Steps to execute after build as part of the release workflow. Default: [] - prerelease (
string) Bump versions from the default branch as pre-releases (e.g. "beta", "alpha", "pre"). Default: normal semantic versions - publishDryRun (
boolean) Instead of actually publishing to package managers, just print the publishing command. Default: false - publishTasks (
boolean) Define publishing tasks that can be executed manually as well as workflows. Default: false - releaseBranches (
Map<string, release.BranchOptions>) Defines additional release branches. Default: no additional branches are used for release. you can useaddBranch()to add additional branches. - releaseEveryCommit (
boolean) Automatically release new versions every commit to one of branches inreleaseBranches. Default: true - releaseFailureIssue (
boolean) Create a github issue on every failed publishing task. Default: false - releaseFailureIssueLabel (
string) The label to apply to issues indicating publish failures. Default: "failed-release" - releaseSchedule (
string) CRON schedule to trigger new releases. Default: no scheduled releases - releaseTagPrefix (
string) Automatically add the given prefix to release tags. Useful if you are releasing on multiple branches with overlapping version numbers. Default: no prefix - releaseTrigger (
release.ReleaseTrigger) The release trigger to use. Default: Continuous releases (ReleaseTrigger.continuous()) - releaseWorkflowName (
string) The name of the default release workflow. Default: "Release" - releaseWorkflowSetupSteps (
Array<github.workflows.JobStep>) A set of workflow steps to execute in order to setup the workflow container. Optional - versionrcOptions (
Map<string, any>) Custom configuration used when creating changelog with standard-version package. Default: standard configuration applicable for GitHub repositories - workflowContainerImage (
string) Container image to use for GitHub workflows. Default: default image - workflowRunsOn (
Array) Github Runner selection labels. Default: ["ubuntu-latest"] - defaultReleaseBranch (
string) The name of the main release branch. - artifactsDirectory (
string) A directory which will contain build artifacts. Default: "dist" - autoApproveUpgrades (
boolean) Automatically approve deps upgrade PRs, allowing them to be merged by mergify (if configued). Default: true - buildWorkflow (
boolean) Define a GitHub workflow for building PRs. Default: true if not a subproject - buildWorkflowTriggers (
github.workflows.Triggers) Build workflow triggers. Default: "{ pullRequest: {}, workflowDispatch: {} }" - bundlerOptions (
javascript.BundlerOptions) Options forBundler. Optional - codeCov (
boolean) Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/ Uses codecov/codecov-action@v1 A secret is required for private repos. Configured with @codeCovTokenSecret. Default: false - codeCovTokenSecret (
string) Define the secret name for a specified https://codecov.io/ token A secret is required to send coverage for private repositories. Default: if this option is not specified, only public repositories are supported - copyrightOwner (
string) License copyright owner. Default: defaults to the value of authorName or "" ifauthorNameis undefined. - copyrightPeriod (
string) The copyright years to put in the LICENSE file. Default: current year - dependabot (
boolean) Use dependabot to handle dependency upgrades. Default: false - dependabotOptions (
github.DependabotOptions) Options for dependabot. Default: default options - depsUpgrade (
boolean) Use github workflows to handle dependency upgrades. Default: true - depsUpgradeOptions (
javascript.UpgradeDependenciesOptions) Options forUpgradeDependencies. Default: default options - gitignore (
Array) Additional entries to .gitignore. Optional - jest (
boolean) Setup jest unit tests. Default: true - jestOptions (
javascript.JestOptions) Jest options. Default: default options - mutableBuild (
boolean) Automatically update files modified during builds to pull-request branches. Default: true - npmignore (
Array) Additional entries to .npmignore. Optional - npmignoreEnabled (
boolean) Defines an .npmignore file. Normally this is only needed for libraries that are packaged as tarballs. Default: true - package (
boolean) Defines apackagetask that will produce an npm tarball under the artifacts directory (e.g.dist). Default: true - prettier (
boolean) Setup prettier. Default: false - prettierOptions (
javascript.PrettierOptions) Prettier options. Default: default options - projenDevDependency (
boolean) Indicates of "projen" should be installed as a devDependency. Default: true - projenrcJs (
boolean) Generate (once) .projenrc.js (in JavaScript). Set tofalsein order to disable .projenrc.js generation. Default: true if projenrcJson is false - projenrcJsOptions (
javascript.ProjenrcOptions) Options for .projenrc.js. Default: default options - projenVersion (
string) Version of projen to install. Default: Defaults to the latest version. - pullRequestTemplate (
boolean) Include a GitHub pull request template. Default: true - pullRequestTemplateContents (
Array) The contents of the pull request template. Default: default content - release (
boolean) Add release management to this project. Default: true (false for subprojects) - releaseToNpm (
boolean) Automatically release to npm when new versions are introduced. Default: false - releaseWorkflow (
boolean) DEPRECATED: renamed torelease. Default: true if not a subproject - workflowBootstrapSteps (
Array<github.workflows.JobStep>) Workflow steps to use in order to bootstrap this repo. Default: "yarn install --frozen-lockfile && yarn projen" - workflowGitIdentity (
github.GitIdentity) The git identity to use in workflows. Default: GitHub Actions - workflowNodeVersion (
string) The node version to use in GitHub workflows. Default: same asminNodeVersion - disableTsconfig (
boolean) Do not generate atsconfig.jsonfile (used by jsii projects since tsconfig.json is generated by the jsii compiler). Default: false - docgen (
boolean) Docgen by Typedoc. Default: false - docsDirectory (
string) Docs directory. Default: "docs" - entrypointTypes (
string) The .d.ts file that includes the type declarations for this module. Default: .d.ts file derived from the project's entrypoint (usually lib/index.d.ts) - eslint (
boolean) Setup eslint. Default: true - eslintOptions (
javascript.EslintOptions) Eslint options. Default: opinionated default options - libdir (
string) Typescript artifacts output directory. Default: "lib" - projenrcTs (
boolean) Use TypeScript for your projenrc file (.projenrc.ts). Default: false - projenrcTsOptions (
typescript.ProjenrcOptions) Options for .projenrc.ts. Optional - sampleCode (
boolean) Generate one-time sample insrc/andtest/if there are no files there. Default: true - srcdir (
string) Typescript sources directory. Default: "src" - testdir (
string) Jest tests directory. Tests files should be namedxxx.test.ts. Default: "test" - tsconfig (
javascript.TypescriptConfigOptions) Custom TSConfig. Default: default options - tsconfigDev (
javascript.TypescriptConfigOptions) Custom tsconfig options for the development tsconfig.json file (used for testing). Default: use the production tsconfig options - tsconfigDevFile (
string) The name of the development tsconfig.json file. Default: "tsconfig.dev.json" - typescriptVersion (
string) TypeScript version to use. Default: "latest" - author (
string) The name of the library author. - authorAddress (
string) Email or URL of the library author. - repositoryUrl (
string) Git repository URL. - compat (
boolean) Automatically run API compatibility test against the latest version published to npm after compilation. Default: false - compatIgnore (
string) Name of the ignore file for API compatibility tests. Default: ".compatignore" - docgenFilePath (
string) File path for generated docs. Default: "API.md" - dotnet (
cdk.JsiiDotNetTarget) No description Optional - excludeTypescript (
Array) Accepts a list of glob patterns. Optional - publishToGo (
cdk.JsiiGoTarget) Publish Go bindings to a git repository. Default: no publishing - publishToMaven (
cdk.JsiiJavaTarget) Publish to maven. Default: no publishing - publishToNuget (
cdk.JsiiDotNetTarget) Publish to NuGet. Default: no publishing - publishToPypi (
cdk.JsiiPythonTarget) Publish to pypi. Default: no publishing - python (
cdk.JsiiPythonTarget) No description Optional - rootdir (
string) No description Default: "." - catalog (
cdk.Catalog) Libraries will be picked up by the construct catalog when they are published to npm as jsii modules and will be published under:. Default: new version will be announced - cdkVersion (
string) Minimum version of the AWS CDK to depend on. - cdkAssert (
boolean) Warning: NodeJS only. Default: will be included by default for AWS CDK >= 1.0.0 < 2.0.0 - cdkAssertions (
boolean) Install the assertions library? Default: will be included by default for AWS CDK >= 1.111.0 < 2.0.0 - cdkDependencies (
Array) Which AWS CDKv1 modules this project requires. Optional - cdkDependenciesAsDeps (
boolean) If this is enabled (default), all modules declared incdkDependencieswill be also added as normaldependencies(as well aspeerDependencies). Default: true - cdkTestDependencies (
Array) AWS CDK modules required for testing. Optional - cdkVersionPinning (
boolean) Use pinned version instead of caret version for CDK. Optional - constructsVersion (
string) Minimum version of theconstructslibrary to depend on. Default: for CDK 1.x the default is "3.2.27", for CDK 2.x the default is "10.0.5". - integrationTestAutoDiscover (
boolean) Automatically discovers and creates integration tests for each.integ.tsfile in under your test directory. Default: true - lambdaAutoDiscover (
boolean) Automatically adds anaws_lambda.Functionfor each.lambda.tshandler in your source tree. If this is disabled, you either need to explicitly callaws_lambda.Function.autoDiscover()or define anew aws_lambda.Function()for each handler. Default: true - lambdaExtensionAutoDiscover (
boolean) Automatically adds anawscdk.LambdaExtensionfor each.lambda-extension.tsentrypoint in your source tree. If this is disabled, you can manually add anawscdk.AutoDiscovercomponent to your project. Default: true - lambdaOptions (
awscdk.LambdaFunctionCommonOptions) Common options for all AWS Lambda functions. Default: default options
- name (
Private TypeScript library.
Extends: TaimosTypescriptLibrary
new TaimosPrivateTypescriptLibrary(options: TaimosPrivateTypescriptLibraryOptions)- options (
TaimosPrivateTypescriptLibraryOptions) No description- name (
string) This is the name of your project. - logging (
LoggerOptions) Configure logging options such as verbosity. Default: {} - outdir (
string) The root directory of the project. Default: "." - parent (
Project) The parent project, if this project is part of a bigger project. Optional - projenCommand (
string) The shell command to use in order to run the projen CLI. Default: "npx projen" - projenrcJson (
boolean) Generate (once) .projenrc.json (in JSON). Set tofalsein order to disable .projenrc.json generation. Default: false - projenrcJsonOptions (
ProjenrcOptions) Options for .projenrc.json. Default: default options - autoApproveOptions (
github.AutoApproveOptions) Enable and configure the 'auto approve' workflow. Default: auto approve is disabled - autoMerge (
boolean) Enable automatic merging on GitHub. Default: true - autoMergeOptions (
github.AutoMergeOptions) Configure options for automatic merging on GitHub. Default: see defaults inAutoMergeOptions - clobber (
boolean) Add aclobbertask which resets the repo to origin. Default: true - devContainer (
boolean) Add a VSCode development environment (used for GitHub Codespaces). Default: false - github (
boolean) Enable GitHub integration. Default: true - githubOptions (
github.GitHubOptions) Options for GitHub integration. Default: see GitHubOptions - gitpod (
boolean) Add a Gitpod development environment. Default: false - mergify (
boolean) Whether mergify should be enabled on this repository or not. Default: true - mergifyOptions (
github.MergifyOptions) Options for mergify. Default: default options - projectType (
ProjectType) Which type of project this is (library/app). Default: ProjectType.UNKNOWN - projenCredentials (
github.GithubCredentials) Choose a method of providing GitHub API access for projen workflows. Default: use a personal access token named PROJEN_GITHUB_TOKEN - projenTokenSecret (
string) The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows. Default: "PROJEN_GITHUB_TOKEN" - readme (
SampleReadmeProps) The README setup. Default: { filename: 'README.md', contents: '# replace this' } - stale (
boolean) Auto-close of stale issues and pull request. Default: false - staleOptions (
github.StaleOptions) Auto-close stale issues and pull requests. Default: see defaults inStaleOptions - vscode (
boolean) Enable VSCode integration. Default: true - allowLibraryDependencies (
boolean) Allow the project to includepeerDependenciesandbundledDependencies. Default: true - authorEmail (
string) Author's e-mail. Optional - authorName (
string) Author's name. Optional - authorOrganization (
boolean) Author's Organization. Optional - authorUrl (
string) Author's URL / Website. Optional - autoDetectBin (
boolean) Automatically add all executables under thebindirectory to yourpackage.jsonfile under thebinsection. Default: true - bin (
Map<string, string>) Binary programs vended with your module. Optional - bugsEmail (
string) The email address to which issues should be reported. Optional - bugsUrl (
string) The url to your project's issue tracker. Optional - bundledDeps (
Array) List of dependencies to bundle into this module. Optional - codeArtifactOptions (
javascript.CodeArtifactOptions) Options for npm packages using AWS CodeArtifact. Default: undefined - deps (
Array) Runtime dependencies of this module. Default: [] - description (
string) The description is just a string that helps people understand the purpose of the package. Optional - devDeps (
Array) Build dependencies for this module. Default: [] - entrypoint (
string) Module entrypoint (maininpackage.json). Default: "lib/index.js" - homepage (
string) Package's Homepage / Website. Optional - keywords (
Array) Keywords to include inpackage.json. Optional - license (
string) License's SPDX identifier. Default: "Apache-2.0" - licensed (
boolean) Indicates if a license should be added. Default: true - maxNodeVersion (
string) Minimum node.js version to require viaengines(inclusive). Default: no max - minNodeVersion (
string) Minimum Node.js version to require via package.jsonengines(inclusive). Default: no "engines" specified - npmAccess (
javascript.NpmAccess) Access level of the npm package. Default: for scoped packages (e.g.foo@bar), the default isNpmAccess.RESTRICTED, for non-scoped packages, the default isNpmAccess.PUBLIC. - npmRegistry (
string) The host name of the npm registry to publish to. Optional - npmRegistryUrl (
string) The base URL of the npm package registry. Default: "https://registry.npmjs.org" - npmTokenSecret (
string) GitHub secret which contains the NPM token to use when publishing packages. Default: "NPM_TOKEN" - packageManager (
javascript.NodePackageManager) The Node Package Manager used to execute scripts. Default: NodePackageManager.YARN - packageName (
string) The "name" in package.json. Default: defaults to project name - peerDependencyOptions (
javascript.PeerDependencyOptions) Options forpeerDeps. Optional - peerDeps (
Array) Peer dependencies for this module. Default: [] - repository (
string) The repository is the location where the actual code for your package lives. Optional - repositoryDirectory (
string) If the package.json for your package is not in the root directory (for example if it is part of a monorepo), you can specify the directory in which it lives. Optional - scopedPackagesOptions (
Array<javascript.ScopedPackagesOptions>) Options for privately hosted scoped packages. Default: fetch all scoped packages from the public npm registry - scripts (
Map<string, string>) npm scripts to include. Default: {} - stability (
string) Package's Stability. Optional - jsiiReleaseVersion (
string) Version requirement ofpublibwhich is used to publish modules to npm. Default: "latest" - majorVersion (
number) Major version to release from the default branch. Default: Major version is not enforced. - npmDistTag (
string) The npmDistTag to use when publishing from the default branch. Default: "latest" - postBuildSteps (
Array<github.workflows.JobStep>) Steps to execute after build as part of the release workflow. Default: [] - prerelease (
string) Bump versions from the default branch as pre-releases (e.g. "beta", "alpha", "pre"). Default: normal semantic versions - publishDryRun (
boolean) Instead of actually publishing to package managers, just print the publishing command. Default: false - publishTasks (
boolean) Define publishing tasks that can be executed manually as well as workflows. Default: false - releaseBranches (
Map<string, release.BranchOptions>) Defines additional release branches. Default: no additional branches are used for release. you can useaddBranch()to add additional branches. - releaseEveryCommit (
boolean) Automatically release new versions every commit to one of branches inreleaseBranches. Default: true - releaseFailureIssue (
boolean) Create a github issue on every failed publishing task. Default: false - releaseFailureIssueLabel (
string) The label to apply to issues indicating publish failures. Default: "failed-release" - releaseSchedule (
string) CRON schedule to trigger new releases. Default: no scheduled releases - releaseTagPrefix (
string) Automatically add the given prefix to release tags. Useful if you are releasing on multiple branches with overlapping version numbers. Default: no prefix - releaseTrigger (
release.ReleaseTrigger) The release trigger to use. Default: Continuous releases (ReleaseTrigger.continuous()) - releaseWorkflowName (
string) The name of the default release workflow. Default: "Release" - releaseWorkflowSetupSteps (
Array<github.workflows.JobStep>) A set of workflow steps to execute in order to setup the workflow container. Optional - versionrcOptions (
Map<string, any>) Custom configuration used when creating changelog with standard-version package. Default: standard configuration applicable for GitHub repositories - workflowContainerImage (
string) Container image to use for GitHub workflows. Default: default image - workflowRunsOn (
Array) Github Runner selection labels. Default: ["ubuntu-latest"] - defaultReleaseBranch (
string) The name of the main release branch. - artifactsDirectory (
string) A directory which will contain build artifacts. Default: "dist" - autoApproveUpgrades (
boolean) Automatically approve deps upgrade PRs, allowing them to be merged by mergify (if configued). Default: true - buildWorkflow (
boolean) Define a GitHub workflow for building PRs. Default: true if not a subproject - buildWorkflowTriggers (
github.workflows.Triggers) Build workflow triggers. Default: "{ pullRequest: {}, workflowDispatch: {} }" - bundlerOptions (
javascript.BundlerOptions) Options forBundler. Optional - codeCov (
boolean) Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/ Uses codecov/codecov-action@v1 A secret is required for private repos. Configured with @codeCovTokenSecret. Default: false - codeCovTokenSecret (
string) Define the secret name for a specified https://codecov.io/ token A secret is required to send coverage for private repositories. Default: if this option is not specified, only public repositories are supported - copyrightOwner (
string) License copyright owner. Default: defaults to the value of authorName or "" ifauthorNameis undefined. - copyrightPeriod (
string) The copyright years to put in the LICENSE file. Default: current year - dependabot (
boolean) Use dependabot to handle dependency upgrades. Default: false - dependabotOptions (
github.DependabotOptions) Options for dependabot. Default: default options - depsUpgrade (
boolean) Use github workflows to handle dependency upgrades. Default: true - depsUpgradeOptions (
javascript.UpgradeDependenciesOptions) Options forUpgradeDependencies. Default: default options - gitignore (
Array) Additional entries to .gitignore. Optional - jest (
boolean) Setup jest unit tests. Default: true - jestOptions (
javascript.JestOptions) Jest options. Default: default options - mutableBuild (
boolean) Automatically update files modified during builds to pull-request branches. Default: true - npmignore (
Array) Additional entries to .npmignore. Optional - npmignoreEnabled (
boolean) Defines an .npmignore file. Normally this is only needed for libraries that are packaged as tarballs. Default: true - package (
boolean) Defines apackagetask that will produce an npm tarball under the artifacts directory (e.g.dist). Default: true - prettier (
boolean) Setup prettier. Default: false - prettierOptions (
javascript.PrettierOptions) Prettier options. Default: default options - projenDevDependency (
boolean) Indicates of "projen" should be installed as a devDependency. Default: true - projenrcJs (
boolean) Generate (once) .projenrc.js (in JavaScript). Set tofalsein order to disable .projenrc.js generation. Default: true if projenrcJson is false - projenrcJsOptions (
javascript.ProjenrcOptions) Options for .projenrc.js. Default: default options - projenVersion (
string) Version of projen to install. Default: Defaults to the latest version. - pullRequestTemplate (
boolean) Include a GitHub pull request template. Default: true - pullRequestTemplateContents (
Array) The contents of the pull request template. Default: default content - release (
boolean) Add release management to this project. Default: true (false for subprojects) - releaseToNpm (
boolean) Automatically release to npm when new versions are introduced. Default: false - releaseWorkflow (
boolean) DEPRECATED: renamed torelease. Default: true if not a subproject - workflowBootstrapSteps (
Array<github.workflows.JobStep>) Workflow steps to use in order to bootstrap this repo. Default: "yarn install --frozen-lockfile && yarn projen" - workflowGitIdentity (
github.GitIdentity) The git identity to use in workflows. Default: GitHub Actions - workflowNodeVersion (
string) The node version to use in GitHub workflows. Default: same asminNodeVersion - disableTsconfig (
boolean) Do not generate atsconfig.jsonfile (used by jsii projects since tsconfig.json is generated by the jsii compiler). Default: false - docgen (
boolean) Docgen by Typedoc. Default: false - docsDirectory (
string) Docs directory. Default: "docs" - entrypointTypes (
string) The .d.ts file that includes the type declarations for this module. Default: .d.ts file derived from the project's entrypoint (usually lib/index.d.ts) - eslint (
boolean) Setup eslint. Default: true - eslintOptions (
javascript.EslintOptions) Eslint options. Default: opinionated default options - libdir (
string) Typescript artifacts output directory. Default: "lib" - projenrcTs (
boolean) Use TypeScript for your projenrc file (.projenrc.ts). Default: false - projenrcTsOptions (
typescript.ProjenrcOptions) Options for .projenrc.ts. Optional - sampleCode (
boolean) Generate one-time sample insrc/andtest/if there are no files there. Default: true - srcdir (
string) Typescript sources directory. Default: "src" - testdir (
string) Jest tests directory. Tests files should be namedxxx.test.ts. Default: "test" - tsconfig (
javascript.TypescriptConfigOptions) Custom TSConfig. Default: default options - tsconfigDev (
javascript.TypescriptConfigOptions) Custom tsconfig options for the development tsconfig.json file (used for testing). Default: use the production tsconfig options - tsconfigDevFile (
string) The name of the development tsconfig.json file. Default: "tsconfig.dev.json" - typescriptVersion (
string) TypeScript version to use. Default: "latest"
- name (
| Name | Type | Description |
|---|---|---|
| npmConfig | javascript.NpmConfig |
TypeScript library.
Extends: typescript.TypeScriptProject
new TaimosTypescriptLibrary(options: TaimosTypescriptLibraryOptions)- options (
TaimosTypescriptLibraryOptions) No description- name (
string) This is the name of your project. - logging (
LoggerOptions) Configure logging options such as verbosity. Default: {} - outdir (
string) The root directory of the project. Default: "." - parent (
Project) The parent project, if this project is part of a bigger project. Optional - projenCommand (
string) The shell command to use in order to run the projen CLI. Default: "npx projen" - projenrcJson (
boolean) Generate (once) .projenrc.json (in JSON). Set tofalsein order to disable .projenrc.json generation. Default: false - projenrcJsonOptions (
ProjenrcOptions) Options for .projenrc.json. Default: default options - autoApproveOptions (
github.AutoApproveOptions) Enable and configure the 'auto approve' workflow. Default: auto approve is disabled - autoMerge (
boolean) Enable automatic merging on GitHub. Default: true - autoMergeOptions (
github.AutoMergeOptions) Configure options for automatic merging on GitHub. Default: see defaults inAutoMergeOptions - clobber (
boolean) Add aclobbertask which resets the repo to origin. Default: true - devContainer (
boolean) Add a VSCode development environment (used for GitHub Codespaces). Default: false - github (
boolean) Enable GitHub integration. Default: true - githubOptions (
github.GitHubOptions) Options for GitHub integration. Default: see GitHubOptions - gitpod (
boolean) Add a Gitpod development environment. Default: false - mergify (
boolean) Whether mergify should be enabled on this repository or not. Default: true - mergifyOptions (
github.MergifyOptions) Options for mergify. Default: default options - projectType (
ProjectType) Which type of project this is (library/app). Default: ProjectType.UNKNOWN - projenCredentials (
github.GithubCredentials) Choose a method of providing GitHub API access for projen workflows. Default: use a personal access token named PROJEN_GITHUB_TOKEN - projenTokenSecret (
string) The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows. Default: "PROJEN_GITHUB_TOKEN" - readme (
SampleReadmeProps) The README setup. Default: { filename: 'README.md', contents: '# replace this' } - stale (
boolean) Auto-close of stale issues and pull request. Default: false - staleOptions (
github.StaleOptions) Auto-close stale issues and pull requests. Default: see defaults inStaleOptions - vscode (
boolean) Enable VSCode integration. Default: true - allowLibraryDependencies (
boolean) Allow the project to includepeerDependenciesandbundledDependencies. Default: true - authorEmail (
string) Author's e-mail. Optional - authorName (
string) Author's name. Optional - authorOrganization (
boolean) Author's Organization. Optional - authorUrl (
string) Author's URL / Website. Optional - autoDetectBin (
boolean) Automatically add all executables under thebindirectory to yourpackage.jsonfile under thebinsection. Default: true - bin (
Map<string, string>) Binary programs vended with your module. Optional - bugsEmail (
string) The email address to which issues should be reported. Optional - bugsUrl (
string) The url to your project's issue tracker. Optional - bundledDeps (
Array) List of dependencies to bundle into this module. Optional - codeArtifactOptions (
javascript.CodeArtifactOptions) Options for npm packages using AWS CodeArtifact. Default: undefined - deps (
Array) Runtime dependencies of this module. Default: [] - description (
string) The description is just a string that helps people understand the purpose of the package. Optional - devDeps (
Array) Build dependencies for this module. Default: [] - entrypoint (
string) Module entrypoint (maininpackage.json). Default: "lib/index.js" - homepage (
string) Package's Homepage / Website. Optional - keywords (
Array) Keywords to include inpackage.json. Optional - license (
string) License's SPDX identifier. Default: "Apache-2.0" - licensed (
boolean) Indicates if a license should be added. Default: true - maxNodeVersion (
string) Minimum node.js version to require viaengines(inclusive). Default: no max - minNodeVersion (
string) Minimum Node.js version to require via package.jsonengines(inclusive). Default: no "engines" specified - npmAccess (
javascript.NpmAccess) Access level of the npm package. Default: for scoped packages (e.g.foo@bar), the default isNpmAccess.RESTRICTED, for non-scoped packages, the default isNpmAccess.PUBLIC. - npmRegistry (
string) The host name of the npm registry to publish to. Optional - npmRegistryUrl (
string) The base URL of the npm package registry. Default: "https://registry.npmjs.org" - npmTokenSecret (
string) GitHub secret which contains the NPM token to use when publishing packages. Default: "NPM_TOKEN" - packageManager (
javascript.NodePackageManager) The Node Package Manager used to execute scripts. Default: NodePackageManager.YARN - packageName (
string) The "name" in package.json. Default: defaults to project name - peerDependencyOptions (
javascript.PeerDependencyOptions) Options forpeerDeps. Optional - peerDeps (
Array) Peer dependencies for this module. Default: [] - repository (
string) The repository is the location where the actual code for your package lives. Optional - repositoryDirectory (
string) If the package.json for your package is not in the root directory (for example if it is part of a monorepo), you can specify the directory in which it lives. Optional - scopedPackagesOptions (
Array<javascript.ScopedPackagesOptions>) Options for privately hosted scoped packages. Default: fetch all scoped packages from the public npm registry - scripts (
Map<string, string>) npm scripts to include. Default: {} - stability (
string) Package's Stability. Optional - jsiiReleaseVersion (
string) Version requirement ofpublibwhich is used to publish modules to npm. Default: "latest" - majorVersion (
number) Major version to release from the default branch. Default: Major version is not enforced. - npmDistTag (
string) The npmDistTag to use when publishing from the default branch. Default: "latest" - postBuildSteps (
Array<github.workflows.JobStep>) Steps to execute after build as part of the release workflow. Default: [] - prerelease (
string) Bump versions from the default branch as pre-releases (e.g. "beta", "alpha", "pre"). Default: normal semantic versions - publishDryRun (
boolean) Instead of actually publishing to package managers, just print the publishing command. Default: false - publishTasks (
boolean) Define publishing tasks that can be executed manually as well as workflows. Default: false - releaseBranches (
Map<string, release.BranchOptions>) Defines additional release branches. Default: no additional branches are used for release. you can useaddBranch()to add additional branches. - releaseEveryCommit (
boolean) Automatically release new versions every commit to one of branches inreleaseBranches. Default: true - releaseFailureIssue (
boolean) Create a github issue on every failed publishing task. Default: false - releaseFailureIssueLabel (
string) The label to apply to issues indicating publish failures. Default: "failed-release" - releaseSchedule (
string) CRON schedule to trigger new releases. Default: no scheduled releases - releaseTagPrefix (
string) Automatically add the given prefix to release tags. Useful if you are releasing on multiple branches with overlapping version numbers. Default: no prefix - releaseTrigger (
release.ReleaseTrigger) The release trigger to use. Default: Continuous releases (ReleaseTrigger.continuous()) - releaseWorkflowName (
string) The name of the default release workflow. Default: "Release" - releaseWorkflowSetupSteps (
Array<github.workflows.JobStep>) A set of workflow steps to execute in order to setup the workflow container. Optional - versionrcOptions (
Map<string, any>) Custom configuration used when creating changelog with standard-version package. Default: standard configuration applicable for GitHub repositories - workflowContainerImage (
string) Container image to use for GitHub workflows. Default: default image - workflowRunsOn (
Array) Github Runner selection labels. Default: ["ubuntu-latest"] - defaultReleaseBranch (
string) The name of the main release branch. - artifactsDirectory (
string) A directory which will contain build artifacts. Default: "dist" - autoApproveUpgrades (
boolean) Automatically approve deps upgrade PRs, allowing them to be merged by mergify (if configued). Default: true - buildWorkflow (
boolean) Define a GitHub workflow for building PRs. Default: true if not a subproject - buildWorkflowTriggers (
github.workflows.Triggers) Build workflow triggers. Default: "{ pullRequest: {}, workflowDispatch: {} }" - bundlerOptions (
javascript.BundlerOptions) Options forBundler. Optional - codeCov (
boolean) Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/ Uses codecov/codecov-action@v1 A secret is required for private repos. Configured with @codeCovTokenSecret. Default: false - codeCovTokenSecret (
string) Define the secret name for a specified https://codecov.io/ token A secret is required to send coverage for private repositories. Default: if this option is not specified, only public repositories are supported - copyrightOwner (
string) License copyright owner. Default: defaults to the value of authorName or "" ifauthorNameis undefined. - copyrightPeriod (
string) The copyright years to put in the LICENSE file. Default: current year - dependabot (
boolean) Use dependabot to handle dependency upgrades. Default: false - dependabotOptions (
github.DependabotOptions) Options for dependabot. Default: default options - depsUpgrade (
boolean) Use github workflows to handle dependency upgrades. Default: true - depsUpgradeOptions (
javascript.UpgradeDependenciesOptions) Options forUpgradeDependencies. Default: default options - gitignore (
Array) Additional entries to .gitignore. Optional - jest (
boolean) Setup jest unit tests. Default: true - jestOptions (
javascript.JestOptions) Jest options. Default: default options - mutableBuild (
boolean) Automatically update files modified during builds to pull-request branches. Default: true - npmignore (
Array) Additional entries to .npmignore. Optional - npmignoreEnabled (
boolean) Defines an .npmignore file. Normally this is only needed for libraries that are packaged as tarballs. Default: true - package (
boolean) Defines apackagetask that will produce an npm tarball under the artifacts directory (e.g.dist). Default: true - prettier (
boolean) Setup prettier. Default: false - prettierOptions (
javascript.PrettierOptions) Prettier options. Default: default options - projenDevDependency (
boolean) Indicates of "projen" should be installed as a devDependency. Default: true - projenrcJs (
boolean) Generate (once) .projenrc.js (in JavaScript). Set tofalsein order to disable .projenrc.js generation. Default: true if projenrcJson is false - projenrcJsOptions (
javascript.ProjenrcOptions) Options for .projenrc.js. Default: default options - projenVersion (
string) Version of projen to install. Default: Defaults to the latest version. - pullRequestTemplate (
boolean) Include a GitHub pull request template. Default: true - pullRequestTemplateContents (
Array) The contents of the pull request template. Default: default content - release (
boolean) Add release management to this project. Default: true (false for subprojects) - releaseToNpm (
boolean) Automatically release to npm when new versions are introduced. Default: false - releaseWorkflow (
boolean) DEPRECATED: renamed torelease. Default: true if not a subproject - workflowBootstrapSteps (
Array<github.workflows.JobStep>) Workflow steps to use in order to bootstrap this repo. Default: "yarn install --frozen-lockfile && yarn projen" - workflowGitIdentity (
github.GitIdentity) The git identity to use in workflows. Default: GitHub Actions - workflowNodeVersion (
string) The node version to use in GitHub workflows. Default: same asminNodeVersion - disableTsconfig (
boolean) Do not generate atsconfig.jsonfile (used by jsii projects since tsconfig.json is generated by the jsii compiler). Default: false - docgen (
boolean) Docgen by Typedoc. Default: false - docsDirectory (
string) Docs directory. Default: "docs" - entrypointTypes (
string) The .d.ts file that includes the type declarations for this module. Default: .d.ts file derived from the project's entrypoint (usually lib/index.d.ts) - eslint (
boolean) Setup eslint. Default: true - eslintOptions (
javascript.EslintOptions) Eslint options. Default: opinionated default options - libdir (
string) Typescript artifacts output directory. Default: "lib" - projenrcTs (
boolean) Use TypeScript for your projenrc file (.projenrc.ts). Default: false - projenrcTsOptions (
typescript.ProjenrcOptions) Options for .projenrc.ts. Optional - sampleCode (
boolean) Generate one-time sample insrc/andtest/if there are no files there. Default: true - srcdir (
string) Typescript sources directory. Default: "src" - testdir (
string) Jest tests directory. Tests files should be namedxxx.test.ts. Default: "test" - tsconfig (
javascript.TypescriptConfigOptions) Custom TSConfig. Default: default options - tsconfigDev (
javascript.TypescriptConfigOptions) Custom tsconfig options for the development tsconfig.json file (used for testing). Default: use the production tsconfig options - tsconfigDevFile (
string) The name of the development tsconfig.json file. Default: "tsconfig.dev.json" - typescriptVersion (
string) TypeScript version to use. Default: "latest"
- name (
| Name | Type | Description |
|---|---|---|
| cdkVersion๐น | string |
Minimum version of the AWS CDK to depend on. |
| defaultReleaseBranch๐น | string |
The name of the main release branch. |
| name๐น | string |
This is the name of your project. |
| allowLibraryDependencies?๐น | boolean |
Allow the project to include peerDependencies and bundledDependencies.Default: true |
| appEntrypoint?๐น | string |
The CDK app's entrypoint (relative to the source directory, which is "src" by default). Default: "main.ts" |
| artifactsDirectory?๐น | string |
A directory which will contain build artifacts. Default: "dist" |
| authorEmail?๐น | string |
Author's e-mail. Optional |
| authorName?๐น | string |
Author's name. Optional |
| authorOrganization?๐น | boolean |
Author's Organization. Optional |
| authorUrl?๐น | string |
Author's URL / Website. Optional |
| autoApproveOptions?๐น | github.AutoApproveOptions |
Enable and configure the 'auto approve' workflow. Default: auto approve is disabled |
| autoApproveUpgrades?๐น | boolean |
Automatically approve deps upgrade PRs, allowing them to be merged by mergify (if configued). Default: true |
| autoDetectBin?๐น | boolean |
Automatically add all executables under the bin directory to your package.json file under the bin section.Default: true |
| autoMerge?๐น | boolean |
Enable automatic merging on GitHub. Default: true |
| autoMergeOptions?๐น | github.AutoMergeOptions |
Configure options for automatic merging on GitHub. Default: see defaults in AutoMergeOptions |
| bin?๐น | Map<string, string> |
Binary programs vended with your module. Optional |
| bugsEmail?๐น | string |
The email address to which issues should be reported. Optional |
| bugsUrl?๐น | string |
The url to your project's issue tracker. Optional |
| buildCommand?๐น | string |
A command to execute before synthesis. Default: no build command |
| buildWorkflow?๐น | boolean |
Define a GitHub workflow for building PRs. Default: true if not a subproject |
| buildWorkflowTriggers?๐น | github.workflows.Triggers |
Build workflow triggers. Default: "{ pullRequest: {}, workflowDispatch: {} }" |
| bundledDeps?๐น | Array |
List of dependencies to bundle into this module. Optional |
| bundlerOptions?๐น | javascript.BundlerOptions |
Options for Bundler.Optional |
| cdkAssert? |
boolean |
Warning: NodeJS only. Default: will be included by default for AWS CDK >= 1.0.0 < 2.0.0 |
| cdkAssertions?๐น | boolean |
Install the assertions library? Default: will be included by default for AWS CDK >= 1.111.0 < 2.0.0 |
| cdkDependencies? |
Array |
Which AWS CDKv1 modules this project requires. Optional |
| cdkDependenciesAsDeps? |
boolean |
If this is enabled (default), all modules declared in cdkDependencies will be also added as normal dependencies (as well as peerDependencies).Default: true |
| cdkPipelines? | boolean |
Enable CDK pipelines. Default: false |
| cdkTestDependencies? |
Array |
AWS CDK modules required for testing. Optional |
| cdkVersionPinning?๐น | boolean |
Use pinned version instead of caret version for CDK. Optional |
| cdkout?๐น | string |
cdk.out directory. Default: "cdk.out" |
| clobber?๐น | boolean |
Add a clobber task which resets the repo to origin.Default: true |
| codeArtifactOptions?๐น | javascript.CodeArtifactOptions |
Options for npm packages using AWS CodeArtifact. Default: undefined |
| codeCov?๐น | boolean |
Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/ Uses codecov/codecov-action@v1 A secret is required for private repos. Configured with @codeCovTokenSecret. Default: false |
| codeCovTokenSecret?๐น | string |
Define the secret name for a specified https://codecov.io/ token A secret is required to send coverage for private repositories. Default: if this option is not specified, only public repositories are supported |
| constructsVersion?๐น | string |
Minimum version of the constructs library to depend on.Default: for CDK 1.x the default is "3.2.27", for CDK 2.x the default is "10.0.5". |
| context?๐น | Map<string, any> |
Additional context to include in cdk.json.Default: no additional context |
| copyrightOwner?๐น | string |
License copyright owner. Default: defaults to the value of authorName or "" if authorName is undefined. |
| copyrightPeriod?๐น | string |
The copyright years to put in the LICENSE file. Default: current year |
| dependabot?๐น | boolean |
Use dependabot to handle dependency upgrades. Default: false |
| dependabotOptions?๐น | github.DependabotOptions |
Options for dependabot. Default: default options |
| deps?๐น | Array |
Runtime dependencies of this module. Default: [] |
| depsUpgrade?๐น | boolean |
Use github workflows to handle dependency upgrades. Default: true |
| depsUpgradeOptions?๐น | javascript.UpgradeDependenciesOptions |
Options for UpgradeDependencies.Default: default options |
| description?๐น | string |
The description is just a string that helps people understand the purpose of the package. Optional |
| devContainer?๐น | boolean |
Add a VSCode development environment (used for GitHub Codespaces). Default: false |
| devDeps?๐น | Array |
Build dependencies for this module. Default: [] |
| disableTsconfig?๐น | boolean |
Do not generate a tsconfig.json file (used by jsii projects since tsconfig.json is generated by the jsii compiler).Default: false |
| docgen?๐น | boolean |
Docgen by Typedoc. Default: false |
| docsDirectory?๐น | string |
Docs directory. Default: "docs" |
| entrypoint?๐น | string |
Module entrypoint (main in package.json).Default: "lib/index.js" |
| entrypointTypes?๐น | string |
The .d.ts file that includes the type declarations for this module. Default: .d.ts file derived from the project's entrypoint (usually lib/index.d.ts) |
| eslint?๐น | boolean |
Setup eslint. Default: true |
| eslintOptions?๐น | javascript.EslintOptions |
Eslint options. Default: opinionated default options |
| featureFlags?๐น | boolean |
Include all feature flags in cdk.json. Default: true |
| github?๐น | boolean |
Enable GitHub integration. Default: true |
| githubOptions?๐น | github.GitHubOptions |
Options for GitHub integration. Default: see GitHubOptions |
| gitignore?๐น | Array |
Additional entries to .gitignore. Optional |
| gitpod?๐น | boolean |
Add a Gitpod development environment. Default: false |
| homepage?๐น | string |
Package's Homepage / Website. Optional |
| integrationTestAutoDiscover?๐น | boolean |
Automatically discovers and creates integration tests for each .integ.ts file in under your test directory.Default: true |
| jest?๐น | boolean |
Setup jest unit tests. Default: true |
| jestOptions?๐น | javascript.JestOptions |
Jest options. Default: default options |
| jsiiReleaseVersion?๐น | string |
Version requirement of publib which is used to publish modules to npm.Default: "latest" |
| keywords?๐น | Array |
Keywords to include in package.json.Optional |
| lambdaAutoDiscover?๐น | boolean |
Automatically adds an awscdk.LambdaFunction for each .lambda.ts handler in your source tree. If this is disabled, you can manually add an awscdk.AutoDiscover component to your project.Default: true |
| lambdaExtensionAutoDiscover?๐น | boolean |
Automatically adds an awscdk.LambdaExtension for each .lambda-extension.ts entrypoint in your source tree. If this is disabled, you can manually add an awscdk.AutoDiscover component to your project.Default: true |
| lambdaOptions?๐น | awscdk.LambdaFunctionCommonOptions |
Common options for all AWS Lambda functions. Default: default options |
| libdir?๐น | string |
Typescript artifacts output directory. Default: "lib" |
| license?๐น | string |
License's SPDX identifier. Default: "Apache-2.0" |
| licensed?๐น | boolean |
Indicates if a license should be added. Default: true |
| logging?๐น | LoggerOptions |
Configure logging options such as verbosity. Default: {} |
| majorVersion?๐น | number |
Major version to release from the default branch. Default: Major version is not enforced. |
| maxNodeVersion?๐น | string |
Minimum node.js version to require via engines (inclusive).Default: no max |
| mergify? |
boolean |
Whether mergify should be enabled on this repository or not. Default: true |
| mergifyOptions? |
github.MergifyOptions |
Options for mergify. Default: default options |
| minNodeVersion?๐น | string |
Minimum Node.js version to require via package.json engines (inclusive).Default: no "engines" specified |
| mutableBuild?๐น | boolean |
Automatically update files modified during builds to pull-request branches. Default: true |
| npmAccess?๐น | javascript.NpmAccess |
Access level of the npm package. Default: for scoped packages (e.g. foo@bar), the default is NpmAccess.RESTRICTED, for non-scoped packages, the default is NpmAccess.PUBLIC. |
| npmDistTag?๐น | string |
The npmDistTag to use when publishing from the default branch. Default: "latest" |
| npmRegistry? |
string |
The host name of the npm registry to publish to. Optional |
| npmRegistryUrl?๐น | string |
The base URL of the npm package registry. Default: "https://registry.npmjs.org" |
| npmTokenSecret?๐น | string |
GitHub secret which contains the NPM token to use when publishing packages. Default: "NPM_TOKEN" |
| npmignore? |
Array |
Additional entries to .npmignore. Optional |
| npmignoreEnabled?๐น | boolean |
Defines an .npmignore file. Normally this is only needed for libraries that are packaged as tarballs. Default: true |
| outdir?๐น | string |
The root directory of the project. Default: "." |
| package?๐น | boolean |
Defines a package task that will produce an npm tarball under the artifacts directory (e.g. dist).Default: true |
| packageManager?๐น | javascript.NodePackageManager |
The Node Package Manager used to execute scripts. Default: NodePackageManager.YARN |
| packageName?๐น | string |
The "name" in package.json. Default: defaults to project name |
| parent?๐น | Project |
The parent project, if this project is part of a bigger project. Optional |
| peerDependencyOptions?๐น | javascript.PeerDependencyOptions |
Options for peerDeps.Optional |
| peerDeps?๐น | Array |
Peer dependencies for this module. Default: [] |
| postBuildSteps?๐น | Array<github.workflows.JobStep> |
Steps to execute after build as part of the release workflow. Default: [] |
| prerelease?๐น | string |
Bump versions from the default branch as pre-releases (e.g. "beta", "alpha", "pre"). Default: normal semantic versions |
| prettier?๐น | boolean |
Setup prettier. Default: false |
| prettierOptions?๐น | javascript.PrettierOptions |
Prettier options. Default: default options |
| projectType? |
ProjectType |
Which type of project this is (library/app). Default: ProjectType.UNKNOWN |
| projenCommand?๐น | string |
The shell command to use in order to run the projen CLI. Default: "npx projen" |
| projenCredentials?๐น | github.GithubCredentials |
Choose a method of providing GitHub API access for projen workflows. Default: use a personal access token named PROJEN_GITHUB_TOKEN |
| projenDevDependency?๐น | boolean |
Indicates of "projen" should be installed as a devDependency. Default: true |
| projenTokenSecret? |
string |
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows. Default: "PROJEN_GITHUB_TOKEN" |
| projenVersion?๐น | string |
Version of projen to install. Default: Defaults to the latest version. |
| projenrcJs?๐น | boolean |
Generate (once) .projenrc.js (in JavaScript). Set to false in order to disable .projenrc.js generation.Default: true if projenrcJson is false |
| projenrcJsOptions?๐น | javascript.ProjenrcOptions |
Options for .projenrc.js. Default: default options |
| projenrcJson?๐น | boolean |
Generate (once) .projenrc.json (in JSON). Set to false in order to disable .projenrc.json generation.Default: false |
| projenrcJsonOptions?๐น | ProjenrcOptions |
Options for .projenrc.json. Default: default options |
| projenrcTs?๐น | boolean |
Use TypeScript for your projenrc file (.projenrc.ts).Default: false |
| projenrcTsOptions?๐น | typescript.ProjenrcOptions |
Options for .projenrc.ts. Optional |
| publishDryRun?๐น | boolean |
Instead of actually publishing to package managers, just print the publishing command. Default: false |
| publishTasks?๐น | boolean |
Define publishing tasks that can be executed manually as well as workflows. Default: false |
| pullRequestTemplate?๐น | boolean |
Include a GitHub pull request template. Default: true |
| pullRequestTemplateContents?๐น | Array |
The contents of the pull request template. Default: default content |
| readme?๐น | SampleReadmeProps |
The README setup. Default: { filename: 'README.md', contents: '# replace this' } |
| release?๐น | boolean |
Add release management to this project. Default: true (false for subprojects) |
| releaseBranches?๐น | Map<string, release.BranchOptions> |
Defines additional release branches. Default: no additional branches are used for release. you can use addBranch() to add additional branches. |
| releaseEveryCommit? |
boolean |
Automatically release new versions every commit to one of branches in releaseBranches.Default: true |
| releaseFailureIssue?๐น | boolean |
Create a github issue on every failed publishing task. Default: false |
| releaseFailureIssueLabel?๐น | string |
The label to apply to issues indicating publish failures. Default: "failed-release" |
| releaseSchedule? |
string |
CRON schedule to trigger new releases. Default: no scheduled releases |
| releaseTagPrefix?๐น | string |
Automatically add the given prefix to release tags. Useful if you are releasing on multiple branches with overlapping version numbers. Default: no prefix |
| releaseToNpm?๐น | boolean |
Automatically release to npm when new versions are introduced. Default: false |
| releaseTrigger?๐น | release.ReleaseTrigger |
The release trigger to use. Default: Continuous releases ( ReleaseTrigger.continuous()) |
| releaseWorkflow? |
boolean |
DEPRECATED: renamed to release.Default: true if not a subproject |
| releaseWorkflowName?๐น | string |
The name of the default release workflow. Default: "Release" |
| releaseWorkflowSetupSteps?๐น | Array<github.workflows.JobStep> |
A set of workflow steps to execute in order to setup the workflow container. Optional |
| repository?๐น | string |
The repository is the location where the actual code for your package lives. Optional |
| repositoryDirectory?๐น | string |
If the package.json for your package is not in the root directory (for example if it is part of a monorepo), you can specify the directory in which it lives. Optional |
| requireApproval?๐น | awscdk.ApprovalLevel |
To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them. Default: ApprovalLevel.BROADENING |
| sampleCode?๐น | boolean |
Generate one-time sample in src/ and test/ if there are no files there.Default: true |
| scopedPackagesOptions?๐น | Array<javascript.ScopedPackagesOptions> |
Options for privately hosted scoped packages. Default: fetch all scoped packages from the public npm registry |
| scripts?๐น | Map<string, string> |
npm scripts to include. Default: {} |
| sops? | SopsAspectOptions |
Enable storing secrets using Mozilla SOPS. Default: no SOPS config |
| srcdir?๐น | string |
Typescript sources directory. Default: "src" |
| stability?๐น | string |
Package's Stability. Optional |
| stale?๐น | boolean |
Auto-close of stale issues and pull request. Default: false |
| staleOptions?๐น | github.StaleOptions |
Auto-close stale issues and pull requests. Default: see defaults in StaleOptions |
| testdir?๐น | string |
Jest tests directory. Tests files should be named xxx.test.ts.Default: "test" |
| tsconfig?๐น | javascript.TypescriptConfigOptions |
Custom TSConfig. Default: default options |
| tsconfigDev?๐น | javascript.TypescriptConfigOptions |
Custom tsconfig options for the development tsconfig.json file (used for testing). Default: use the production tsconfig options |
| tsconfigDevFile?๐น | string |
The name of the development tsconfig.json file. Default: "tsconfig.dev.json" |
| typescriptVersion?๐น | string |
TypeScript version to use. Default: "latest" |
| versionrcOptions?๐น | Map<string, any> |
Custom configuration used when creating changelog with standard-version package. Default: standard configuration applicable for GitHub repositories |
| vscode?๐น | boolean |
Enable VSCode integration. Default: true |
| watchExcludes?๐น | Array |
Glob patterns to exclude from cdk watch.Default: [] |
| watchIncludes?๐น | Array |
Glob patterns to include in cdk watch.Default: [] |
| workflowBootstrapSteps?๐น | Array<github.workflows.JobStep> |
Workflow steps to use in order to bootstrap this repo. Default: "yarn install --frozen-lockfile && yarn projen" |
| workflowContainerImage?๐น | string |
Container image to use for GitHub workflows. Default: default image |
| workflowGitIdentity?๐น | github.GitIdentity |
The git identity to use in workflows. Default: GitHub Actions |
| workflowNodeVersion?๐น | string |
The node version to use in GitHub workflows. Default: same as minNodeVersion |
| workflowRunsOn?๐น | Array |
Github Runner selection labels. Default: ["ubuntu-latest"] |
| Name | Type | Description |
|---|---|---|
| secrets | Map<string, string> |
Define a mapping of SOPS files to SecretsManager secrets. |
| Name | Type | Description |
|---|---|---|
| cdkVersion๐น | string |
Minimum version of the AWS CDK to depend on. |
| defaultReleaseBranch๐น | string |
The name of the main release branch. |
| name๐น | string |
This is the name of your project. |
| allowLibraryDependencies?๐น | boolean |
Allow the project to include peerDependencies and bundledDependencies.Default: true |
| appEntrypoint?๐น | string |
The CDK app's entrypoint (relative to the source directory, which is "src" by default). Default: "main.ts" |
| artifactsDirectory?๐น | string |
A directory which will contain build artifacts. Default: "dist" |
| authorEmail?๐น | string |
Author's e-mail. Optional |
| authorName?๐น | string |
Author's name. Optional |
| authorOrganization?๐น | boolean |
Author's Organization. Optional |
| authorUrl?๐น | string |
Author's URL / Website. Optional |
| autoApproveOptions?๐น | github.AutoApproveOptions |
Enable and configure the 'auto approve' workflow. Default: auto approve is disabled |
| autoApproveUpgrades?๐น | boolean |
Automatically approve deps upgrade PRs, allowing them to be merged by mergify (if configued). Default: true |
| autoDetectBin?๐น | boolean |
Automatically add all executables under the bin directory to your package.json file under the bin section.Default: true |
| autoMerge?๐น | boolean |
Enable automatic merging on GitHub. Default: true |
| autoMergeOptions?๐น | github.AutoMergeOptions |
Configure options for automatic merging on GitHub. Default: see defaults in AutoMergeOptions |
| bin?๐น | Map<string, string> |
Binary programs vended with your module. Optional |
| bugsEmail?๐น | string |
The email address to which issues should be reported. Optional |
| bugsUrl?๐น | string |
The url to your project's issue tracker. Optional |
| buildCommand?๐น | string |
A command to execute before synthesis. Default: no build command |
| buildWorkflow?๐น | boolean |
Define a GitHub workflow for building PRs. Default: true if not a subproject |
| buildWorkflowTriggers?๐น | github.workflows.Triggers |
Build workflow triggers. Default: "{ pullRequest: {}, workflowDispatch: {} }" |
| bundledDeps?๐น | Array |
List of dependencies to bundle into this module. Optional |
| bundlerOptions?๐น | javascript.BundlerOptions |
Options for Bundler.Optional |
| cdkAssert? |
boolean |
Warning: NodeJS only. Default: will be included by default for AWS CDK >= 1.0.0 < 2.0.0 |
| cdkAssertions?๐น | boolean |
Install the assertions library? Default: will be included by default for AWS CDK >= 1.111.0 < 2.0.0 |
| cdkDependencies? |
Array |
Which AWS CDKv1 modules this project requires. Optional |
| cdkDependenciesAsDeps? |
boolean |
If this is enabled (default), all modules declared in cdkDependencies will be also added as normal dependencies (as well as peerDependencies).Default: true |
| cdkPipelines? | boolean |
Enable CDK pipelines. Default: false |
| cdkTestDependencies? |
Array |
AWS CDK modules required for testing. Optional |
| cdkVersionPinning?๐น | boolean |
Use pinned version instead of caret version for CDK. Optional |
| cdkout?๐น | string |
cdk.out directory. Default: "cdk.out" |
| clobber?๐น | boolean |
Add a clobber task which resets the repo to origin.Default: true |
| codeArtifactOptions?๐น | javascript.CodeArtifactOptions |
Options for npm packages using AWS CodeArtifact. Default: undefined |
| codeCov?๐น | boolean |
Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/ Uses codecov/codecov-action@v1 A secret is required for private repos. Configured with @codeCovTokenSecret. Default: false |
| codeCovTokenSecret?๐น | string |
Define the secret name for a specified https://codecov.io/ token A secret is required to send coverage for private repositories. Default: if this option is not specified, only public repositories are supported |
| constructsVersion?๐น | string |
Minimum version of the constructs library to depend on.Default: for CDK 1.x the default is "3.2.27", for CDK 2.x the default is "10.0.5". |
| context?๐น | Map<string, any> |
Additional context to include in cdk.json.Default: no additional context |
| copyrightOwner?๐น | string |
License copyright owner. Default: defaults to the value of authorName or "" if authorName is undefined. |
| copyrightPeriod?๐น | string |
The copyright years to put in the LICENSE file. Default: current year |
| dependabot?๐น | boolean |
Use dependabot to handle dependency upgrades. Default: false |
| dependabotOptions?๐น | github.DependabotOptions |
Options for dependabot. Default: default options |
| deps?๐น | Array |
Runtime dependencies of this module. Default: [] |
| depsUpgrade?๐น | boolean |
Use github workflows to handle dependency upgrades. Default: true |
| depsUpgradeOptions?๐น | javascript.UpgradeDependenciesOptions |
Options for UpgradeDependencies.Default: default options |
| description?๐น | string |
The description is just a string that helps people understand the purpose of the package. Optional |
| devContainer?๐น | boolean |
Add a VSCode development environment (used for GitHub Codespaces). Default: false |
| devDeps?๐น | Array |
Build dependencies for this module. Default: [] |
| disableTsconfig?๐น | boolean |
Do not generate a tsconfig.json file (used by jsii projects since tsconfig.json is generated by the jsii compiler).Default: false |
| docgen?๐น | boolean |
Docgen by Typedoc. Default: false |
| docsDirectory?๐น | string |
Docs directory. Default: "docs" |
| entrypoint?๐น | string |
Module entrypoint (main in package.json).Default: "lib/index.js" |
| entrypointTypes?๐น | string |
The .d.ts file that includes the type declarations for this module. Default: .d.ts file derived from the project's entrypoint (usually lib/index.d.ts) |
| eslint?๐น | boolean |
Setup eslint. Default: true |
| eslintOptions?๐น | javascript.EslintOptions |
Eslint options. Default: opinionated default options |
| featureFlags?๐น | boolean |
Include all feature flags in cdk.json. Default: true |
| github?๐น | boolean |
Enable GitHub integration. Default: true |
| githubOptions?๐น | github.GitHubOptions |
Options for GitHub integration. Default: see GitHubOptions |
| gitignore?๐น | Array |
Additional entries to .gitignore. Optional |
| gitpod?๐น | boolean |
Add a Gitpod development environment. Default: false |
| homepage?๐น | string |
Package's Homepage / Website. Optional |
| integrationTestAutoDiscover?๐น | boolean |
Automatically discovers and creates integration tests for each .integ.ts file in under your test directory.Default: true |
| jest?๐น | boolean |
Setup jest unit tests. Default: true |
| jestOptions?๐น | javascript.JestOptions |
Jest options. Default: default options |
| jsiiReleaseVersion?๐น | string |
Version requirement of publib which is used to publish modules to npm.Default: "latest" |
| keywords?๐น | Array |
Keywords to include in package.json.Optional |
| lambdaAutoDiscover?๐น | boolean |
Automatically adds an awscdk.LambdaFunction for each .lambda.ts handler in your source tree. If this is disabled, you can manually add an awscdk.AutoDiscover component to your project.Default: true |
| lambdaExtensionAutoDiscover?๐น | boolean |
Automatically adds an awscdk.LambdaExtension for each .lambda-extension.ts entrypoint in your source tree. If this is disabled, you can manually add an awscdk.AutoDiscover component to your project.Default: true |
| lambdaOptions?๐น | awscdk.LambdaFunctionCommonOptions |
Common options for all AWS Lambda functions. Default: default options |
| libdir?๐น | string |
Typescript artifacts output directory. Default: "lib" |
| license?๐น | string |
License's SPDX identifier. Default: "Apache-2.0" |
| licensed?๐น | boolean |
Indicates if a license should be added. Default: true |
| logging?๐น | LoggerOptions |
Configure logging options such as verbosity. Default: {} |
| majorVersion?๐น | number |
Major version to release from the default branch. Default: Major version is not enforced. |
| maxNodeVersion?๐น | string |
Minimum node.js version to require via engines (inclusive).Default: no max |
| mergify? |
boolean |
Whether mergify should be enabled on this repository or not. Default: true |
| mergifyOptions? |
github.MergifyOptions |
Options for mergify. Default: default options |
| minNodeVersion?๐น | string |
Minimum Node.js version to require via package.json engines (inclusive).Default: no "engines" specified |
| mutableBuild?๐น | boolean |
Automatically update files modified during builds to pull-request branches. Default: true |
| npmAccess?๐น | javascript.NpmAccess |
Access level of the npm package. Default: for scoped packages (e.g. foo@bar), the default is NpmAccess.RESTRICTED, for non-scoped packages, the default is NpmAccess.PUBLIC. |
| npmDistTag?๐น | string |
The npmDistTag to use when publishing from the default branch. Default: "latest" |
| npmRegistry? |
string |
The host name of the npm registry to publish to. Optional |
| npmRegistryUrl?๐น | string |
The base URL of the npm package registry. Default: "https://registry.npmjs.org" |
| npmTokenSecret?๐น | string |
GitHub secret which contains the NPM token to use when publishing packages. Default: "NPM_TOKEN" |
| npmignore? |
Array |
Additional entries to .npmignore. Optional |
| npmignoreEnabled?๐น | boolean |
Defines an .npmignore file. Normally this is only needed for libraries that are packaged as tarballs. Default: true |
| outdir?๐น | string |
The root directory of the project. Default: "." |
| package?๐น | boolean |
Defines a package task that will produce an npm tarball under the artifacts directory (e.g. dist).Default: true |
| packageManager?๐น | javascript.NodePackageManager |
The Node Package Manager used to execute scripts. Default: NodePackageManager.YARN |
| packageName?๐น | string |
The "name" in package.json. Default: defaults to project name |
| parent?๐น | Project |
The parent project, if this project is part of a bigger project. Optional |
| peerDependencyOptions?๐น | javascript.PeerDependencyOptions |
Options for peerDeps.Optional |
| peerDeps?๐น | Array |
Peer dependencies for this module. Default: [] |
| postBuildSteps?๐น | Array<github.workflows.JobStep> |
Steps to execute after build as part of the release workflow. Default: [] |
| prerelease?๐น | string |
Bump versions from the default branch as pre-releases (e.g. "beta", "alpha", "pre"). Default: normal semantic versions |
| prettier?๐น | boolean |
Setup prettier. Default: false |
| prettierOptions?๐น | javascript.PrettierOptions |
Prettier options. Default: default options |
| projectType? |
ProjectType |
Which type of project this is (library/app). Default: ProjectType.UNKNOWN |
| projenCommand?๐น | string |
The shell command to use in order to run the projen CLI. Default: "npx projen" |
| projenCredentials?๐น | github.GithubCredentials |
Choose a method of providing GitHub API access for projen workflows. Default: use a personal access token named PROJEN_GITHUB_TOKEN |
| projenDevDependency?๐น | boolean |
Indicates of "projen" should be installed as a devDependency. Default: true |
| projenTokenSecret? |
string |
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows. Default: "PROJEN_GITHUB_TOKEN" |
| projenVersion?๐น | string |
Version of projen to install. Default: Defaults to the latest version. |
| projenrcJs?๐น | boolean |
Generate (once) .projenrc.js (in JavaScript). Set to false in order to disable .projenrc.js generation.Default: true if projenrcJson is false |
| projenrcJsOptions?๐น | javascript.ProjenrcOptions |
Options for .projenrc.js. Default: default options |
| projenrcJson?๐น | boolean |
Generate (once) .projenrc.json (in JSON). Set to false in order to disable .projenrc.json generation.Default: false |
| projenrcJsonOptions?๐น | ProjenrcOptions |
Options for .projenrc.json. Default: default options |
| projenrcTs?๐น | boolean |
Use TypeScript for your projenrc file (.projenrc.ts).Default: false |
| projenrcTsOptions?๐น | typescript.ProjenrcOptions |
Options for .projenrc.ts. Optional |
| publishDryRun?๐น | boolean |
Instead of actually publishing to package managers, just print the publishing command. Default: false |
| publishTasks?๐น | boolean |
Define publishing tasks that can be executed manually as well as workflows. Default: false |
| pullRequestTemplate?๐น | boolean |
Include a GitHub pull request template. Default: true |
| pullRequestTemplateContents?๐น | Array |
The contents of the pull request template. Default: default content |
| readme?๐น | SampleReadmeProps |
The README setup. Default: { filename: 'README.md', contents: '# replace this' } |
| release?๐น | boolean |
Add release management to this project. Default: true (false for subprojects) |
| releaseBranches?๐น | Map<string, release.BranchOptions> |
Defines additional release branches. Default: no additional branches are used for release. you can use addBranch() to add additional branches. |
| releaseEveryCommit? |
boolean |
Automatically release new versions every commit to one of branches in releaseBranches.Default: true |
| releaseFailureIssue?๐น | boolean |
Create a github issue on every failed publishing task. Default: false |
| releaseFailureIssueLabel?๐น | string |
The label to apply to issues indicating publish failures. Default: "failed-release" |
| releaseSchedule? |
string |
CRON schedule to trigger new releases. Default: no scheduled releases |
| releaseTagPrefix?๐น | string |
Automatically add the given prefix to release tags. Useful if you are releasing on multiple branches with overlapping version numbers. Default: no prefix |
| releaseToNpm?๐น | boolean |
Automatically release to npm when new versions are introduced. Default: false |
| releaseTrigger?๐น | release.ReleaseTrigger |
The release trigger to use. Default: Continuous releases ( ReleaseTrigger.continuous()) |
| releaseWorkflow? |
boolean |
DEPRECATED: renamed to release.Default: true if not a subproject |
| releaseWorkflowName?๐น | string |
The name of the default release workflow. Default: "Release" |
| releaseWorkflowSetupSteps?๐น | Array<github.workflows.JobStep> |
A set of workflow steps to execute in order to setup the workflow container. Optional |
| repository?๐น | string |
The repository is the location where the actual code for your package lives. Optional |
| repositoryDirectory?๐น | string |
If the package.json for your package is not in the root directory (for example if it is part of a monorepo), you can specify the directory in which it lives. Optional |
| requireApproval?๐น | awscdk.ApprovalLevel |
To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them. Default: ApprovalLevel.BROADENING |
| sampleCode?๐น | boolean |
Generate one-time sample in src/ and test/ if there are no files there.Default: true |
| scopedPackagesOptions?๐น | Array<javascript.ScopedPackagesOptions> |
Options for privately hosted scoped packages. Default: fetch all scoped packages from the public npm registry |
| scripts?๐น | Map<string, string> |
npm scripts to include. Default: {} |
| sops? | SopsAspectOptions |
Enable storing secrets using Mozilla SOPS. Default: no SOPS config |
| srcdir?๐น | string |
Typescript sources directory. Default: "src" |
| stability?๐น | string |
Package's Stability. Optional |
| stale?๐น | boolean |
Auto-close of stale issues and pull request. Default: false |
| staleOptions?๐น | github.StaleOptions |
Auto-close stale issues and pull requests. Default: see defaults in StaleOptions |
| testdir?๐น | string |
Jest tests directory. Tests files should be named xxx.test.ts.Default: "test" |
| tsconfig?๐น | javascript.TypescriptConfigOptions |
Custom TSConfig. Default: default options |
| tsconfigDev?๐น | javascript.TypescriptConfigOptions |
Custom tsconfig options for the development tsconfig.json file (used for testing). Default: use the production tsconfig options |
| tsconfigDevFile?๐น | string |
The name of the development tsconfig.json file. Default: "tsconfig.dev.json" |
| typescriptVersion?๐น | string |
TypeScript version to use. Default: "latest" |
| versionrcOptions?๐น | Map<string, any> |
Custom configuration used when creating changelog with standard-version package. Default: standard configuration applicable for GitHub repositories |
| vscode?๐น | boolean |
Enable VSCode integration. Default: true |
| watchExcludes?๐น | Array |
Glob patterns to exclude from cdk watch.Default: [] |
| watchIncludes?๐น | Array |
Glob patterns to include in cdk watch.Default: [] |
| workflowBootstrapSteps?๐น | Array<github.workflows.JobStep> |
Workflow steps to use in order to bootstrap this repo. Default: "yarn install --frozen-lockfile && yarn projen" |
| workflowContainerImage?๐น | string |
Container image to use for GitHub workflows. Default: default image |
| workflowGitIdentity?๐น | github.GitIdentity |
The git identity to use in workflows. Default: GitHub Actions |
| workflowNodeVersion?๐น | string |
The node version to use in GitHub workflows. Default: same as minNodeVersion |
| workflowRunsOn?๐น | Array |
Github Runner selection labels. Default: ["ubuntu-latest"] |
| Name | Type | Description |
|---|---|---|
| author๐น | string |
The name of the library author. |
| authorAddress๐น | string |
Email or URL of the library author. |
| cdkVersion๐น | string |
Minimum version of the AWS CDK to depend on. |
| defaultReleaseBranch๐น | string |
The name of the main release branch. |
| name๐น | string |
This is the name of your project. |
| repositoryUrl๐น | string |
Git repository URL. |
| allowLibraryDependencies?๐น | boolean |
Allow the project to include peerDependencies and bundledDependencies.Default: true |
| artifactsDirectory?๐น | string |
A directory which will contain build artifacts. Default: "dist" |
| authorEmail?๐น | string |
Author's e-mail. Optional |
| authorName?๐น | string |
Author's name. Optional |
| authorOrganization?๐น | boolean |
Author's Organization. Optional |
| authorUrl?๐น | string |
Author's URL / Website. Optional |
| autoApproveOptions?๐น | github.AutoApproveOptions |
Enable and configure the 'auto approve' workflow. Default: auto approve is disabled |
| autoApproveUpgrades?๐น | boolean |
Automatically approve deps upgrade PRs, allowing them to be merged by mergify (if configued). Default: true |
| autoDetectBin?๐น | boolean |
Automatically add all executables under the bin directory to your package.json file under the bin section.Default: true |
| autoMerge?๐น | boolean |
Enable automatic merging on GitHub. Default: true |
| autoMergeOptions?๐น | github.AutoMergeOptions |
Configure options for automatic merging on GitHub. Default: see defaults in AutoMergeOptions |
| bin?๐น | Map<string, string> |
Binary programs vended with your module. Optional |
| bugsEmail?๐น | string |
The email address to which issues should be reported. Optional |
| bugsUrl?๐น | string |
The url to your project's issue tracker. Optional |
| buildWorkflow?๐น | boolean |
Define a GitHub workflow for building PRs. Default: true if not a subproject |
| buildWorkflowTriggers?๐น | github.workflows.Triggers |
Build workflow triggers. Default: "{ pullRequest: {}, workflowDispatch: {} }" |
| bundledDeps?๐น | Array |
List of dependencies to bundle into this module. Optional |
| bundlerOptions?๐น | javascript.BundlerOptions |
Options for Bundler.Optional |
| catalog?๐น | cdk.Catalog |
Libraries will be picked up by the construct catalog when they are published to npm as jsii modules and will be published under:. Default: new version will be announced |
| cdkAssert? |
boolean |
Warning: NodeJS only. Default: will be included by default for AWS CDK >= 1.0.0 < 2.0.0 |
| cdkAssertions?๐น | boolean |
Install the assertions library? Default: will be included by default for AWS CDK >= 1.111.0 < 2.0.0 |
| cdkDependencies? |
Array |
Which AWS CDKv1 modules this project requires. Optional |
| cdkDependenciesAsDeps? |
boolean |
If this is enabled (default), all modules declared in cdkDependencies will be also added as normal dependencies (as well as peerDependencies).Default: true |
| cdkTestDependencies? |
Array |
AWS CDK modules required for testing. Optional |
| cdkVersionPinning?๐น | boolean |
Use pinned version instead of caret version for CDK. Optional |
| clobber?๐น | boolean |
Add a clobber task which resets the repo to origin.Default: true |
| codeArtifactOptions?๐น | javascript.CodeArtifactOptions |
Options for npm packages using AWS CodeArtifact. Default: undefined |
| codeCov?๐น | boolean |
Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/ Uses codecov/codecov-action@v1 A secret is required for private repos. Configured with @codeCovTokenSecret. Default: false |
| codeCovTokenSecret?๐น | string |
Define the secret name for a specified https://codecov.io/ token A secret is required to send coverage for private repositories. Default: if this option is not specified, only public repositories are supported |
| compat?๐น | boolean |
Automatically run API compatibility test against the latest version published to npm after compilation. Default: false |
| compatIgnore?๐น | string |
Name of the ignore file for API compatibility tests. Default: ".compatignore" |
| constructsVersion?๐น | string |
Minimum version of the constructs library to depend on.Default: for CDK 1.x the default is "3.2.27", for CDK 2.x the default is "10.0.5". |
| copyrightOwner?๐น | string |
License copyright owner. Default: defaults to the value of authorName or "" if authorName is undefined. |
| copyrightPeriod?๐น | string |
The copyright years to put in the LICENSE file. Default: current year |
| dependabot?๐น | boolean |
Use dependabot to handle dependency upgrades. Default: false |
| dependabotOptions?๐น | github.DependabotOptions |
Options for dependabot. Default: default options |
| deps?๐น | Array |
Runtime dependencies of this module. Default: [] |
| depsUpgrade?๐น | boolean |
Use github workflows to handle dependency upgrades. Default: true |
| depsUpgradeOptions?๐น | javascript.UpgradeDependenciesOptions |
Options for UpgradeDependencies.Default: default options |
| description?๐น | string |
The description is just a string that helps people understand the purpose of the package. Optional |
| devContainer?๐น | boolean |
Add a VSCode development environment (used for GitHub Codespaces). Default: false |
| devDeps?๐น | Array |
Build dependencies for this module. Default: [] |
| disableTsconfig?๐น | boolean |
Do not generate a tsconfig.json file (used by jsii projects since tsconfig.json is generated by the jsii compiler).Default: false |
| docgen?๐น | boolean |
Docgen by Typedoc. Default: false |
| docgenFilePath?๐น | string |
File path for generated docs. Default: "API.md" |
| docsDirectory?๐น | string |
Docs directory. Default: "docs" |
| dotnet? |
cdk.JsiiDotNetTarget |
Optional |
| entrypoint?๐น | string |
Module entrypoint (main in package.json).Default: "lib/index.js" |
| entrypointTypes?๐น | string |
The .d.ts file that includes the type declarations for this module. Default: .d.ts file derived from the project's entrypoint (usually lib/index.d.ts) |
| eslint?๐น | boolean |
Setup eslint. Default: true |
| eslintOptions?๐น | javascript.EslintOptions |
Eslint options. Default: opinionated default options |
| excludeTypescript?๐น | Array |
Accepts a list of glob patterns. Optional |
| github?๐น | boolean |
Enable GitHub integration. Default: true |
| githubOptions?๐น | github.GitHubOptions |
Options for GitHub integration. Default: see GitHubOptions |
| gitignore?๐น | Array |
Additional entries to .gitignore. Optional |
| gitpod?๐น | boolean |
Add a Gitpod development environment. Default: false |
| homepage?๐น | string |
Package's Homepage / Website. Optional |
| integrationTestAutoDiscover?๐น | boolean |
Automatically discovers and creates integration tests for each .integ.ts file in under your test directory.Default: true |
| jest?๐น | boolean |
Setup jest unit tests. Default: true |
| jestOptions?๐น | javascript.JestOptions |
Jest options. Default: default options |
| jsiiReleaseVersion?๐น | string |
Version requirement of publib which is used to publish modules to npm.Default: "latest" |
| keywords?๐น | Array |
Keywords to include in package.json.Optional |
| lambdaAutoDiscover?๐น | boolean |
Automatically adds an aws_lambda.Function for each .lambda.ts handler in your source tree. If this is disabled, you either need to explicitly call aws_lambda.Function.autoDiscover() or define a new aws_lambda.Function() for each handler.Default: true |
| lambdaExtensionAutoDiscover?๐น | boolean |
Automatically adds an awscdk.LambdaExtension for each .lambda-extension.ts entrypoint in your source tree. If this is disabled, you can manually add an awscdk.AutoDiscover component to your project.Default: true |
| lambdaOptions?๐น | awscdk.LambdaFunctionCommonOptions |
Common options for all AWS Lambda functions. Default: default options |
| libdir?๐น | string |
Typescript artifacts output directory. Default: "lib" |
| license?๐น | string |
License's SPDX identifier. Default: "Apache-2.0" |
| licensed?๐น | boolean |
Indicates if a license should be added. Default: true |
| logging?๐น | LoggerOptions |
Configure logging options such as verbosity. Default: {} |
| majorVersion?๐น | number |
Major version to release from the default branch. Default: Major version is not enforced. |
| maxNodeVersion?๐น | string |
Minimum node.js version to require via engines (inclusive).Default: no max |
| mergify? |
boolean |
Whether mergify should be enabled on this repository or not. Default: true |
| mergifyOptions? |
github.MergifyOptions |
Options for mergify. Default: default options |
| minNodeVersion?๐น | string |
Minimum Node.js version to require via package.json engines (inclusive).Default: no "engines" specified |
| mutableBuild?๐น | boolean |
Automatically update files modified during builds to pull-request branches. Default: true |
| npmAccess?๐น | javascript.NpmAccess |
Access level of the npm package. Default: for scoped packages (e.g. foo@bar), the default is NpmAccess.RESTRICTED, for non-scoped packages, the default is NpmAccess.PUBLIC. |
| npmDistTag?๐น | string |
The npmDistTag to use when publishing from the default branch. Default: "latest" |
| npmRegistry? |
string |
The host name of the npm registry to publish to. Optional |
| npmRegistryUrl?๐น | string |
The base URL of the npm package registry. Default: "https://registry.npmjs.org" |
| npmTokenSecret?๐น | string |
GitHub secret which contains the NPM token to use when publishing packages. Default: "NPM_TOKEN" |
| npmignore? |
Array |
Additional entries to .npmignore. Optional |
| npmignoreEnabled?๐น | boolean |
Defines an .npmignore file. Normally this is only needed for libraries that are packaged as tarballs. Default: true |
| outdir?๐น | string |
The root directory of the project. Default: "." |
| package?๐น | boolean |
Defines a package task that will produce an npm tarball under the artifacts directory (e.g. dist).Default: true |
| packageManager?๐น | javascript.NodePackageManager |
The Node Package Manager used to execute scripts. Default: NodePackageManager.YARN |
| packageName?๐น | string |
The "name" in package.json. Default: defaults to project name |
| parent?๐น | Project |
The parent project, if this project is part of a bigger project. Optional |
| peerDependencyOptions?๐น | javascript.PeerDependencyOptions |
Options for peerDeps.Optional |
| peerDeps?๐น | Array |
Peer dependencies for this module. Default: [] |
| postBuildSteps?๐น | Array<github.workflows.JobStep> |
Steps to execute after build as part of the release workflow. Default: [] |
| prerelease?๐น | string |
Bump versions from the default branch as pre-releases (e.g. "beta", "alpha", "pre"). Default: normal semantic versions |
| prettier?๐น | boolean |
Setup prettier. Default: false |
| prettierOptions?๐น | javascript.PrettierOptions |
Prettier options. Default: default options |
| projectType? |
ProjectType |
Which type of project this is (library/app). Default: ProjectType.UNKNOWN |
| projenCommand?๐น | string |
The shell command to use in order to run the projen CLI. Default: "npx projen" |
| projenCredentials?๐น | github.GithubCredentials |
Choose a method of providing GitHub API access for projen workflows. Default: use a personal access token named PROJEN_GITHUB_TOKEN |
| projenDevDependency?๐น | boolean |
Indicates of "projen" should be installed as a devDependency. Default: true |
| projenTokenSecret? |
string |
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows. Default: "PROJEN_GITHUB_TOKEN" |
| projenVersion?๐น | string |
Version of projen to install. Default: Defaults to the latest version. |
| projenrcJs?๐น | boolean |
Generate (once) .projenrc.js (in JavaScript). Set to false in order to disable .projenrc.js generation.Default: true if projenrcJson is false |
| projenrcJsOptions?๐น | javascript.ProjenrcOptions |
Options for .projenrc.js. Default: default options |
| projenrcJson?๐น | boolean |
Generate (once) .projenrc.json (in JSON). Set to false in order to disable .projenrc.json generation.Default: false |
| projenrcJsonOptions?๐น | ProjenrcOptions |
Options for .projenrc.json. Default: default options |
| projenrcTs?๐น | boolean |
Use TypeScript for your projenrc file (.projenrc.ts).Default: false |
| projenrcTsOptions?๐น | typescript.ProjenrcOptions |
Options for .projenrc.ts. Optional |
| publishDryRun?๐น | boolean |
Instead of actually publishing to package managers, just print the publishing command. Default: false |
| publishTasks?๐น | boolean |
Define publishing tasks that can be executed manually as well as workflows. Default: false |
| publishToGo?๐น | cdk.JsiiGoTarget |
Publish Go bindings to a git repository. Default: no publishing |
| publishToMaven?๐น | cdk.JsiiJavaTarget |
Publish to maven. Default: no publishing |
| publishToNuget?๐น | cdk.JsiiDotNetTarget |
Publish to NuGet. Default: no publishing |
| publishToPypi?๐น | cdk.JsiiPythonTarget |
Publish to pypi. Default: no publishing |
| pullRequestTemplate?๐น | boolean |
Include a GitHub pull request template. Default: true |
| pullRequestTemplateContents?๐น | Array |
The contents of the pull request template. Default: default content |
| python? |
cdk.JsiiPythonTarget |
Optional |
| readme?๐น | SampleReadmeProps |
The README setup. Default: { filename: 'README.md', contents: '# replace this' } |
| release?๐น | boolean |
Add release management to this project. Default: true (false for subprojects) |
| releaseBranches?๐น | Map<string, release.BranchOptions> |
Defines additional release branches. Default: no additional branches are used for release. you can use addBranch() to add additional branches. |
| releaseEveryCommit? |
boolean |
Automatically release new versions every commit to one of branches in releaseBranches.Default: true |
| releaseFailureIssue?๐น | boolean |
Create a github issue on every failed publishing task. Default: false |
| releaseFailureIssueLabel?๐น | string |
The label to apply to issues indicating publish failures. Default: "failed-release" |
| releaseSchedule? |
string |
CRON schedule to trigger new releases. Default: no scheduled releases |
| releaseTagPrefix?๐น | string |
Automatically add the given prefix to release tags. Useful if you are releasing on multiple branches with overlapping version numbers. Default: no prefix |
| releaseToNpm?๐น | boolean |
Automatically release to npm when new versions are introduced. Default: false |
| releaseTrigger?๐น | release.ReleaseTrigger |
The release trigger to use. Default: Continuous releases ( ReleaseTrigger.continuous()) |
| releaseWorkflow? |
boolean |
DEPRECATED: renamed to release.Default: true if not a subproject |
| releaseWorkflowName?๐น | string |
The name of the default release workflow. Default: "Release" |
| releaseWorkflowSetupSteps?๐น | Array<github.workflows.JobStep> |
A set of workflow steps to execute in order to setup the workflow container. Optional |
| repository?๐น | string |
The repository is the location where the actual code for your package lives. Optional |
| repositoryDirectory?๐น | string |
If the package.json for your package is not in the root directory (for example if it is part of a monorepo), you can specify the directory in which it lives. Optional |
| rootdir?๐น | string |
Default: "." |
| sampleCode?๐น | boolean |
Generate one-time sample in src/ and test/ if there are no files there.Default: true |
| scopedPackagesOptions?๐น | Array<javascript.ScopedPackagesOptions> |
Options for privately hosted scoped packages. Default: fetch all scoped packages from the public npm registry |
| scripts?๐น | Map<string, string> |
npm scripts to include. Default: {} |
| srcdir?๐น | string |
Typescript sources directory. Default: "src" |
| stability?๐น | string |
Package's Stability. Optional |
| stale?๐น | boolean |
Auto-close of stale issues and pull request. Default: false |
| staleOptions?๐น | github.StaleOptions |
Auto-close stale issues and pull requests. Default: see defaults in StaleOptions |
| testdir?๐น | string |
Jest tests directory. Tests files should be named xxx.test.ts.Default: "test" |
| tsconfig?๐น | javascript.TypescriptConfigOptions |
Custom TSConfig. Default: default options |
| tsconfigDev?๐น | javascript.TypescriptConfigOptions |
Custom tsconfig options for the development tsconfig.json file (used for testing). Default: use the production tsconfig options |
| tsconfigDevFile?๐น | string |
The name of the development tsconfig.json file. Default: "tsconfig.dev.json" |
| typescriptVersion?๐น | string |
TypeScript version to use. Default: "latest" |
| versionrcOptions?๐น | Map<string, any> |
Custom configuration used when creating changelog with standard-version package. Default: standard configuration applicable for GitHub repositories |
| vscode?๐น | boolean |
Enable VSCode integration. Default: true |
| workflowBootstrapSteps?๐น | Array<github.workflows.JobStep> |
Workflow steps to use in order to bootstrap this repo. Default: "yarn install --frozen-lockfile && yarn projen" |
| workflowContainerImage?๐น | string |
Container image to use for GitHub workflows. Default: default image |
| workflowGitIdentity?๐น | github.GitIdentity |
The git identity to use in workflows. Default: GitHub Actions |
| workflowNodeVersion?๐น | string |
The node version to use in GitHub workflows. Default: same as minNodeVersion |
| workflowRunsOn?๐น | Array |
Github Runner selection labels. Default: ["ubuntu-latest"] |
| Name | Type | Description |
|---|---|---|
| defaultReleaseBranch๐น | string |
The name of the main release branch. |
| name๐น | string |
This is the name of your project. |
| allowLibraryDependencies?๐น | boolean |
Allow the project to include peerDependencies and bundledDependencies.Default: true |
| artifactsDirectory?๐น | string |
A directory which will contain build artifacts. Default: "dist" |
| authorEmail?๐น | string |
Author's e-mail. Optional |
| authorName?๐น | string |
Author's name. Optional |
| authorOrganization?๐น | boolean |
Author's Organization. Optional |
| authorUrl?๐น | string |
Author's URL / Website. Optional |
| autoApproveOptions?๐น | github.AutoApproveOptions |
Enable and configure the 'auto approve' workflow. Default: auto approve is disabled |
| autoApproveUpgrades?๐น | boolean |
Automatically approve deps upgrade PRs, allowing them to be merged by mergify (if configued). Default: true |
| autoDetectBin?๐น | boolean |
Automatically add all executables under the bin directory to your package.json file under the bin section.Default: true |
| autoMerge?๐น | boolean |
Enable automatic merging on GitHub. Default: true |
| autoMergeOptions?๐น | github.AutoMergeOptions |
Configure options for automatic merging on GitHub. Default: see defaults in AutoMergeOptions |
| bin?๐น | Map<string, string> |
Binary programs vended with your module. Optional |
| bugsEmail?๐น | string |
The email address to which issues should be reported. Optional |
| bugsUrl?๐น | string |
The url to your project's issue tracker. Optional |
| buildWorkflow?๐น | boolean |
Define a GitHub workflow for building PRs. Default: true if not a subproject |
| buildWorkflowTriggers?๐น | github.workflows.Triggers |
Build workflow triggers. Default: "{ pullRequest: {}, workflowDispatch: {} }" |
| bundledDeps?๐น | Array |
List of dependencies to bundle into this module. Optional |
| bundlerOptions?๐น | javascript.BundlerOptions |
Options for Bundler.Optional |
| clobber?๐น | boolean |
Add a clobber task which resets the repo to origin.Default: true |
| codeArtifactOptions?๐น | javascript.CodeArtifactOptions |
Options for npm packages using AWS CodeArtifact. Default: undefined |
| codeCov?๐น | boolean |
Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/ Uses codecov/codecov-action@v1 A secret is required for private repos. Configured with @codeCovTokenSecret. Default: false |
| codeCovTokenSecret?๐น | string |
Define the secret name for a specified https://codecov.io/ token A secret is required to send coverage for private repositories. Default: if this option is not specified, only public repositories are supported |
| copyrightOwner?๐น | string |
License copyright owner. Default: defaults to the value of authorName or "" if authorName is undefined. |
| copyrightPeriod?๐น | string |
The copyright years to put in the LICENSE file. Default: current year |
| dependabot?๐น | boolean |
Use dependabot to handle dependency upgrades. Default: false |
| dependabotOptions?๐น | github.DependabotOptions |
Options for dependabot. Default: default options |
| deps?๐น | Array |
Runtime dependencies of this module. Default: [] |
| depsUpgrade?๐น | boolean |
Use github workflows to handle dependency upgrades. Default: true |
| depsUpgradeOptions?๐น | javascript.UpgradeDependenciesOptions |
Options for UpgradeDependencies.Default: default options |
| description?๐น | string |
The description is just a string that helps people understand the purpose of the package. Optional |
| devContainer?๐น | boolean |
Add a VSCode development environment (used for GitHub Codespaces). Default: false |
| devDeps?๐น | Array |
Build dependencies for this module. Default: [] |
| disableTsconfig?๐น | boolean |
Do not generate a tsconfig.json file (used by jsii projects since tsconfig.json is generated by the jsii compiler).Default: false |
| docgen?๐น | boolean |
Docgen by Typedoc. Default: false |
| docsDirectory?๐น | string |
Docs directory. Default: "docs" |
| entrypoint?๐น | string |
Module entrypoint (main in package.json).Default: "lib/index.js" |
| entrypointTypes?๐น | string |
The .d.ts file that includes the type declarations for this module. Default: .d.ts file derived from the project's entrypoint (usually lib/index.d.ts) |
| eslint?๐น | boolean |
Setup eslint. Default: true |
| eslintOptions?๐น | javascript.EslintOptions |
Eslint options. Default: opinionated default options |
| github?๐น | boolean |
Enable GitHub integration. Default: true |
| githubOptions?๐น | github.GitHubOptions |
Options for GitHub integration. Default: see GitHubOptions |
| gitignore?๐น | Array |
Additional entries to .gitignore. Optional |
| gitpod?๐น | boolean |
Add a Gitpod development environment. Default: false |
| homepage?๐น | string |
Package's Homepage / Website. Optional |
| jest?๐น | boolean |
Setup jest unit tests. Default: true |
| jestOptions?๐น | javascript.JestOptions |
Jest options. Default: default options |
| jsiiReleaseVersion?๐น | string |
Version requirement of publib which is used to publish modules to npm.Default: "latest" |
| keywords?๐น | Array |
Keywords to include in package.json.Optional |
| libdir?๐น | string |
Typescript artifacts output directory. Default: "lib" |
| license?๐น | string |
License's SPDX identifier. Default: "Apache-2.0" |
| licensed?๐น | boolean |
Indicates if a license should be added. Default: true |
| logging?๐น | LoggerOptions |
Configure logging options such as verbosity. Default: {} |
| majorVersion?๐น | number |
Major version to release from the default branch. Default: Major version is not enforced. |
| maxNodeVersion?๐น | string |
Minimum node.js version to require via engines (inclusive).Default: no max |
| mergify? |
boolean |
Whether mergify should be enabled on this repository or not. Default: true |
| mergifyOptions? |
github.MergifyOptions |
Options for mergify. Default: default options |
| minNodeVersion?๐น | string |
Minimum Node.js version to require via package.json engines (inclusive).Default: no "engines" specified |
| mutableBuild?๐น | boolean |
Automatically update files modified during builds to pull-request branches. Default: true |
| npmAccess?๐น | javascript.NpmAccess |
Access level of the npm package. Default: for scoped packages (e.g. foo@bar), the default is NpmAccess.RESTRICTED, for non-scoped packages, the default is NpmAccess.PUBLIC. |
| npmDistTag?๐น | string |
The npmDistTag to use when publishing from the default branch. Default: "latest" |
| npmRegistry? |
string |
The host name of the npm registry to publish to. Optional |
| npmRegistryUrl?๐น | string |
The base URL of the npm package registry. Default: "https://registry.npmjs.org" |
| npmTokenSecret?๐น | string |
GitHub secret which contains the NPM token to use when publishing packages. Default: "NPM_TOKEN" |
| npmignore? |
Array |
Additional entries to .npmignore. Optional |
| npmignoreEnabled?๐น | boolean |
Defines an .npmignore file. Normally this is only needed for libraries that are packaged as tarballs. Default: true |
| outdir?๐น | string |
The root directory of the project. Default: "." |
| package?๐น | boolean |
Defines a package task that will produce an npm tarball under the artifacts directory (e.g. dist).Default: true |
| packageManager?๐น | javascript.NodePackageManager |
The Node Package Manager used to execute scripts. Default: NodePackageManager.YARN |
| packageName?๐น | string |
The "name" in package.json. Default: defaults to project name |
| parent?๐น | Project |
The parent project, if this project is part of a bigger project. Optional |
| peerDependencyOptions?๐น | javascript.PeerDependencyOptions |
Options for peerDeps.Optional |
| peerDeps?๐น | Array |
Peer dependencies for this module. Default: [] |
| postBuildSteps?๐น | Array<github.workflows.JobStep> |
Steps to execute after build as part of the release workflow. Default: [] |
| prerelease?๐น | string |
Bump versions from the default branch as pre-releases (e.g. "beta", "alpha", "pre"). Default: normal semantic versions |
| prettier?๐น | boolean |
Setup prettier. Default: false |
| prettierOptions?๐น | javascript.PrettierOptions |
Prettier options. Default: default options |
| projectType? |
ProjectType |
Which type of project this is (library/app). Default: ProjectType.UNKNOWN |
| projenCommand?๐น | string |
The shell command to use in order to run the projen CLI. Default: "npx projen" |
| projenCredentials?๐น | github.GithubCredentials |
Choose a method of providing GitHub API access for projen workflows. Default: use a personal access token named PROJEN_GITHUB_TOKEN |
| projenDevDependency?๐น | boolean |
Indicates of "projen" should be installed as a devDependency. Default: true |
| projenTokenSecret? |
string |
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows. Default: "PROJEN_GITHUB_TOKEN" |
| projenVersion?๐น | string |
Version of projen to install. Default: Defaults to the latest version. |
| projenrcJs?๐น | boolean |
Generate (once) .projenrc.js (in JavaScript). Set to false in order to disable .projenrc.js generation.Default: true if projenrcJson is false |
| projenrcJsOptions?๐น | javascript.ProjenrcOptions |
Options for .projenrc.js. Default: default options |
| projenrcJson?๐น | boolean |
Generate (once) .projenrc.json (in JSON). Set to false in order to disable .projenrc.json generation.Default: false |
| projenrcJsonOptions?๐น | ProjenrcOptions |
Options for .projenrc.json. Default: default options |
| projenrcTs?๐น | boolean |
Use TypeScript for your projenrc file (.projenrc.ts).Default: false |
| projenrcTsOptions?๐น | typescript.ProjenrcOptions |
Options for .projenrc.ts. Optional |
| publishDryRun?๐น | boolean |
Instead of actually publishing to package managers, just print the publishing command. Default: false |
| publishTasks?๐น | boolean |
Define publishing tasks that can be executed manually as well as workflows. Default: false |
| pullRequestTemplate?๐น | boolean |
Include a GitHub pull request template. Default: true |
| pullRequestTemplateContents?๐น | Array |
The contents of the pull request template. Default: default content |
| readme?๐น | SampleReadmeProps |
The README setup. Default: { filename: 'README.md', contents: '# replace this' } |
| release?๐น | boolean |
Add release management to this project. Default: true (false for subprojects) |
| releaseBranches?๐น | Map<string, release.BranchOptions> |
Defines additional release branches. Default: no additional branches are used for release. you can use addBranch() to add additional branches. |
| releaseEveryCommit? |
boolean |
Automatically release new versions every commit to one of branches in releaseBranches.Default: true |
| releaseFailureIssue?๐น | boolean |
Create a github issue on every failed publishing task. Default: false |
| releaseFailureIssueLabel?๐น | string |
The label to apply to issues indicating publish failures. Default: "failed-release" |
| releaseSchedule? |
string |
CRON schedule to trigger new releases. Default: no scheduled releases |
| releaseTagPrefix?๐น | string |
Automatically add the given prefix to release tags. Useful if you are releasing on multiple branches with overlapping version numbers. Default: no prefix |
| releaseToNpm?๐น | boolean |
Automatically release to npm when new versions are introduced. Default: false |
| releaseTrigger?๐น | release.ReleaseTrigger |
The release trigger to use. Default: Continuous releases ( ReleaseTrigger.continuous()) |
| releaseWorkflow? |
boolean |
DEPRECATED: renamed to release.Default: true if not a subproject |
| releaseWorkflowName?๐น | string |
The name of the default release workflow. Default: "Release" |
| releaseWorkflowSetupSteps?๐น | Array<github.workflows.JobStep> |
A set of workflow steps to execute in order to setup the workflow container. Optional |
| repository?๐น | string |
The repository is the location where the actual code for your package lives. Optional |
| repositoryDirectory?๐น | string |
If the package.json for your package is not in the root directory (for example if it is part of a monorepo), you can specify the directory in which it lives. Optional |
| sampleCode?๐น | boolean |
Generate one-time sample in src/ and test/ if there are no files there.Default: true |
| scopedPackagesOptions?๐น | Array<javascript.ScopedPackagesOptions> |
Options for privately hosted scoped packages. Default: fetch all scoped packages from the public npm registry |
| scripts?๐น | Map<string, string> |
npm scripts to include. Default: {} |
| srcdir?๐น | string |
Typescript sources directory. Default: "src" |
| stability?๐น | string |
Package's Stability. Optional |
| stale?๐น | boolean |
Auto-close of stale issues and pull request. Default: false |
| staleOptions?๐น | github.StaleOptions |
Auto-close stale issues and pull requests. Default: see defaults in StaleOptions |
| testdir?๐น | string |
Jest tests directory. Tests files should be named xxx.test.ts.Default: "test" |
| tsconfig?๐น | javascript.TypescriptConfigOptions |
Custom TSConfig. Default: default options |
| tsconfigDev?๐น | javascript.TypescriptConfigOptions |
Custom tsconfig options for the development tsconfig.json file (used for testing). Default: use the production tsconfig options |
| tsconfigDevFile?๐น | string |
The name of the development tsconfig.json file. Default: "tsconfig.dev.json" |
| typescriptVersion?๐น | string |
TypeScript version to use. Default: "latest" |
| versionrcOptions?๐น | Map<string, any> |
Custom configuration used when creating changelog with standard-version package. Default: standard configuration applicable for GitHub repositories |
| vscode?๐น | boolean |
Enable VSCode integration. Default: true |
| workflowBootstrapSteps?๐น | Array<github.workflows.JobStep> |
Workflow steps to use in order to bootstrap this repo. Default: "yarn install --frozen-lockfile && yarn projen" |
| workflowContainerImage?๐น | string |
Container image to use for GitHub workflows. Default: default image |
| workflowGitIdentity?๐น | github.GitIdentity |
The git identity to use in workflows. Default: GitHub Actions |
| workflowNodeVersion?๐น | string |
The node version to use in GitHub workflows. Default: same as minNodeVersion |
| workflowRunsOn?๐น | Array |
Github Runner selection labels. Default: ["ubuntu-latest"] |
| Name | Type | Description |
|---|---|---|
| defaultReleaseBranch๐น | string |
The name of the main release branch. |
| name๐น | string |
This is the name of your project. |
| allowLibraryDependencies?๐น | boolean |
Allow the project to include peerDependencies and bundledDependencies.Default: true |
| artifactsDirectory?๐น | string |
A directory which will contain build artifacts. Default: "dist" |
| authorEmail?๐น | string |
Author's e-mail. Optional |
| authorName?๐น | string |
Author's name. Optional |
| authorOrganization?๐น | boolean |
Author's Organization. Optional |
| authorUrl?๐น | string |
Author's URL / Website. Optional |
| autoApproveOptions?๐น | github.AutoApproveOptions |
Enable and configure the 'auto approve' workflow. Default: auto approve is disabled |
| autoApproveUpgrades?๐น | boolean |
Automatically approve deps upgrade PRs, allowing them to be merged by mergify (if configued). Default: true |
| autoDetectBin?๐น | boolean |
Automatically add all executables under the bin directory to your package.json file under the bin section.Default: true |
| autoMerge?๐น | boolean |
Enable automatic merging on GitHub. Default: true |
| autoMergeOptions?๐น | github.AutoMergeOptions |
Configure options for automatic merging on GitHub. Default: see defaults in AutoMergeOptions |
| bin?๐น | Map<string, string> |
Binary programs vended with your module. Optional |
| bugsEmail?๐น | string |
The email address to which issues should be reported. Optional |
| bugsUrl?๐น | string |
The url to your project's issue tracker. Optional |
| buildWorkflow?๐น | boolean |
Define a GitHub workflow for building PRs. Default: true if not a subproject |
| buildWorkflowTriggers?๐น | github.workflows.Triggers |
Build workflow triggers. Default: "{ pullRequest: {}, workflowDispatch: {} }" |
| bundledDeps?๐น | Array |
List of dependencies to bundle into this module. Optional |
| bundlerOptions?๐น | javascript.BundlerOptions |
Options for Bundler.Optional |
| clobber?๐น | boolean |
Add a clobber task which resets the repo to origin.Default: true |
| codeArtifactOptions?๐น | javascript.CodeArtifactOptions |
Options for npm packages using AWS CodeArtifact. Default: undefined |
| codeCov?๐น | boolean |
Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/ Uses codecov/codecov-action@v1 A secret is required for private repos. Configured with @codeCovTokenSecret. Default: false |
| codeCovTokenSecret?๐น | string |
Define the secret name for a specified https://codecov.io/ token A secret is required to send coverage for private repositories. Default: if this option is not specified, only public repositories are supported |
| copyrightOwner?๐น | string |
License copyright owner. Default: defaults to the value of authorName or "" if authorName is undefined. |
| copyrightPeriod?๐น | string |
The copyright years to put in the LICENSE file. Default: current year |
| dependabot?๐น | boolean |
Use dependabot to handle dependency upgrades. Default: false |
| dependabotOptions?๐น | github.DependabotOptions |
Options for dependabot. Default: default options |
| deps?๐น | Array |
Runtime dependencies of this module. Default: [] |
| depsUpgrade?๐น | boolean |
Use github workflows to handle dependency upgrades. Default: true |
| depsUpgradeOptions?๐น | javascript.UpgradeDependenciesOptions |
Options for UpgradeDependencies.Default: default options |
| description?๐น | string |
The description is just a string that helps people understand the purpose of the package. Optional |
| devContainer?๐น | boolean |
Add a VSCode development environment (used for GitHub Codespaces). Default: false |
| devDeps?๐น | Array |
Build dependencies for this module. Default: [] |
| disableTsconfig?๐น | boolean |
Do not generate a tsconfig.json file (used by jsii projects since tsconfig.json is generated by the jsii compiler).Default: false |
| docgen?๐น | boolean |
Docgen by Typedoc. Default: false |
| docsDirectory?๐น | string |
Docs directory. Default: "docs" |
| entrypoint?๐น | string |
Module entrypoint (main in package.json).Default: "lib/index.js" |
| entrypointTypes?๐น | string |
The .d.ts file that includes the type declarations for this module. Default: .d.ts file derived from the project's entrypoint (usually lib/index.d.ts) |
| eslint?๐น | boolean |
Setup eslint. Default: true |
| eslintOptions?๐น | javascript.EslintOptions |
Eslint options. Default: opinionated default options |
| github?๐น | boolean |
Enable GitHub integration. Default: true |
| githubOptions?๐น | github.GitHubOptions |
Options for GitHub integration. Default: see GitHubOptions |
| gitignore?๐น | Array |
Additional entries to .gitignore. Optional |
| gitpod?๐น | boolean |
Add a Gitpod development environment. Default: false |
| homepage?๐น | string |
Package's Homepage / Website. Optional |
| jest?๐น | boolean |
Setup jest unit tests. Default: true |
| jestOptions?๐น | javascript.JestOptions |
Jest options. Default: default options |
| jsiiReleaseVersion?๐น | string |
Version requirement of publib which is used to publish modules to npm.Default: "latest" |
| keywords?๐น | Array |
Keywords to include in package.json.Optional |
| libdir?๐น | string |
Typescript artifacts output directory. Default: "lib" |
| license?๐น | string |
License's SPDX identifier. Default: "Apache-2.0" |
| licensed?๐น | boolean |
Indicates if a license should be added. Default: true |
| logging?๐น | LoggerOptions |
Configure logging options such as verbosity. Default: {} |
| majorVersion?๐น | number |
Major version to release from the default branch. Default: Major version is not enforced. |
| maxNodeVersion?๐น | string |
Minimum node.js version to require via engines (inclusive).Default: no max |
| mergify? |
boolean |
Whether mergify should be enabled on this repository or not. Default: true |
| mergifyOptions? |
github.MergifyOptions |
Options for mergify. Default: default options |
| minNodeVersion?๐น | string |
Minimum Node.js version to require via package.json engines (inclusive).Default: no "engines" specified |
| mutableBuild?๐น | boolean |
Automatically update files modified during builds to pull-request branches. Default: true |
| npmAccess?๐น | javascript.NpmAccess |
Access level of the npm package. Default: for scoped packages (e.g. foo@bar), the default is NpmAccess.RESTRICTED, for non-scoped packages, the default is NpmAccess.PUBLIC. |
| npmDistTag?๐น | string |
The npmDistTag to use when publishing from the default branch. Default: "latest" |
| npmRegistry? |
string |
The host name of the npm registry to publish to. Optional |
| npmRegistryUrl?๐น | string |
The base URL of the npm package registry. Default: "https://registry.npmjs.org" |
| npmTokenSecret?๐น | string |
GitHub secret which contains the NPM token to use when publishing packages. Default: "NPM_TOKEN" |
| npmignore? |
Array |
Additional entries to .npmignore. Optional |
| npmignoreEnabled?๐น | boolean |
Defines an .npmignore file. Normally this is only needed for libraries that are packaged as tarballs. Default: true |
| outdir?๐น | string |
The root directory of the project. Default: "." |
| package?๐น | boolean |
Defines a package task that will produce an npm tarball under the artifacts directory (e.g. dist).Default: true |
| packageManager?๐น | javascript.NodePackageManager |
The Node Package Manager used to execute scripts. Default: NodePackageManager.YARN |
| packageName?๐น | string |
The "name" in package.json. Default: defaults to project name |
| parent?๐น | Project |
The parent project, if this project is part of a bigger project. Optional |
| peerDependencyOptions?๐น | javascript.PeerDependencyOptions |
Options for peerDeps.Optional |
| peerDeps?๐น | Array |
Peer dependencies for this module. Default: [] |
| postBuildSteps?๐น | Array<github.workflows.JobStep> |
Steps to execute after build as part of the release workflow. Default: [] |
| prerelease?๐น | string |
Bump versions from the default branch as pre-releases (e.g. "beta", "alpha", "pre"). Default: normal semantic versions |
| prettier?๐น | boolean |
Setup prettier. Default: false |
| prettierOptions?๐น | javascript.PrettierOptions |
Prettier options. Default: default options |
| projectType? |
ProjectType |
Which type of project this is (library/app). Default: ProjectType.UNKNOWN |
| projenCommand?๐น | string |
The shell command to use in order to run the projen CLI. Default: "npx projen" |
| projenCredentials?๐น | github.GithubCredentials |
Choose a method of providing GitHub API access for projen workflows. Default: use a personal access token named PROJEN_GITHUB_TOKEN |
| projenDevDependency?๐น | boolean |
Indicates of "projen" should be installed as a devDependency. Default: true |
| projenTokenSecret? |
string |
The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows. Default: "PROJEN_GITHUB_TOKEN" |
| projenVersion?๐น | string |
Version of projen to install. Default: Defaults to the latest version. |
| projenrcJs?๐น | boolean |
Generate (once) .projenrc.js (in JavaScript). Set to false in order to disable .projenrc.js generation.Default: true if projenrcJson is false |
| projenrcJsOptions?๐น | javascript.ProjenrcOptions |
Options for .projenrc.js. Default: default options |
| projenrcJson?๐น | boolean |
Generate (once) .projenrc.json (in JSON). Set to false in order to disable .projenrc.json generation.Default: false |
| projenrcJsonOptions?๐น | ProjenrcOptions |
Options for .projenrc.json. Default: default options |
| projenrcTs?๐น | boolean |
Use TypeScript for your projenrc file (.projenrc.ts).Default: false |
| projenrcTsOptions?๐น | typescript.ProjenrcOptions |
Options for .projenrc.ts. Optional |
| publishDryRun?๐น | boolean |
Instead of actually publishing to package managers, just print the publishing command. Default: false |
| publishTasks?๐น | boolean |
Define publishing tasks that can be executed manually as well as workflows. Default: false |
| pullRequestTemplate?๐น | boolean |
Include a GitHub pull request template. Default: true |
| pullRequestTemplateContents?๐น | Array |
The contents of the pull request template. Default: default content |
| readme?๐น | SampleReadmeProps |
The README setup. Default: { filename: 'README.md', contents: '# replace this' } |
| release?๐น | boolean |
Add release management to this project. Default: true (false for subprojects) |
| releaseBranches?๐น | Map<string, release.BranchOptions> |
Defines additional release branches. Default: no additional branches are used for release. you can use addBranch() to add additional branches. |
| releaseEveryCommit? |
boolean |
Automatically release new versions every commit to one of branches in releaseBranches.Default: true |
| releaseFailureIssue?๐น | boolean |
Create a github issue on every failed publishing task. Default: false |
| releaseFailureIssueLabel?๐น | string |
The label to apply to issues indicating publish failures. Default: "failed-release" |
| releaseSchedule? |
string |
CRON schedule to trigger new releases. Default: no scheduled releases |
| releaseTagPrefix?๐น | string |
Automatically add the given prefix to release tags. Useful if you are releasing on multiple branches with overlapping version numbers. Default: no prefix |
| releaseToNpm?๐น | boolean |
Automatically release to npm when new versions are introduced. Default: false |
| releaseTrigger?๐น | release.ReleaseTrigger |
The release trigger to use. Default: Continuous releases ( ReleaseTrigger.continuous()) |
| releaseWorkflow? |
boolean |
DEPRECATED: renamed to release.Default: true if not a subproject |
| releaseWorkflowName?๐น | string |
The name of the default release workflow. Default: "Release" |
| releaseWorkflowSetupSteps?๐น | Array<github.workflows.JobStep> |
A set of workflow steps to execute in order to setup the workflow container. Optional |
| repository?๐น | string |
The repository is the location where the actual code for your package lives. Optional |
| repositoryDirectory?๐น | string |
If the package.json for your package is not in the root directory (for example if it is part of a monorepo), you can specify the directory in which it lives. Optional |
| sampleCode?๐น | boolean |
Generate one-time sample in src/ and test/ if there are no files there.Default: true |
| scopedPackagesOptions?๐น | Array<javascript.ScopedPackagesOptions> |
Options for privately hosted scoped packages. Default: fetch all scoped packages from the public npm registry |
| scripts?๐น | Map<string, string> |
npm scripts to include. Default: {} |
| srcdir?๐น | string |
Typescript sources directory. Default: "src" |
| stability?๐น | string |
Package's Stability. Optional |
| stale?๐น | boolean |
Auto-close of stale issues and pull request. Default: false |
| staleOptions?๐น | github.StaleOptions |
Auto-close stale issues and pull requests. Default: see defaults in StaleOptions |
| testdir?๐น | string |
Jest tests directory. Tests files should be named xxx.test.ts.Default: "test" |
| tsconfig?๐น | javascript.TypescriptConfigOptions |
Custom TSConfig. Default: default options |
| tsconfigDev?๐น | javascript.TypescriptConfigOptions |
Custom tsconfig options for the development tsconfig.json file (used for testing). Default: use the production tsconfig options |
| tsconfigDevFile?๐น | string |
The name of the development tsconfig.json file. Default: "tsconfig.dev.json" |
| typescriptVersion?๐น | string |
TypeScript version to use. Default: "latest" |
| versionrcOptions?๐น | Map<string, any> |
Custom configuration used when creating changelog with standard-version package. Default: standard configuration applicable for GitHub repositories |
| vscode?๐น | boolean |
Enable VSCode integration. Default: true |
| workflowBootstrapSteps?๐น | Array<github.workflows.JobStep> |
Workflow steps to use in order to bootstrap this repo. Default: "yarn install --frozen-lockfile && yarn projen" |
| workflowContainerImage?๐น | string |
Container image to use for GitHub workflows. Default: default image |
| workflowGitIdentity?๐น | github.GitIdentity |
The git identity to use in workflows. Default: GitHub Actions |
| workflowNodeVersion?๐น | string |
The node version to use in GitHub workflows. Default: same as minNodeVersion |
| workflowRunsOn?๐น | Array |
Github Runner selection labels. Default: ["ubuntu-latest"] |