Intro
Open source has been a game-changer for us all, it’s even crucial for software developers. I mean none between us can say he never used open-sourced things.
Sometimes we feel like we can add our piece to the puzzle but for some reasons we don’t, I’ve been doing little open source since the start of my career but today I wanted to create my own NPM package … if you read this article maybe you want to follow that route too.
Let me tell you it’s easy to create an NPM package, but not easy to create a helpful package, the one that will be used by at least a thousand of professionals around the globe.
I would advise you not to stay with the focus of creating something no matter what, but rather converting problems you solve daily in packages others can use without spending hours solving the same things.
We all know how lazy we Software developers are, I’m not an exception then I’ll use your useful package too 🤓
My First Package
Basically I created my first NPM package, it had 30 installations during the first day, 70 installations 48 hours after its inception, 108 downloads three days later and now it’s
Quite motivating to do more, not only because it’s used by other developers but primarily because I really depend on open source myself.
It’s called paykickstart-ipn-validator, its only and unique purpose is to validate incoming IPN notifications got from PayKickStart.
To better the funnel of your App sold via a third-party service you often need to do further actions once payment/refund/subscribe/unsubscribe operations are made via your sales/dashboard/landing pages, doing this without confirming the validity of the notification will fail your workflow as not only the intended party can send requests to your server (IPN receiver/controller).
You can install it just by hitting this:
$ npm install paykickstart-ipn-validator --save
It’s open-source, you can grab it over on GitHub.
Publishing Steps
Here are the steps I used to have my package up and running in no more than 1 hour assuming you have your code built already in your machine.
- Create a git repo for your package if it’s open-source, let’s not that private NPM packages can be published too
- Sign up at npmjs.com
- There are some required and/or important things to do into your repo so that it looks professional as the other you used to pay attention to. I would advise using this template to have all these metadata defined, you then need to update with your own details
- Setting up a Travis build so that it triggers your test anytime you commit/merge on the master branch, it’s good to have the build status of your package anytime so that we’ll feel safe using a particular working version (any Travis alternative will do)
- From your package root folder in the command line, hit npm login to sign in using your NPM account then npm publish to send all to the NPM registry, yep it’s done 😉
Note: To better understand the structure of the package.json file you can read the official guide.
Conclusion
In this short tutorial, we highlighted the basic steps needed in order to publish an NPM package to the NPM registry, no magic, no extra thing, straight to the point and I hope it’s easy to follow by all developers regardless of their level to do the same.
Thanks for reading