create-minimal-webpack-app

A minimal site generator using Webpack and friends.

Features

• HTML:: The index.html file is generated and automatically includes Webpack CSS/JS bundles using the HTML Webpack Plugin. It also can optionally include configured data passed down from package.json.
• CSS: The CSS Loader allows you to import CSS files in your JavaScript when needed. This CSS is compiled together and extracted to a main.css file by way of the Mini CSS Extract Plugin.
• JavaScript: No need to worry about compatibility in browsers, your code will be transpiled from ES2015 into something they can understand. Webpack installs and configures Babel for you.
• Assets: The URL Loader is installed for loading image/font assets as URLs, so you can use them in your JS/CSS with ease. Additionally, the public/ directory is populated with favicons and other files that are served statically.
• Linting: ESLint and Stylelint are automatically configured with recommended JS/CSS settings, and some additional helper rules. This can be found in the package.json for later editing.
• Development: Webpack Dev Server is installed so you can get to coding right away. It automatically reloads modules that change, so you can see changes without needing to refresh.
• Deployment: The yarn deploy task builds your app and deploys the dist/ directory to Surge. It's meant as a starting point, but Surge is a great hosting provider so there's no shame in keeping the default! Just make sure you add a -d YOUR_DOMAIN to the end so you don't get a random *.surge.sh domain each time you deploy.

Usage

With Yarn:

yarn create minimal-webpack-app your-app-name

With NPM:

npm install create-minimal-webpack-app
create-minimal-webpack-app your-app-name

You'll get an application directory with the following contents:

your-app-name
├── index.html
├── package.json
├── public
│   ├── android-chrome-192x192.png
│   ├── android-chrome-512x512.png
│   ├── favicon-16x16.png
│   ├── favicon-32x32.png
│   ├── favicon.ico
│   └── site.webmanifest
├── src
│   ├── index.css
│   └── index.js
├── webpack.config.js
└── yarn.lock

2 directories, 12 files

This will get you going with the bare minimum necessary to start developing.

Start the server by running:

yarn start

To run lint checks:

yarn lint

You can also build the application to dist/:

yarn build

Or, deploy to Surge using a random domain:

yarn deploy

NOTE: This will change domain names each time unless you pass a -d your-original-domain.surge.sh the next time you deploy.

Configuration

To configure the title of the app, edit app.title from package.json:

{
  "app": {
    "title": "Your App Name"
  }
}

You can use this object to pass additional configuration to your HTML:

{
  "app": {
    "title": "Your App Name",
    "heading": "Hello World"
  }
}

Read it out using EJS tags:

<h1><%= htmlWebpackPlugin.options.heading %></h1>