An Yeoman Generator to create a basic UMD structure

Usage no npm install needed!

<script type="module">
  import generatorUmd from '';



version: 0.1.0

Build Status

An Yeoman Generator to create a basic UMD (Universal Module Definition) structure.

Getting Started


This script is an Yeoman Generator, meant to be used with some modern Javascript tools such as npm and Bower.

Information on the generated module

  • The generated module will use the returnExportsGlobal definition from UMD.

  • It will provide support to both AMD(RequireJS), Node.js, Browserify and global namespace definition.

  • File definition for both npm and Bower package managers will be also generated along with the initial structure.

  • A simple Mocha test suit will be available with some dummy tests.


You will need to have at least npm previously installed on your machine.

  1. Install the Yeoman CLI
npm install -g yo
  1. Install the UMD Generator
npm install -g generator-umd

Generating your module

  1. Open your terminal, navigate to an empty folder destined to your module:
mkdir new-module
cd new-module/
  1. Run the generator:
yo umd
  1. Input the required information, the generator will ask you:
  • A module name
  • A description to your module (optional)
  • The repository URL for your module (optional)
  1. You should be ready to go!
  • Tests can be run using npm test command.
  • Please do not remove the comments metadata from the generated js file, see reasoning below.


Support a way of easily adding dependencies

If you need to consume other libraries from inside your module, you will have to take a look at the UMD spec and implement it by yourself.

I have plans to add this feature in a subgenerator, using the comment metadata from the generated module file.


In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality.


Released under the MIT License.