search
HomeWeb Front-endJS TutorialHow to publish a package to npm: a step-by-step guide

Publishing packages on NPM (Node package manager) is not only a way to share your work with other developers, but also to stand out in the development community. Imagine creating a reusable solution that can be integrated into various projects around the world, saving other programmers time and effort.

In this article, you will learn, step by step, how to configure, publish, and maintain your own package on NPM, making your contributions accessible and increasing your visibility as a developer.

Prerequisites

Before you start, make sure you have:

  • NPM installed. You can download it from nodejs.org or use NVM (Node version manager).
  • An account created on npmjs.com

Run the commands below in the terminal to verify that the installation of Node.js and NPM was successful.

node -v
npm -v

If the installation is correct, the terminal will display the version of each.
The result will be similar to the one below:

$ v20.18.0 # node -v
$ 10.8.2 # npm -v

Configuring the project

Start by creating a folder with the name you want for the package. In my case I chose "string-reverser-jm".

mkdir string-reverser-jm # cria a pasta via terminal
cd string-reverser-jm # acessa a pasta via terminal

Initialize NPM:

npm init

When executing the above command, the terminal will ask you a few questions to create the package.json file.
Below is an explanation of each item that we need to fill out.

  • name: A unique identifier for the package.
  • version: Use semantic versioning to indicate changes.
  • description: A brief explanation of what the package does.
  • main: The entry point file, for example, index.js.
  • keywords: Keywords to categorize and make it easier for other developers to find the package.
  • author: Add relevant author details.
  • license: The license defines how the code can be used, modified and distributed by others. The most common license is the MIT, which is permissive and allows great freedom of use, as long as the original copyright notice is provided.

If you finish the questions and NPM created the file without any of this information, open the created file in an editor and add whatever is missing.

Example:

{
  "name": "string-reverser-jm",
  "version": "1.0.0",
  "description": "A simple utility to reverse strings, useful for demonstrations and small projects.",
  "main": "index.js",
  "scripts": {
    "test": "echo \"No test specified\" && exit 1"
  },
  "author": "Juliana Macedo <contact> (https://www.starcoders.info)",
  "keywords": [
    "string",
    "reverse",
    "utility"
  ],
  "license": "MIT"
}

</contact>

Writing the code

Create the index.js file in the root of the project.

function reverseString(str) {
  if (typeof str !== "string") {
    throw new TypeError("Expected a string as input");
  }
  return str.split("").reverse().join("");
}

module.exports = reverseString;

Testing the package

To test the package before publishing it, we will use the npm link command

In the package directory, run the command:

npm link

In the project where you want to test the package, run the command:

node -v
npm -v

Import and use the package in your test project to ensure it is working:

$ v20.18.0 # node -v
$ 10.8.2 # npm -v

To remove the created links, simply run the command npm unlink string-reverser-jm in the test project directory and then npm unlink in the package directory.

Preparing the package for publication

First, create a Git repository for the package and link it to NPM. This increases transparency and trust by making source code available, facilitates collaborations and community contributions, and enables automation with CI/CD for more efficient management and maintenance.

To link to NPM, copy the https address of the repository and add it to package.json:

mkdir string-reverser-jm # cria a pasta via terminal
cd string-reverser-jm # acessa a pasta via terminal
  • .gitignore: Create a .gitignore file to exclude folders and files, such as node_modules and .env, from versioning.
  • .npmignore: Create a .npmignore file to specify which files and folders should not be included in the NPM package.
  • README.md: Create a file with information about the package.

Publishing the package

Log in to NPM using your login details:

npm init

Run the command below to publish the package:

{
  "name": "string-reverser-jm",
  "version": "1.0.0",
  "description": "A simple utility to reverse strings, useful for demonstrations and small projects.",
  "main": "index.js",
  "scripts": {
    "test": "echo \"No test specified\" && exit 1"
  },
  "author": "Juliana Macedo <contact> (https://www.starcoders.info)",
  "keywords": [
    "string",
    "reverse",
    "utility"
  ],
  "license": "MIT"
}

</contact>

Okay, the package will soon be available in the NPM registry!
https://www.npmjs.com/package/string-reverser-jm

Updating the package

When making updates or bug fixes, increase the version number in package.json according to semantic versioning using one of the commands below:

function reverseString(str) {
  if (typeof str !== "string") {
    throw new TypeError("Expected a string as input");
  }
  return str.split("").reverse().join("");
}

module.exports = reverseString;

And then publish the updated version:

npm link

Frequent problems:

  • Package Name Already Taken: If publishing fails because a package with the same name already exists, choose another name, one that has not yet been taken.
  • Authentication Errors: Make sure you are logged in and have all the necessary permissions to publish.
  • Version Conflicts: If you try to publish without updating the version number, NPM will reject your post. Use npm version to increase the version.

Como publicar um pacote no npm: um guia passo a passo

Como publicar um pacote no npm: um guia passo a passo

The above is the detailed content of How to publish a package to npm: a step-by-step guide. For more information, please follow other related articles on the PHP Chinese website!

Statement
The content of this article is voluntarily contributed by netizens, and the copyright belongs to the original author. This site does not assume corresponding legal responsibility. If you find any content suspected of plagiarism or infringement, please contact admin@php.cn
JavaScript in Action: Real-World Examples and ProjectsJavaScript in Action: Real-World Examples and ProjectsApr 19, 2025 am 12:13 AM

JavaScript's application in the real world includes front-end and back-end development. 1) Display front-end applications by building a TODO list application, involving DOM operations and event processing. 2) Build RESTfulAPI through Node.js and Express to demonstrate back-end applications.

JavaScript and the Web: Core Functionality and Use CasesJavaScript and the Web: Core Functionality and Use CasesApr 18, 2025 am 12:19 AM

The main uses of JavaScript in web development include client interaction, form verification and asynchronous communication. 1) Dynamic content update and user interaction through DOM operations; 2) Client verification is carried out before the user submits data to improve the user experience; 3) Refreshless communication with the server is achieved through AJAX technology.

Understanding the JavaScript Engine: Implementation DetailsUnderstanding the JavaScript Engine: Implementation DetailsApr 17, 2025 am 12:05 AM

Understanding how JavaScript engine works internally is important to developers because it helps write more efficient code and understand performance bottlenecks and optimization strategies. 1) The engine's workflow includes three stages: parsing, compiling and execution; 2) During the execution process, the engine will perform dynamic optimization, such as inline cache and hidden classes; 3) Best practices include avoiding global variables, optimizing loops, using const and lets, and avoiding excessive use of closures.

Python vs. JavaScript: The Learning Curve and Ease of UsePython vs. JavaScript: The Learning Curve and Ease of UseApr 16, 2025 am 12:12 AM

Python is more suitable for beginners, with a smooth learning curve and concise syntax; JavaScript is suitable for front-end development, with a steep learning curve and flexible syntax. 1. Python syntax is intuitive and suitable for data science and back-end development. 2. JavaScript is flexible and widely used in front-end and server-side programming.

Python vs. JavaScript: Community, Libraries, and ResourcesPython vs. JavaScript: Community, Libraries, and ResourcesApr 15, 2025 am 12:16 AM

Python and JavaScript have their own advantages and disadvantages in terms of community, libraries and resources. 1) The Python community is friendly and suitable for beginners, but the front-end development resources are not as rich as JavaScript. 2) Python is powerful in data science and machine learning libraries, while JavaScript is better in front-end development libraries and frameworks. 3) Both have rich learning resources, but Python is suitable for starting with official documents, while JavaScript is better with MDNWebDocs. The choice should be based on project needs and personal interests.

From C/C   to JavaScript: How It All WorksFrom C/C to JavaScript: How It All WorksApr 14, 2025 am 12:05 AM

The shift from C/C to JavaScript requires adapting to dynamic typing, garbage collection and asynchronous programming. 1) C/C is a statically typed language that requires manual memory management, while JavaScript is dynamically typed and garbage collection is automatically processed. 2) C/C needs to be compiled into machine code, while JavaScript is an interpreted language. 3) JavaScript introduces concepts such as closures, prototype chains and Promise, which enhances flexibility and asynchronous programming capabilities.

JavaScript Engines: Comparing ImplementationsJavaScript Engines: Comparing ImplementationsApr 13, 2025 am 12:05 AM

Different JavaScript engines have different effects when parsing and executing JavaScript code, because the implementation principles and optimization strategies of each engine differ. 1. Lexical analysis: convert source code into lexical unit. 2. Grammar analysis: Generate an abstract syntax tree. 3. Optimization and compilation: Generate machine code through the JIT compiler. 4. Execute: Run the machine code. V8 engine optimizes through instant compilation and hidden class, SpiderMonkey uses a type inference system, resulting in different performance performance on the same code.

Beyond the Browser: JavaScript in the Real WorldBeyond the Browser: JavaScript in the Real WorldApr 12, 2025 am 12:06 AM

JavaScript's applications in the real world include server-side programming, mobile application development and Internet of Things control: 1. Server-side programming is realized through Node.js, suitable for high concurrent request processing. 2. Mobile application development is carried out through ReactNative and supports cross-platform deployment. 3. Used for IoT device control through Johnny-Five library, suitable for hardware interaction.

See all articles

Hot AI Tools

Undresser.AI Undress

Undresser.AI Undress

AI-powered app for creating realistic nude photos

AI Clothes Remover

AI Clothes Remover

Online AI tool for removing clothes from photos.

Undress AI Tool

Undress AI Tool

Undress images for free

Clothoff.io

Clothoff.io

AI clothes remover

AI Hentai Generator

AI Hentai Generator

Generate AI Hentai for free.

Hot Tools

mPDF

mPDF

mPDF is a PHP library that can generate PDF files from UTF-8 encoded HTML. The original author, Ian Back, wrote mPDF to output PDF files "on the fly" from his website and handle different languages. It is slower than original scripts like HTML2FPDF and produces larger files when using Unicode fonts, but supports CSS styles etc. and has a lot of enhancements. Supports almost all languages, including RTL (Arabic and Hebrew) and CJK (Chinese, Japanese and Korean). Supports nested block-level elements (such as P, DIV),

VSCode Windows 64-bit Download

VSCode Windows 64-bit Download

A free and powerful IDE editor launched by Microsoft

EditPlus Chinese cracked version

EditPlus Chinese cracked version

Small size, syntax highlighting, does not support code prompt function

MantisBT

MantisBT

Mantis is an easy-to-deploy web-based defect tracking tool designed to aid in product defect tracking. It requires PHP, MySQL and a web server. Check out our demo and hosting services.

SublimeText3 Chinese version

SublimeText3 Chinese version

Chinese version, very easy to use