[READ-ONLY] Mirror of https://github.com/sxzz/create. Command-line for creating projects from templates.
create README.md
2.1 kB · 96 lines
Markdown
at main

@sxzz/create #

npm version npm downloads

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

Sponsors #

Credits #

License #

MIT License © 2022-PRESENT Kevin Deng