Webpack Workshop
Using the Vanilla JavaScript TodoMVC Example
Purpose
This was originally part of an ES6 training by Kent C. Dodds
Now I'm using it to teach people about Webpack:
Thanks
This codebase was originally taken from the TodoMVC project starting here. Big thanks to them!
Latest Workshop
This repo has been used to teach in several different places (egghead, Frontend Masters, etc.). If you're coming here
to follow along with that, then I recommend you follow the project setup for that (see below). The most recent and
up-to-date version of the workshop is the Frontend Masters workshop. This is a linear
workshop and starts with the FEM/00-original-project
branch. See
the slides.
Project Setup
This project assumes you have NodeJS v6 or greater installed. You should also have npm v3 or greater installed as well (this comes packaged with Node 6). You'll also need a recent version of git installed as well.
You may have come to this project from different varying sources. There are a different series of branches for each workshop/course I've done. To get started with the project, start with this:
- Sign up for a GitHub Account (if you don't already have one)
- Fork this repo
- Clone your fork
- In the directory you cloned the repository, run
git fetch --all
If you need help with these steps, you might check out this free Egghead.io course which can help you get things going.
Finally, based on which version of the project you're looking for (workshop, egghead, or Frontend Masters) you'll run one of the following commands in the cloned directory:
- ES6 Workshop:
npm run setup:workshop
- Egghead Course:
npm run setup:egghead
- Frontend Masters Workshop:
npm run setup:fem
If you get any failures at this point something is wrong and needs to be fixed. Remember, Google and StackOverflow are your friends.
You might find it helpful to see a list of the available branches. Run: git branch
for that.
Notes
Because Webpack 2 is currently in beta, there are issues with peerDependencies
, so you’ll have to use npm version 3 to be able to install the dependencies.
Updates
The ecosystem moves fast. So this section of the README will be dedicated to tracking changes in the ecosystem so you can follow the repo, but be aware of changes in the latest versions of the dependencies you'll be installing (or if there are better dependencies to use now).
- All courses
babel-preset-es2015-webpack
is no longer necessary for leveraging tree shaking. You can now just usebabel-preset-es2015
with a special configuration to indicate modules should not be transformed. More info
- Egghead Course
- Using
istanbul
is no longer necessary for checking code coverage and can actually be accomplished using special configuration inkarma.conf.js
with thekarma-coverage
plugin like this.
- Using
Contributing
Super nice that you're interested in contributing. Unfortunately things are pretty complex with how things are set up with branches for each section of the workshop. So feel free to file pull requests to indicate what needs to be changed but if I decide to implement a change in the workshop code, I'll probably just have to manually make the updates. Thanks!
LICENSE
MIT