DEV Community

Cover image for A starter guide to create a command-line app in Node.js
Kumar Abhirup
Kumar Abhirup

Posted on • Updated on

A starter guide to create a command-line app in Node.js

Many developers use command-line apps on a daily basis.

From git to yarn, we use many CLI (Command Line Interface) apps. Not everyone likes CLI over GUI, but many geeks love using CLIs.

Today, we will learn how to create Command-Line Apps in Node.js

Command-Line apps can be written in many languages. If you write them in Node.js, you can serve your app to the NPM/Yarn users.

Assumptions

  • You know how to install NPM packages.
  • You know the basics of Node.js
  • You know basic terminal commands like cd, pwd, ll, ls.

Get Started

  • cd to the repository where you store all your code.

  • Do the following...

$ mkdir demo-cli && cd demo-cli

$ touch index.js

$ npm init -y
Enter fullscreen mode Exit fullscreen mode
  • Open the demo-cli folder in your favorite code editor.

index.js

CLI apps are all about input and output. In this Starter Guide, we won't go deep into creating a CLI that does something important.

For now, we will only make use of chalk and figlet to do make some creative output.

Run the following command to install needed packages...

$ npm i chalk figlet clear -s
Enter fullscreen mode Exit fullscreen mode

And then, just paste the following snippet in your index.js.

#!/usr/bin/env node

const clear = require('clear')
const chalk = require('chalk')
const figlet = require('figlet')

clear()

console.log(
  chalk.yellow.bold(
    figlet.textSync('CLI!', {
      horizontalLayout: 'full'
    })
  )
)
Enter fullscreen mode Exit fullscreen mode

The #!/usr/bin/env node line needs to be at the top for a Command Line App to work.

package.json

Add a Start Script in your package.json...

{
  "scripts": {
    "start": "node index.js"
  }
}
Enter fullscreen mode Exit fullscreen mode

Also, add a bin script. That script decides what command will user need to type to see the output.

{
  "bin": {
    "thisDemoCli": "index.js"
  }
}
Enter fullscreen mode Exit fullscreen mode

See the output

Run npm start to see how the output looks like. Isn't it just like running a Node app?

Okay, now, do this...

$ pwd # Copy the output you get

$ npm i -g <PASTE_THE_OUTPUT_OF_PREV_COMMAND>
Enter fullscreen mode Exit fullscreen mode

And now try running thisDemoCli in the terminal, and you should see the same output!

Output...

  / ___| | |     |_ _| | |
 | |     | |      | |  | |
 | |___  | |___   | |  |_|
  \____| |_____| |___| (_)
Enter fullscreen mode Exit fullscreen mode

Publish to NPM

To publish to NPM so that you can serve your apps to users, give your package a unique name, and provide it a version.

And then run...

$ npm publish
Enter fullscreen mode Exit fullscreen mode

That is it!

🦄 More info

This tutorial only helps you create a naive command-line app. Real command-line apps have a lot going on. Like the one I created.

Make use of the commander NPM module to make the CLI do different tasks on different flags like --help, --version, etc.

Here's the Part Two of the Series - Creating a command-line app in Node.js: Argument Parsing.


About me

I am Kumar Abhirup, a 16-year-old JavaScript React developer from India who keeps learning a new thing every single day.

Connect with me on Twitter 🐦
My personal website and portfolio 🖥️

Comment below your better ways, and suggestions to improve this article. :)

Top comments (6)

Collapse
 
kumareth profile image
Kumar Abhirup

Lemme know your better ways, and suggestions to improve this article. :)

Collapse
 
danyasatsuk profile image
Danya Satsuk

Very clear and interesting, thanks)

Collapse
 
kumareth profile image
Kumar Abhirup

Thank you Danya!

Collapse
 
prostomarkeloff profile image
prostomarkeloff

Yep, i think too!

Collapse
 
fredericbonnet profile image
Frédéric Bonnet

Nice intro! I'd suggest a followup article about command line argument parsing.

Collapse
 
kumareth profile image
Kumar Abhirup

Nice idea! Will prolly do it next weekend.