Skip to content
Browse files
Make webpack dev server config to be more useful
Don't rebuild the docs constantly, use the nice webpack livereload
feature instead. Changes are now instantaneous when working with CSS/JS
  • Loading branch information
agjohnson committed May 2, 2020
1 parent 3503493 commit 0eab0dcbdfd3fddc4a76aec1bb2f8abb7f888036
Showing 1 changed file with 13 additions and 8 deletions.
@@ -8,24 +8,29 @@ const common = require("./webpack.common.js");
module.exports = merge(common, {
mode: "development",
watch: true,
// The dev server uses both contentBase and publicPath. The contentBase is
// used to server the built docs, and publicPath is the bundle path for live
// reloading. The publicPath intercepts requests to the static assets in
// _static/. Opening http://localhost:1919 is everything you need for
// development.
devServer: {
contentBase: path.join(__dirname, "docs/build/html"),
watchContentBase: true,
compress: false,
contentBase: "docs/build/html",
port: 1919,
open: false,
hot: false,
liveReload: true,
publicPath: "/_static/"
publicPath: "/_static/",
disableHostCheck: true,
headers: {
"Access-Control-Allow-Origin": "*"
plugins: [
new WatchPlugin({
files: ["./docs/**/*.rst", "./docs/**/*.py"]
new ShellPlugin({
onBuildEnd: ["make -C docs clean html"],
// dev=false here to force every build to trigger make, the default is
// first build only.
dev: false
onBuildStart: ["make -C docs clean html"],

0 comments on commit 0eab0dc

Please sign in to comment.