@enrico.piccinin/create-node-ts-app NPM

create-node-ts-app

Creates a node app configured to use Typescript.

Requires Node version > v16.7.0

npx --yes @enrico.piccinin/create-node-ts-app <options>

-a --appName (required): name of the app
-t --template (optional): template to be used (default: default template)
-v --verbose (optional): print logs for each step on the standardout (default: false)

It is possible to specify a template to be used to create the app.

npx --yes @enrico.piccinin/create-node-ts-app -a <app-name>

Scaffolds a simple Node app configured to use Typescript.

Provides a configuration for eslint and prettier.

Testing is based on the mocha and chai libraries.

Creates an src folder with an hallo.ts and its test hallo.spec.ts.

npx --yes @enrico.piccinin/create-node-ts-app -a <app-name> -t package

Scaffolds a Node app that can be published as a package on the public NPM registry.

Provides a configuration for eslint and prettier.

Testing is based on the mocha and chai libraries.

Creates an src folder with a package-core.ts file containing a sample of a function which is exported by the package via the index.ts file.

Make sure that "declaration": true is specified in the tsconfig.json file.

npx --yes @enrico.piccinin/create-node-ts-app -a <app-name> -t exec-cmd

Scafolds a Node app that can be deployed on the public NPM registry and used as a command via npx.

Provides a configuration for eslint and prettier.

Testing is based on the mocha and chai libraries.

Creates an src folder with the following structure:

lib folder containing the command
core folder containing exec-command.ts which implements the logic to execute the command
core/internals folder containing the internals of the logic of the command

Make sure that:

the dist folder is removed from the .gitignore file
if the package name is scoped (e.g. @myorg/my-package) then the name of the package is specified in the package.json file like this: "name": "@myorg/my-package",
if the package is scoped you publish it with the command npm publish --access=public

A Template is an Object that defines how to scaffold a project.

A Template has the following properties:

folders. This is an array of names of folders which have to be copied to the target project folder. The "to be copied" folder names must be names of folders contained in the "template-folders" folder of this project.
commands. An array of strings representing the commands that have to be created after the project folder has been created. The commands are exectued from within the project folder. Examples of such commands and "npm i ..." to load dependencies or "git init" to initialize a git repo.
customizeFunctions. An array of functions which are executed from within the project folder. Such functions receive the app name as parameter.
customizeFunctionIds. An array of Objects of type FunctionId (i.e. of type {module: string; functionName: string}). Each FunctionId identifies a function which is loaded and executed from within the project folder. Such functions receive the app name as parameter.