Alias npm submodules located in subdirectories
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Latest GitHub Tag Latest GitHub Release Total Downloads via GitHub Node.js Module Version Downloads via npm per Month

Alias npm submodules located in subdirectories

grunt-alias-npm-submodules is a Grunt plugin. It creates alias script files in the root directory of your npm module that forward to submodules located in subdirectories to make them accessible using the npm module’s name:

// Use this:

// Instead of this:

Getting Started

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install --save-dev grunt-alias-npm-submodules@latest

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:


Alias task

Run this task with the grunt alias command. Task targets, files and options may be specified according to the grunt Configuring tasks guide.



Type: Number or numeric String Default: 1 The level(s) of how deep the target file is nested in subdirectories.

Usage Examples

This will create a submodule.js alias file in the root directory:

alias: {
  options: {
    levels: 2
  partial: 'level_1/level_2/submodule.js'


├── submodule.js # The alias file
└── level_1/
    └── level_2/
        └── submodule.js

When changing options.levels to 1, the result will be:

├── level_2 # The alias subdirectory
│   └── submodule.js # The alias file
└── level_1/
    └── level_2/
        └── submodule.js


This is communist software. It is crafted with heart and soul to the best of the author’s knowledge and belief: Not for profit but to satisfy the concrete needs. Do whatever you want with it (as long as you keep the author’s copyright notice in all copies or substantial portions of it included) for free. Imagine how the world could be if others would produce and distribute their products for the same benefits and ask yourself why they’re actually not.


This software is licensed under MIT License.

Copyright © 2015 Christian Grete