Usage#

Modern.js provides @modern-js/create tool for creating project templates provided by Modern.js, including Web App, Npm Module, Monorepo.

The following will introduce how to use @modern-js/create.

Environment Preparation#

Node.js#

Before getting started, you will need to install Node.js, and ensure that your Node.js version is higher than 16.2.0. We recommend using the LTS version of Node.js 18.

You can check the currently used Node.js version with the following command:

node -v

If you do not have Node.js installed in your current environment, or the installed version is lower than 16.2.0, you can use nvm or fnm to install the required version.

Here is an example of how to install the Node.js 18 LTS version via nvm:

# Install the long-term support version of Node.js 18
nvm install 18 --lts

# Make the newly installed Node.js 18 as the default version
nvm alias default 18

# Switch to the newly installed Node.js 18
nvm use 18

pnpm#

It is recommended to use pnpm to manage dependencies:

npm install -g pnpm@8

Create a Project with @modern-js/create#

You do not need to install @modern-js/create globally, just use npx to run it:

npx @modern-js/create@latest [projectDir]

During the execution, complete the interaction according to the prompt to create a project that meets your requirements.

Create an Web APP Project#

npx @modern-js/create@latest web-app
? Please select the type of project you want to create: Web App
? Please select the programming language: TS
? Please select the package manager: pnpm
? Please select the bundler: webpack

Create an Npm Module Project#

npx @modern-js/create@latest npm-module
? Please select the type of project you want to create: Npm Module
? Please fill in the project name: npm-module
? Please select the programming language: TS
? Please select the package manager: pnpm

Create Monorepo Project#

npx @modern-js/create@latest monorepo
? Please select the type of project you want to create: Monorepo
? Please select the package manager: pnpm