CLI

Bingo templates each provide a CLI to set up a new repository or transition an existing one. That CLI will interactively prompt you for any required options that can’t be inferred from disk.

For example, to run create-typescript-app:

npm

npx create-typescript-app

pnpm

pnpx create-typescript-app

yarn

yarn dlx create-typescript-app

┌  ✨ create-typescript-app@2.0.0 ✨
│
│  Learn more on: https://github.com/JoshuaKGoldberg/create-typescript-app
│
│  Running with mode --setup for a new repository.

Common Flags

All Bingo templates support the following set of CLI flags.

--directory

Type: string

What local directory path to run under.

If not provided:

• If the current directory is empty, defaults to it (.)
• Otherwise, you’ll be prompted to input one

For example, creating a new repository in a subdirectory:

npm

npx create-typescript-app --directory my-fancy-project

pnpm

pnpx create-typescript-app --directory my-fancy-project

yarn

yarn dlx create-typescript-app --directory my-fancy-project

--help

Type: boolean

Prints help text.

npm

npx create-typescript-app --help

pnpm

pnpx create-typescript-app --help

yarn

yarn dlx create-typescript-app --help

--mode

Type: string

Which Execution Mode to run in.

If not provided, it will be inferred based on whether Bingo is being run in an existing repository.

For example, specifying creating a new repository with create-typescript-app:

npm

npx create-typescript-app --mode setup

pnpm

pnpx create-typescript-app --mode setup

yarn

yarn dlx create-typescript-app --mode setup

--offline

Type: boolean

Whether to run in an “offline” mode that skips network requests.

If provided, templates will be hinted to not make any network requests. That often means they will install from offline caches, skip creating a repository on GitHub, and skip sending GitHub API requests. The repository will roughly be a local-only creation.

For example, specifying creating a new repository offline with create-typescript-app:

npm

npx create-typescript-app --offline

pnpm

pnpx create-typescript-app --offline

yarn

yarn dlx create-typescript-app --offline

Caution

--offline doesn’t prevent templates from accidentally running scripts that make network requests. If you are finding your template still sends requests with --offline, file a bug on the template.

--version

Type: boolean

Prints the Bingo package version.

npm

npx create-typescript-app --version

pnpm

pnpx create-typescript-app --version

yarn

yarn dlx create-typescript-app --version

Template Flags

The template being generated from will likely add in additional flags. Templates generally add in a CLI flag for each of the options they support.

For example, if a template defines a title option, --title will be type string:

npm

npx create-typescript-app --title 'My New App'

pnpm

pnpx create-typescript-app --title 'My New App'

yarn

yarn dlx create-typescript-app --title 'My New App'

Any required options that are not provided will be prompted for by the template’s CLI.

Tip

See the documentation for your specific template for additional flags.