Dojo-module-wrapper-webpack-plugin NPM

Wrap webpack code to run within a Dojo powered Web App

In many enterprise and even open source projects, you will likely stumble across an exising application which is based on the Dojo Toolkit. While (at the time of writing) the whole Web Development world is talking about Angular, React, Webpack, Babel and all those modern web development tools, framworks and platforms, many developers are confronted with extending mature tools using older (and sometimes) not up-to-date libraries. This plug-in aims to help developers to integrate today's web technologies into mature Dojo based applications, which will allow to modernize your application step-by-step.

Installation

The plug-in is being published through npm, so running the following installation command is sufficient to get started using this plug-in npm install --save-dev dojo-module-wrapper-webpack-plugin

Usage

This plug-in requires a valid webpack configuration. It should contain the following information:

const DojoModuleWrapperPlugin = require('dojo-module-wrapper-webpack-plugin');

module.exports = {
    entry: {
        app: '<entry point of main JS class>',
    },
    output: {
        libraryTarget: 'amd',
        filename: '<bundle destination>',
    },
    module: {
        // module transformations
    },

    plugins: [
        new DojoModuleWrapperPlugin({
            app: {
                baseUrl: '<the base URL your app-bundle is running>'
                moduleName: '<the full name of your bundle>'
            },
        }),
    ],

    externals: [
        // exclude dojo, dijit and dojox from bundling
        (context, request, callback) => {
            if (/^dojo/.test(request) ||
                /^dojox/.test(request) ||
                /^dijit/.test(request)
            ) {
                return callback(null, `amd ${request}`);
            }
            callback();
        },
    ],
};

Projects using this plug-in

Stay tuned, the first project using this plug-in will be open-sourced in the nearer future. If you have a project which is using this plug-in successfully, feel free to contribute to this section through a pull request.