Wondering what’s next for npm?Check out our public roadmap! »


    1.3.1 • Public • Published


    GitHub Actions version code size dependencies devDependencies

    ❯ npx npm-publish-files --help
    Usage: npm-publish-files [options] <dir>
    Copy special files `npm publish` always includes to a sub directory
      -V, --version         output the version number
      -f, --force           overwrite existing files (default: false)
      -c, --clean           remove files instead of copying (default: false)
      -i, --include <glob>  glob for additional files (default: [])
      -x, --exclude <glob>  glob to prevent copying files (default: [])
      -h, --help            display help for command

    If you want to build a large npm project into a sub folder dist/, but then treat that as the root directory for the published package, you will need to copy all other special files npm includes in the publish. Let npm-publish-files do that for you!


    This script will make sure all necessary files are copied to dist/ before running npm publish:

      "scripts": {
        "prepublishOnly": "npm-publish-files --force dist"

    Any additional files specified in the "file" property of package.json will also be copied.

    After this your are free to run npm publish dist.

    Files Copied

    npm-publish-files uses the npm-packlist package under the hood to determine which files to copy. Please read its readme to better understand the algorhithm.

    To copy additional files, supply one or more globs with the --include option. All matched files will be copied to <dir>.

    To exclude files from being copied, supply one or more globs with the --exclude option. These will be applied last, so they filter both the default files, as well as those matched via the --include option.


    npm i npm-publish-files

    DownloadsWeekly Downloads






    Unpacked Size

    24.7 kB

    Total Files


    Last publish


    • avatar