Normally Pleasant Mixture
    Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    cost-of-modulespublic

    Cost of modules

    Find out which of your dependencies is slowing you down

    BuildStatus npm npm

    Find out which of your dependencies is causing bloat

    Install

    npm install -g cost-of-modules

    Usage

    Run cost-of-modules in the directory you are working in.

    Options

    --less Show the biggest 10 modules

    --yarn Use yarn instead of npm to install dependencies

    --no-install Skip installation

    --include-dev Include devDependencies as well - for 🚀 collaborator experience

    Show your support

    ⭐️ this repo

    Motivation

    I recently published a npm module (auto-install) and I wanted to know how many bytes am I making people download before they can use it. Turns out, it was a whopping 30M!

    More than space on disk, I want to optimise for install speed - setup is part of the user experience

    --

    Now, there are 3 things that you can do to make your npm package smaller

    1. Make sure all your workflow tools are in devDependencies and not in dependencies These include your build tools, testing frameworks, etc. Only dependencies get installed when someone installs your package. (That being said, for better collaborator experience, you should optimise for both)

    2. Only include the files you need by using files in your package.json or by including a .npmignore. More on that here.

    3. Use packages which do the job and take the least amount of space. For example, I realised that I did not need yargs, I only needed their parser yargs-parser which is much smaller.

    4. Bonus: Bundle all your code together and strip out the functions that you don't use - I still have to try this out. This could be the most impactful one.

    --

    In my case, the big size was because of # 3, the bunch of npm packages that I was using.

    You can't fix what you can't measure

    With npm 2.x, it was easy to find how much space is each of your dependencies taking. You could just look at the size of each directory in node_modules

    With npm 3, the packages are installed in flat manner, so it isn't so straightforward.

    That's the reason why I created this tool.

    --

    Future

    I would want to make this tool a pre-publish checklist.

    • See the size of your node_modules
    • Include the size of your files
    • Check if files or .npmignore exists
    • Check if there are any dev dependencies that are specified as dependencies (tricky)
    • Compare size with the last release. Something like this: Warning

    License

    MIT © siddharthkp

    install

    npm i cost-of-modules

    Downloadsweekly downloads

    360

    version

    1.0.1

    license

    MIT

    repository

    githubgithub

    last publish

    collaborators

    • avatar
    • avatar