How to build and publish an NPM package for React using Typescript?
Last Updated :
23 Jul, 2025
In development, creating and distributing reusable components is essential for building scalable and maintainable applications. With the popularity of TypeScript and React, you can easily package and share your components as NPM packages. This tutorial will teach us how to create and release our NPM packages (NPM modules).
Prerequisites:
What is NPM?
NPM, short for Node Package Manager, is the default package manager for NodeJS. It is a command-line utility that allows you to install, manage, and share packages or modules of JavaScript code. These packages can range from small utility libraries to large frameworks, and they can be easily integrated into Node projects to extend their functionality.
NPM packages offer numerous advantages, a few of which are outlined below:
- Reusable code
- Code management (with versioning)
- distributing code
What is Typescript
TypeScript is a strict superset of JavaScript, which means anything that is implemented in JavaScript can be implemented using TypeScript along with the choice of adding enhanced features. It is an Open Source Object Oriented programming language and strongly typed language.
Steps to build NPM Package:-
Step 1: Open the GitHub account and create new empty repository and give the name stringToLower then click on create repository button.
create repositoryStep 2:- Then go to the code editor(VS Code) and Open the terminal and create new empty folder and then open it.
mkdir stringToLower
Step 3: Open this folder terminal and initialize the git repository
git init
git remote add origin https://github.com/YourRepo.git
git remote -v

Step 4:-Go to code editor, create README.md file in the folder and open terminal and check the status of the git repository
git status
Step 5:- write something your Readme file and push into the GitHub repository by using the following command.
git add .
git commit -m 'Initial'
git push -u origin master
write readme file and push in GitHub repositoryStep 6:- initialize the project using this command :- npm init -y and then go to package.json file and give the keywords and the author name and change licencse type ISC to MIT.

Step 7:- Create a file .gitignore and add node_modules in it.
.gitignore fileStep 8: Install typescript using the following command and Create a folder src and inside it create a file index.ts
npm install -D typescript
install typescriptStep 9:- For the configuration of TypeScript create a file tsconfig.json. then give some congiguration code like this:
JavaScript
{
"compilerOptions": {
"target": "ES5",
"module": "CommonJS",
"declaration": true,
"outDir": "./lib",
"strict": true
},
"include": ["src"],
"exclude": ["node_modules","**/__tests__/*"]
}
Step 10:- Add the following code in src/index.ts file
JavaScript
//src/index.ts
export class StringtoLowercase{
static ToLower(stringName:string) {
let lower = "";
for (var i = 0; i < stringName.length; i++) {
var value = stringName.charCodeAt(i);
if (value >= 65 && value <= 90) {
lower += String.fromCharCode(value + 32);
}
else {
lower += stringName[i];
}
}
console.log(lower);
}
}
Step 11:- Modify the package.json file.
1. In script object change the "test" to "build" and give the value "tsc".
build successfully and create file and folder2. Save the file and build the project with the following command:
npm run build
3. It will create a lib folder and inside the lib folder two file like index.d.ts and index.js will be created.

4. Go to .gitignore file and add lib folder which which will not be pushed to GitHub repository.
add lib folder5. Go to package.json file and add the file object.
add file object6. Update the entry point of file and types.
change main and add types object and add prepare key in Script object7. Check the git status (using this command: "git status") and push this code in GitHub repository by following the step5.
Steps to Publish NPM Package:-
Step 1:- Create the NPM account and go to profile and click on package button(If there is any package it will show otherwise no package found message will show )
go to profileStep 2:- Then go to vs code terminal and login with npm using the following command.
npm login
login npmStep 3: Check that you are login successfully or not using the following command.
npm whoami
Step 4: In the terminal, write the command to publish your npm package
npm publish
publish successfullyStep 5: Go to npm.com and go to packages you will find your published package.
published
Similar Reads
React Tutorial React is a powerful JavaScript library for building fast, scalable front-end applications. Created by Facebook, it's known for its component-based structure, single-page applications (SPAs), and virtual DOM,enabling efficient UI updates and a seamless user experience.Note: The latest stable version
7 min read
React Fundamentals
React IntroductionReactJS is a component-based JavaScript library used to build dynamic and interactive user interfaces. It simplifies the creation of single-page applications (SPAs) with a focus on performance and maintainability.React.jsWhy Use React?Before React, web development faced issues like slow DOM updates
7 min read
React Environment SetupTo run any React application, we need to first setup a ReactJS Development Environment. In this article, we will show you a step-by-step guide to installing and configuring a working React development environment.Pre-requisite:We must have Nodejs installed on our PC. So, the very first step will be
3 min read
React JS ReactDOMReactDOM is a core React package that provides methods to interact with the Document Object Model, or DOM. This package allows developers to access and modify the DOM. It is a package in React that provides DOM-specific methods that can be used at the top level of a web app to enable an efficient wa
3 min read
React JSXJSX stands for JavaScript XML, and it is a special syntax used in React to simplify building user interfaces. JSX allows you to write HTML-like code directly inside JavaScript, enabling you to create UI components more efficiently. Although JSX looks like regular HTML, itâs actually a syntax extensi
5 min read
ReactJS Rendering ElementsIn this article we will learn about rendering elements in ReactJS, updating the rendered elements and will also discuss about how efficiently the elements are rendered.What are React Elements?React elements are the smallest building blocks of a React application. They are different from DOM elements
3 min read
React ListsReact Lists are used to display a collection of similar data items like an array of objects and menu items. It allows us to dynamically render the array elements and display repetitive data.Rendering List in ReactTo render a list in React, we will use the JavaScript array map() function. We will ite
5 min read
React FormsForms are an essential part of any application used for collecting user data, processing payments, or handling authentication. React Forms are the components used to collect and manage the user inputs. These components include the input elements like text field, check box, date input, dropdowns etc.
5 min read
ReactJS KeysA key serves as a unique identifier in React, helping to track which items in a list have changed, been updated, or removed. It is particularly useful when dynamically creating components or when users modify the list. In this article, we'll explore ReactJS keys, understand their importance, how the
5 min read
Components in React
React ComponentsIn React, React components are independent, reusable building blocks in a React application that define what gets displayed on the UI. They accept inputs called props and return React elements describing the UI.In this article, we will explore the basics of React components, props, state, and render
4 min read
ReactJS Functional ComponentsIn ReactJS, functional components are a core part of building user interfaces. They are simple, lightweight, and powerful tools for rendering UI and handling logic. Functional components can accept props as input and return JSX that describes what the component should render.What are Reactjs Functio
5 min read
React Class ComponentsClass components are ES6 classes that extend React.Component. They allow state management and lifecycle methods for complex UI logic.Used for stateful components before Hooks.Support lifecycle methods for mounting, updating, and unmounting.The render() method in React class components returns JSX el
4 min read
ReactJS Pure ComponentsReactJS Pure Components are similar to regular class components but with a key optimization. They skip re-renders when the props and state remain the same. While class components are still supported in React, it's generally recommended to use functional components with hooks in new code for better p
4 min read
ReactJS Container and Presentational Pattern in ComponentsIn this article we will categorise the react components in two types depending on the pattern in which they are written in application and will learn briefly about these two categories. We will also discuss about alternatives to this pattern. Presentational and Container ComponentsThe type of compon
2 min read
ReactJS PropTypesIn ReactJS PropTypes are the property that is mainly shared between the parent components to the child components. It is used to solve the type validation problem. Since in the latest version of the React 19, PropeTypes has been removed. What is ReactJS PropTypes?PropTypes is a tool in React that he
5 min read
React Lifecycle In React, the lifecycle refers to the various stages a component goes through. These stages allow developers to run specific code at key moments, such as when the component is created, updated, or removed. By understanding the React lifecycle, you can better manage resources, side effects, and perfo
7 min read
React Hooks
Routing in React
Advanced React Concepts
React Projects