@thruster/cli NPM

thruster

For better experience creating a project template

Motivation

Trying to build a cli tool like Yeoman but easier to use base on a config file.

How to use?

build a template

create your own Node.js project template
add configuration file

touch .thruster.json

publish template project

You can push git repository or publish it to npm registry.

create project with thruster

install thruster-cli

npm install -g @thruster/cli

create project

You can create project from npm registry or remote git repository

thruster create --from git --resource <git host>:<user name>/<repository>#<branch> --path [relative path] <project name>
# example: thruster create --from git --resource https://github.com:pascallin/thruster#main --path examples/cra-template testproj

thruster create --from local --resource <absolute path in localhost> <project name>
# example: thruster create --from local --resource ~/Development/pascal-github/thruster --path examples/cra-template testproj

Use case

Examples

suppose you have a git repository like

.
├──examples
|   ├──examples-template
|     |── ...
├──src
│   |── ...
├── package.json
|── ...

you can add thruster a .thruster.json to your examples, and then you can quickly start a specific example.

Basic Template

suppose you want to create a react front-end project as a template, you can create a github repository and add thruster to it.

thruster template configuration

templatePath, will copy whole folder as work directory
ignore, it will not copy from template folder. There are some default ignore files, check docs.
extra, it will merge to package.json, please ensure dependencies and devDependencies was in here if your template package needed.

example:

{
  "templatePath": ".",
  "ignore": [".travis.yml"],
  "extra": {
    "dependencies": {
      "axios": "^0.21.0"
    },
    "devDependencies": {
      "eslint": "^7.12.1"
    }
  }
}