@dojo/cli-build-webpack

@dojo/cli-build

The official dojo 2 build command.

WARNING This is beta software. While we do not anticipate significant changes to the API at this stage, we may feel the need to do so. This is not yet production ready, so you should use at your own risk.

• Usage
• Features
  • Building
  • Building a custom element
  • Eject
• How to I contribute?
  • Installation
  • Testing
• Licensing information

Usage

To use @dojo/cli-build in a single project, install the package:

npm install @dojo/cli-build

to use @dojo/cli-build in every project, install the project globally:

npm install -g @dojo/cli-build

Features

@dojo/cli-build is an optional command for the @dojo/cli.

Building

To build a Dojo 2 application for publishing:

dojo build

This command will output the built files to the dist directory. After running this command, you can open the dist/index.html file to see your application.

You can also build in watch mode, which will automatically rebuild your application when it changes:

dojo build -w

@dojo/cli-build-webpack can be customized further. Use the help option to see everything you can do:

dojo build --help

Building a custom element

@dojo/cli-build-webpack can also build custom web elements as per the custom web v1 specification. Custom elements are built by providing the name of a custom element descriptor.

dojo build --element=src/path/to/createTheSpecialElement.ts

This will output a dist/the-special directory containing:

• the-special.js - JavaScript file containing code specific to the TheSpecial widget.
• widget-core.js - JavaScript file containing shared widget code. This is separated to allow for better caching by the browser.
• the-special.css - CSS relating to the TheSpecial widget.
• the-special.html - HTML import file that will import all the scripts and styles needed to use the element.

If the source file does not follow the pattern create[custom element]Element, @dojo/cli-build-webpack cannot determine what the name of the custom element should be. In this case, you can specify the --elementPrefix option to explicitly name the element.

dojo build --element=src/path/to/element.ts --elementPrefix=the-special

Eject

Ejecting @dojo/cli-build-webpack will produce a config/build-webpack/webpack.config.js file. You can run build using webpack with:

node_modules/.bin/webpack --config=config/build-webpack/webpack.config.js

How do I contribute?

We appreciate your interest! Please see the Dojo 2 Meta Repository for the Contributing Guidelines and Style Guide.

Installation

To start working with this package, clone the repository and run npm install.

In order to build the project run grunt dev or grunt dist.

Testing

Test cases MUST be written using Intern using the Object test interface and Assert assertion interface.

90% branch coverage MUST be provided for all code submitted to this repository, as reported by istanbul’s combined coverage results for all supported platforms.

To test locally in node run:

grunt test

Licensing information

© 2017 JS Foundation. New BSD license.