Run npx create-stackbit-app in your terminal to create a new Stackbit application or add Stackbit into an existing site.

To create a new Stackbit project from a starter, run the following command:

npx create-stackbit-app@latest [dir]

To see a full list of options use the --help flag:

> npx create-stackbit-app@latest --help

Options:
      --version  Show version number                                   [boolean]
  -s, --starter  Choose a starter                     [choices: "nextjs", "..."]
  -e, --example  Start from an example        [choices: "algolia-search", "..."]
      --help     Show help                                             [boolean]

Use the --starter option for specifying a starter. Run the command with the --help flag to see a full list of available starters.

npx create-stackbit-app@latest --starter ts-nextjs

If no starter option is provided, the default starter is used.

Use the --example option to start a project from an example. Run the command with the --help flag to see a full list of available starters.

npx create-stackbit-app@latest --example algolia-search

This will create a new project matching the name of the example, unless overridden (see below). See here for a full list of starters.

Pass a directory name as the only argument when running the command. For example, if you wanted your directory to be name my-site, the command would look something like this:

npx create-stackbit-app@latest my-site

If no name is provided, the directory will be my-stackbit-site for starters or will match the name of the example if starting from an example. If the directory already exists, a timestamp value will be appended to the directory name to ensure uniqueness.

The script detects when you may be working with an existing project (it looks for a package.json file in the working directory).

If in an existing project, the script asks if you'd like to add Stackbit to the project. Today, this only prints a resource URL. If you choose no, the command exits.