Create Pantheon Decoupled Kit

Pantheon's command line interface for creating and adding on to new projects.

A CLI heavily inspired by various create- apps and generator frameworks including plop create-sitecore-jss, create-astro, and create-create-app.

Installation

To install this package locally, run the following commands from the root of the monorepo.

1  # build the package
2  pnpm build:cli
3  # link the local version of the package to global node_modules
4  pnpm link ./packages/create-pantheon-decoupled-kit
5  # run the bin script
6  pnpm create-pantheon-decoupled-kit

Usage

Use the create command to initiate the cli with no arguments and follow the prompts in your terminal

1  # this will use the latest non-canary version from the npm registry
2  # to use the latest canary, use pantheon-decoupled-kit@canary
3  pnpm create pantheon-decoupled-kit

Or, pass in arguments up front to skip those prompts

1  pnpm create pantheon-decoupled-kit next-wp --appName my-app --outDir ./my-app-dir --force

watch script

To run the watch script, ensure there is a watch.{ts,js} file at the root of this package. The watch file should export a named watchOptions object of type minimist.ParsedArgs. Positional arguments in the _ array will correspond to Generators to run. Named arguments correspond to answers to the Generator prompts. Generators will be run in the order they are given. Any number of generators may be run at a given time. See watch.example.ts for an example of watchOptions.

See create-pantheon-decoupled-kit for more information.

API Reference

Visit our docs site

Contributing

Please see the Contributing guide in our monorepo to contribute to the project.

See https://decoupledkit.pantheon.io/docs/contributing for details on contributing to this module.