@sxzz/create NPM

@sxzz/create

Command-line for creating projects from templates.

Install

npm i -g @sxzz/create

# Or use [p]npx
npx @sxzz/create

Usage

Create a project

create [path]
# e.g: create hello-world

Edit configuration

# edit the configuration via VSCode, Vim, or Zed.
create edit

Use remote configuration

create from <url>
# e.g: create from https://raw.githubusercontent.com/sxzz/create/main/example.yaml

# or for short
create from <owner>/<repo>/<branch>/<path>
# e.g: create from sxzz/create/main/example.yaml

Configuration

Most formats of configuration are supported. The configuration file is located in $HOME/.config/create.config.[js,mjs,ts,mts,json,yml,yaml]

TypeScript Schema

URL format: repo[/subpath][#ref]. See examples.

Run create config to modify config.

cwd: /Users/your-name/projects # optional, defaults to process.cwd()

git:
  init: true # optional, defaults to true
  add: false

templates:
  - name: Library # must be unique
    # color: '#008800' # optional
    children:
      - name: TypeScript
        color: '#3178c6'
        url: sxzz/node-lib-starter # remote URL or local path
  - name: Web App
    url: xxxxx
    git:
      init: false # overwrite global config