webpacker 5.0.1 → 6.0.0.beta

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: webpacker
 version: !ruby/object:Gem::Version
-  version: 5.0.1
+  version: 6.0.0.beta
 platform: ruby
 authors:
 - David Heinemeier Hansson
 - Gaurav Tiwari
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-03-24 00:00:00.000000000 Z
+date: 2020-12-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -85,16 +85,16 @@ dependencies:
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - '='
       - !ruby/object:Gem::Version
-        version: '0.69'
+        version: 0.93.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - '='
       - !ruby/object:Gem::Version
-        version: '0.69'
+        version: 0.93.1
 - !ruby/object:Gem::Dependency
   name: rubocop-performance
   requirement: !ruby/object:Gem::Requirement
@@ -109,7 +109,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: 
+description:
 email:
 - david@basecamp.com
 - gaurav@gauravtiwari.co.uk
@@ -119,10 +119,14 @@ extra_rdoc_files: []
 files:
 - ".eslintignore"
 - ".eslintrc.js"
+- ".github/workflows/jest.yml"
+- ".github/workflows/js-lint.yml"
+- ".github/workflows/rubocop.yml"
+- ".github/workflows/ruby.yml"
 - ".gitignore"
 - ".node-version"
 - ".rubocop.yml"
-- ".travis.yml"
+- 6_0_upgrade.md
 - CHANGELOG.md
 - CONTRIBUTING.md
 - Gemfile
@@ -130,78 +134,20 @@ files:
 - MIT-LICENSE
 - README.md
 - Rakefile
-- docs/assets.md
-- docs/cloud9.md
-- docs/css.md
-- docs/deployment.md
-- docs/docker.md
-- docs/engines.md
-- docs/env.md
-- docs/es6.md
-- docs/folder-structure.md
-- docs/integrations.md
-- docs/misc.md
-- docs/props.md
-- docs/testing.md
-- docs/troubleshooting.md
-- docs/typescript.md
-- docs/v4-upgrade.md
-- docs/webpack-dev-server.md
-- docs/webpack.md
-- docs/yarn.md
 - gemfiles/Gemfile-rails-edge
 - gemfiles/Gemfile-rails.5.2.x
 - gemfiles/Gemfile-rails.6.0.x
-- lib/install/angular.rb
 - lib/install/bin/webpack
 - lib/install/bin/webpack-dev-server
 - lib/install/binstubs.rb
-- lib/install/coffee.rb
-- lib/install/config/.browserslistrc
-- lib/install/config/babel.config.js
-- lib/install/config/postcss.config.js
+- lib/install/config/webpack/base.js
 - lib/install/config/webpack/development.js
-- lib/install/config/webpack/environment.js
 - lib/install/config/webpack/production.js
 - lib/install/config/webpack/test.js
 - lib/install/config/webpacker.yml
-- lib/install/elm.rb
-- lib/install/erb.rb
-- lib/install/examples/angular/hello_angular.js
-- lib/install/examples/angular/hello_angular/app/app.component.ts
-- lib/install/examples/angular/hello_angular/app/app.module.ts
-- lib/install/examples/angular/hello_angular/index.ts
-- lib/install/examples/angular/hello_angular/polyfills.ts
-- lib/install/examples/coffee/hello_coffee.coffee
-- lib/install/examples/elm/Main.elm
-- lib/install/examples/elm/hello_elm.js
-- lib/install/examples/erb/hello_erb.js.erb
-- lib/install/examples/react/babel.config.js
-- lib/install/examples/react/hello_react.jsx
-- lib/install/examples/react/tsconfig.json
-- lib/install/examples/stimulus/application.js
-- lib/install/examples/stimulus/controllers/hello_controller.js
-- lib/install/examples/stimulus/controllers/index.js
-- lib/install/examples/svelte/app.svelte
-- lib/install/examples/svelte/hello_svelte.js
-- lib/install/examples/typescript/hello_typescript.ts
-- lib/install/examples/typescript/tsconfig.json
-- lib/install/examples/vue/app.vue
-- lib/install/examples/vue/hello_vue.js
+- lib/install/javascript/packs/application.css
 - lib/install/javascript/packs/application.js
-- lib/install/loaders/coffee.js
-- lib/install/loaders/elm.js
-- lib/install/loaders/erb.js
-- lib/install/loaders/svelte.js
-- lib/install/loaders/typescript.js
-- lib/install/loaders/vue.js
-- lib/install/react.rb
-- lib/install/stimulus.rb
-- lib/install/svelte.rb
 - lib/install/template.rb
-- lib/install/typescript.rb
-- lib/install/vue.rb
-- lib/tasks/installers.rake
 - lib/tasks/webpacker.rake
 - lib/tasks/webpacker/binstubs.rake
 - lib/tasks/webpacker/check_binstubs.rake
@@ -237,12 +183,9 @@ files:
 - package/__tests__/production.js
 - package/__tests__/staging.js
 - package/__tests__/test.js
+- package/babel/preset.js
 - package/config.js
-- package/config_types/__tests__/config_list.js
-- package/config_types/__tests__/config_object.js
-- package/config_types/config_list.js
-- package/config_types/config_object.js
-- package/config_types/index.js
+- package/configPath.js
 - package/dev_server.js
 - package/env.js
 - package/environments/__tests__/base.js
@@ -252,30 +195,34 @@ files:
 - package/environments/test.js
 - package/index.js
 - package/rules/babel.js
+- package/rules/coffee.js
 - package/rules/css.js
+- package/rules/erb.js
 - package/rules/file.js
 - package/rules/index.js
-- package/rules/module.css.js
-- package/rules/module.sass.js
-- package/rules/node_modules.js
+- package/rules/less.js
 - package/rules/sass.js
-- package/utils/__tests__/deep_assign.js
-- package/utils/__tests__/deep_merge.js
-- package/utils/__tests__/get_style_rule.js
-- package/utils/__tests__/objectify.js
-- package/utils/deep_assign.js
-- package/utils/deep_merge.js
+- package/rules/svg.js
 - package/utils/get_style_rule.js
 - package/utils/helpers.js
-- package/utils/objectify.js
 - test/command_test.rb
 - test/compiler_test.rb
 - test/configuration_test.rb
 - test/dev_server_runner_test.rb
 - test/dev_server_test.rb
+- test/engine_rake_tasks_test.rb
 - test/env_test.rb
 - test/helper_test.rb
 - test/manifest_test.rb
+- test/mounted_app/Rakefile
+- test/mounted_app/test/dummy/Rakefile
+- test/mounted_app/test/dummy/bin/rails
+- test/mounted_app/test/dummy/bin/rake
+- test/mounted_app/test/dummy/config.ru
+- test/mounted_app/test/dummy/config/application.rb
+- test/mounted_app/test/dummy/config/environment.rb
+- test/mounted_app/test/dummy/config/webpacker.yml
+- test/mounted_app/test/dummy/package.json
 - test/rake_tasks_test.rb
 - test/test_app/Rakefile
 - test/test_app/app/javascript/packs/application.js
@@ -291,6 +238,7 @@ files:
 - test/test_app/config/webpacker_public_root.yml
 - test/test_app/package.json
 - test/test_app/public/packs/manifest.json
+- test/test_app/some.config.js
 - test/test_app/yarn.lock
 - test/test_helper.rb
 - test/webpack_runner_test.rb
@@ -301,9 +249,9 @@ homepage: https://github.com/rails/webpacker
 licenses:
 - MIT
 metadata:
-  source_code_uri: https://github.com/rails/webpacker/tree/v5.0.1
-  changelog_uri: https://github.com/rails/webpacker/blob/v5.0.1/CHANGELOG.md
-post_install_message: 
+  source_code_uri: https://github.com/rails/webpacker/tree/v6.0.0.beta
+  changelog_uri: https://github.com/rails/webpacker/blob/v6.0.0.beta/CHANGELOG.md
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -314,12 +262,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 2.4.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubygems_version: 3.0.3
-signing_key: 
+signing_key:
 specification_version: 4
 summary: Use webpack to manage app-like JavaScript modules in Rails
 test_files:
@@ -328,9 +276,19 @@ test_files:
 - test/configuration_test.rb
 - test/dev_server_runner_test.rb
 - test/dev_server_test.rb
+- test/engine_rake_tasks_test.rb
 - test/env_test.rb
 - test/helper_test.rb
 - test/manifest_test.rb
+- test/mounted_app/Rakefile
+- test/mounted_app/test/dummy/Rakefile
+- test/mounted_app/test/dummy/bin/rails
+- test/mounted_app/test/dummy/bin/rake
+- test/mounted_app/test/dummy/config.ru
+- test/mounted_app/test/dummy/config/application.rb
+- test/mounted_app/test/dummy/config/environment.rb
+- test/mounted_app/test/dummy/config/webpacker.yml
+- test/mounted_app/test/dummy/package.json
 - test/rake_tasks_test.rb
 - test/test_app/Rakefile
 - test/test_app/app/javascript/packs/application.js
@@ -346,6 +304,7 @@ test_files:
 - test/test_app/config/webpacker_public_root.yml
 - test/test_app/package.json
 - test/test_app/public/packs/manifest.json
+- test/test_app/some.config.js
 - test/test_app/yarn.lock
 - test/test_helper.rb
 - test/webpack_runner_test.rb

data/.travis.yml

@@ -1,43 +0,0 @@
-language: ruby
-dist: xenial
-before_install:
-  - gem install rubygems-update && update_rubygems
-  - yes | rvm @global do gem install bundler -v 2.1.4 || true
-rvm:
-  - 2.4.9
-  - 2.5.5
-  - 2.6.5
-  - 2.7.0
-  - ruby-head
-gemfile:
-  - gemfiles/Gemfile-rails.5.2.x
-  - gemfiles/Gemfile-rails.6.0.x
-  - gemfiles/Gemfile-rails-edge
-cache:
-  bundler: true
-  directories:
-    - node_modules
-  yarn: true
-
-install:
-  - bundle install --jobs 3 --retry 3
-  - nvm install 12
-  - node -v
-  - npm i -g yarn
-  - yarn
-script:
-  - yarn lint
-  - yarn test
-  - bundle exec rubocop
-  - bundle exec rake test
-matrix:
-  allow_failures:
-    - gemfile: gemfiles/Gemfile-rails-edge
-    - rvm: ruby-head
-  exclude:
-    - rvm: 2.4.9
-      gemfile: gemfiles/Gemfile-rails-edge
-    - rvm: 2.5.5
-      gemfile: gemfiles/Gemfile-rails-edge
-    - rvm: 2.4.9
-      gemfile: gemfiles/Gemfile-rails.6.0.x

data/docs/assets.md

@@ -1,119 +0,0 @@
-# Assets
-
-
-Static assets like images and fonts support is enabled out-of-box
-and you can link them into your JavaScript app code and have them
-compiled automatically.
-
-
-## Import from node modules
-
-You can also import styles from `node_modules` using the following syntax.
-Please note that your styles will always be extracted into `[pack_name].css`:
-
-```sass
-// app/javascript/styles.sass
-// ~ to tell webpack that this is not a relative import:
-
-@import '~@material/animation/mdc-animation'
-@import '~bootstrap/dist/css/bootstrap'
-```
-
-```js
-// Your main app pack
-// app/javascript/packs/app.js
-
-import '../styles'
-```
-
-```erb
-<%# In your views %>
-
-<%= javascript_pack_tag 'app' %>
-<%= stylesheet_pack_tag 'app' %>
-```
-
-
-## Import from Sprockets using helpers
-
-It's possible to link to assets that have been precompiled by Sprockets. Add the `.erb` extension to your JavaScript file, then you can use Sprockets' asset helpers:
-
-```erb
-<%# app/javascript/my_pack/example.js.erb %>
-
-<% helpers = ActionController::Base.helpers %>
-const railsImagePath = "<%= helpers.image_path('rails.png') %>"
-```
-
-This is enabled by the `rails-erb-loader` loader rule in `config/webpack/loaders/erb.js`.
-
-
-## Using babel module resolver
-
-You can also use [babel-plugin-module-resolver](https://github.com/tleunen/babel-plugin-module-resolver) to reference assets directly from `app/assets/**`
-
-```bash
-yarn add babel-plugin-module-resolver
-```
-
-Specify the plugin in your `babel.config.js` with the custom root or alias. Here's an example:
-
-```js
-{
-  plugins: [
-    [require("babel-plugin-module-resolver").default, {
-      "root": ["./app"],
-      "alias": {
-        "assets": "./assets"
-      }
-    }]
-  ]
-}
-```
-
-And then within your javascript app code:
-
-```js
-// Note: we don't have to do any ../../ jazz
-
-import FooImage from 'assets/images/foo-image.png'
-import 'assets/stylesheets/bar'
-```
-
-
-## Link in your Rails views
-
-You can also link `js/images/styles/fonts` used within your js app in views using
-`asset_pack_path` and `image_pack_tag` helpers. These helpers are useful in cases where you just want to
-create a `<link rel="prefetch">` or `<img />` for an asset.
-
-```yml
-app/javascript:
-  - packs
-    - app.js
-  - images
-    - calendar.png
-```
-
-```js
-// app/javascript/packs/app.js (or any of your packs)
-
-// import all image files in a folder:
-require.context('../images', true)
-```
-
-```erb
-<%# Rails view, for example app/views/layouts/application.html.erb %>
-
-<img src="<%= asset_pack_path 'media/images/calendar.png' %>" />
-<% # => <img src="/packs/media/images/calendar-k344a6d59eef8632c9d1.png" /> %>
-
-<%= image_pack_tag 'media/images/calendar.png' %>
-<% # => <img src="/packs/media/images/calendar-k344a6d59eef8632c9d1.png" /> %>
-
-<%# no path resolves to default 'images' folder: %>
-<%= image_pack_tag 'calendar.png' %>
-<% # => <img src="/packs/media/images/calendar-k344a6d59eef8632c9d1.png" /> %>
-```
-
-Note you need to add a `media/` prefix (not `/media/`) to any subfolder structure you might have in `app/javascript`. See more examples in the [tests](https://github.com/rails/webpacker/blob/0b86cadb5ed921e2c1538382e72a236ec30a5d97/test/helper_test.rb#L37).

data/docs/cloud9.md

@@ -1,310 +0,0 @@
-# Webpack dev server and Rails on Cloud9
-
-**Please note that this article is particularly relevant when
-migrating the [`webpacker`] gem from v3.0.1 to v3.0.2, as described in
-the [below](#binstub-versions).**
-
-[**`[Go to tl;dr]`**](#tldr)
-
-## Contents
-
-  - [Context](#context)
-  - [Binstub versions](#binstub-versions)
-  - [Quick solution](#quick-solution)
-  - [Flexible solution](#flexible-solution)
-  - [Sources](#sources)
-  - [Versions](#versions)
-  - [tl;dr](#tldr)
-
-## Context
-
-This article describes how to properly configure
-[`webpack-dev-server`] with [`webpacker`] gem on a [Cloud9] workspace.
-After a preliminary remark about the proper binstub version of the
-`./bin/webpack-dev-server` script, this article presents two ways to
-tackle the task: a simple and [quick solution](#quick-solution), which
-is sufficient if we work alone on a project, and a slightly more
-involved but [flexible approach](#flexible-solution), that can be
-useful when several people might work in the same codebase.
-
-[Cloud9]: https://c9.io
-[`webpack-dev-server`]: https://github.com/webpack/webpack-dev-server
-[`webpacker`]: https://github.com/rails/webpacker
-
-## Binstub versions
-
-A lot of the confusion about the [`webpack-dev-server`] options and
-why they might not be properly taken into account, might be due to an
-outdated version of the `./bin/webpack-dev-server` script. The script
-created by the `rails webpacker:install` task of the [`webpacker`] gem
-v3.0.1 ([source][v3.0.1/lib/install/bin/webpack-dev-server.tt]) is not
-compatible with how v3.0.2 (sic) of the gem handles the
-[`webpack-dev-server`] option flags (see full list of
-[versions](#versions) below), which logically expects the
-corresponding [binstub version][#833] of the script
-([source][v3.0.2/exe/webpack-dev-server]). So please make sure that
-you are using the [correct binstub][v3.0.2/exe/webpack-dev-server]
-(the same applies to [`./bin/webpack`][v3.0.2/exe/webpack]). To be
-fair, the [changelog of v3.0.2] properly mentions the change:
-
-> - Added: Binstubs [#833]
-> - (...)
-> - Removed: Inline CLI args for dev server binstub, use env variables
-  instead
-
-[changelog of v3.0.2]: https://github.com/rails/webpacker/blob/v3.0.2/CHANGELOG.md#302---2017-10-04
-[v3.0.1/lib/install/bin/webpack-dev-server.tt]: https://github.com/rails/webpacker/blob/v3.0.1/lib/install/bin/webpack-dev-server.tt
-[v3.0.2/exe/webpack-dev-server]: https://github.com/rails/webpacker/blob/v3.0.2/exe/webpack-dev-server
-[v3.0.2/exe/webpack]: https://github.com/rails/webpacker/blob/v3.0.2/exe/webpack
-[#833]: https://github.com/rails/webpacker/pull/833/files
-
-## Quick solution
-
-If you are working alone, the easiest way to fix the configuration of
-the [`webpack-dev-server`] is to modify the `development.dev_server`
-entry of the `config/webpacker.yml` file.
-
-### `config/webpacker.yml` file
-
-The `development.dev_server` entry of the `config/webpacker.yml` file
-has to be changed from the following default values:
-
-```yaml
-dev_server:
-  https: false
-  host: localhost
-  port: 3035
-  public: localhost:3035
-  hmr: false
-  # Inline should be set to true if using HMR
-  inline: true
-  overlay: true
-  disable_host_check: true
-  use_local_ip: false
-```
-
-into these custom configuration:
-
-```yaml
-dev_server:
-  https: true
-  host: localhost
-  port: 8082
-  public: your-workspace-name-yourusername.c9users.io:8082
-  hmr: false
-  inline: false
-  overlay: true
-  disable_host_check: true
-  use_local_ip: false
-```
-
-You can obtain the value `your-workspace-name-yourusername.c9users.io`
-for your [Cloud9] workspace with `echo ${C9_HOSTNAME}`.
-
-There are four main differences with the approaches found in the
-mentioned [sources](#sources):
-
-- Some solutions suggested to set the [`host`][devserver-host] option
-  to `your-workspace-name-yourusername.c9users.io`, which required to
-  add a line to the `/etc/hosts` file by running `echo "0.0.0.0
-  ${C9_HOSTNAME}" | sudo tee -a /etc/hosts`. This was only necessary
-  due to restrictions in previous versions of [`webpacker`] and how
-  the value of the [`public`][devserver-public] setting was
-  calculated. Currently it is [no longer necessary][pr-comment-hosts]
-  to modify the `/etc/hosts` file because the [`host`][devserver-host]
-  setting can be kept as `localhost`.
-
-[pr-comment-hosts]: https://github.com/rails/webpacker/pull/1033#pullrequestreview-78992024
-
-- Some solutions stressed the need to set the
-  [`https`][devserver-https] option to `false` but this failed with
-  `net::ERR_ABORTED` in the browser console and raised the following
-  exception in the server when the client tried to get the
-  JavaScript sources:
-
-  ```
-  #<OpenSSL::SSL::SSLError: SSL_connect SYSCALL returned=5 errno=0 state=unknown state>
-  ```
-
-  Setting `https: true` removes the issue.
-
-- By leaving the [`inline`][devserver-inline] option to the default
-  `false` value, the live compilation still works but the browser
-  console constantly reports the following error:
-
-  ```
-  Failed to load https://your-workspace-name-yourusername.c9users.io:8082/sockjs-node/info?t=1511016561187: No 'Access-Control-Allow-Origin' header is present on the requested resource.
-  Origin 'https://your-workspace-name-yourusername.c9users.io' is therefore not allowed access. The response had HTTP status code 503.
-  ```
-
-  Setting `inline: false` removes the issue.
-
-
-- None of the solutions suggested to set the
-  [`public`][devserver-public] option in the `config/webpacker.yml`
-  file and some suggested to pass it to the `webpack-dev-server`
-  command line. By setting it in the configuration file we don't need
-  to care about it in the terminal.
-
-[devserver-host]: https://webpack.js.org/configuration/dev-server/#devserver-host
-[devserver-https]: https://webpack.js.org/configuration/dev-server/#devserver-https
-[devserver-inline]: https://webpack.js.org/configuration/dev-server/#devserver-inline
-[devserver-public]: https://webpack.js.org/configuration/dev-server/#devserver-public
-
-With this configuration, running as usual `./bin/webpack-dev-server`
-in one terminal and `./bin/rails s -b $IP -p $PORT` in another should
-work.
-
-## Flexible solution
-
-The previous solution is useful and fast to implement, but if you are
-working with other people on the same repo it can be tricky to
-maintain the proper configuration in the `config/webpacker.yml` file.
-Moreover, the hostname of your [Cloud9] workspace is hardcoded, so
-that the configuration is not portable.
-
-A hint about another way to configure the `webpack-dev-server` can be
-found in the [README of this repo][`webpacker` documentation]:
-
-> You can use environment variables as options supported by
-> webpack-dev-server in the form `WEBPACKER_DEV_SERVER_<OPTION>`.
-> Please note that these environment variables will always take
-> precedence over the ones already set in the configuration file.
-
-Note that when the configuration of the [`webpack-dev-server`] is
-tweaked with ENV variables, those same values _have to be passed_ to
-the `rails server` process as well in order to let it use the _same_
-configuration.
-
-Taking that into account, a flexible solution can be implemented using
-[`foreman`] with the following `Procfile.dev`:
-
-[`foreman`]: https://github.com/ddollar/foreman
-
-```Procfile
-web:        ./bin/rails server -b ${RAILS_SERVER_BINDING:-localhost} -p ${RAILS_SERVER_PORT:-3000}
-webpacker:  ./bin/webpack-dev-server
-```
-
-and this `bin/start` script:
-
-```bash
-#!/bin/bash
-
-# Immediately exit script on first error
-set -e -o pipefail
-
-APP_ROOT_FOLDER="$( cd "$( dirname "${BASH_SOURCE[0]}" )/.." && pwd )"
-cd "${APP_ROOT_FOLDER}"
-
-if [ -n "${C9_USER}" ]; then
-  # We are in a Cloud9 machine
-
-  # Make sure that Postgres is running
-  sudo service postgresql status || sudo service postgresql start
-
-  # Adapt the configuration of the webpack-dev-server
-  export APP_DOMAIN="${C9_HOSTNAME}"
-  export RAILS_SERVER_BINDING='0.0.0.0'
-  export RAILS_SERVER_PORT='8080'
-  export WEBPACKER_DEV_SERVER_PORT='8082'
-  export WEBPACKER_DEV_SERVER_HTTPS='true'
-  export WEBPACKER_DEV_SERVER_HOST="localhost"
-  export WEBPACKER_DEV_SERVER_PUBLIC="${C9_HOSTNAME}:${WEBPACKER_DEV_SERVER_PORT}"
-  export WEBPACKER_DEV_SERVER_HMR='false'
-  export WEBPACKER_DEV_SERVER_INLINE='false'
-  export WEBPACKER_DEV_SERVER_OVERLAY='true'
-  export WEBPACKER_DEV_SERVER_DISABLE_HOST_CHECK='true'
-  export WEBPACKER_DEV_SERVER_USE_LOCAL_IP='false'
-fi
-
-foreman start -f Procfile.dev
-```
-
-With these two scripts in place, the application can always be started
-by running `bin/start`, in both [Cloud9] and other systems. The
-trick is that by exporting the `WEBPACKER_DEV_SERVER_*` variables
-before calling `foreman start`, we make sure that those values are
-available to both `webpack-dev-server` and `rails server` processes.
-
-## Sources
-
-- ["Webpack dev server and Rails on Cloud9"][original-article] (the
-  original source for the present article, inspired by this
-  [comment][original-comment])
-- ["Making Webpacker run on Cloud 9"] (GitHub issue)
-- ["Anyone here got webpack-dev-server to work on Cloud 9?"] (GitHub issue)
-- [`webpacker` documentation]
-- [`webpacker/dev_server.rb` code]
-- [`webpack-dev-server` documentation]
-- ["Using Rails With Webpack in Cloud 9"] (blog article)
-
-[original-article]: http://rbf.io/en/blog/2017/11/18/webpack-dev-server-and-rails-on-cloud9/
-[original-comment]: https://github.com/rails/webpacker/issues/176#issuecomment-345532309
-["Making Webpacker run on Cloud 9"]: https://github.com/rails/webpacker/issues/176
-["Anyone here got webpack-dev-server to work on Cloud 9?"]: https://github.com/webpack/webpack-dev-server/issues/230
-[`webpacker` documentation]: https://github.com/rails/webpacker/tree/v3.0.2#development
-[`webpacker/dev_server.rb` code]: https://github.com/rails/webpacker/blob/v3.0.2/lib/webpacker/dev_server.rb#L55
-[`webpack-dev-server` documentation]: https://webpack.js.org/configuration/dev-server/
-["Using Rails With Webpack in Cloud 9"]: http://aalvarez.me/blog/posts/using-rails-with-webpack-in-cloud-9.html
-
-## Versions
-
-Since things in this ecosystem move fast, it's important to mention the
-versions of the world for which this documentation is relevant:
-
-```shell
-$ egrep '^    ?(ruby|webpacker|rails) ' Gemfile.lock
-    rails (5.1.4)
-    webpacker (3.0.2)
-  ruby 2.4.2p198
-
-$ yarn versions
-yarn versions v1.1.0
-{ http_parser: '2.7.0',
-  node: '8.5.0',
-  v8: '6.0.287.53',
-  uv: '1.14.1',
-  zlib: '1.2.11',
-  ares: '1.10.1-DEV',
-  modules: '57',
-  nghttp2: '1.25.0',
-  openssl: '1.0.2l',
-  icu: '59.1',
-  unicode: '9.0',
-  cldr: '31.0.1',
-  tz: '2017b' }
-
-$ cat /etc/os-release | head -6
-NAME="Ubuntu"
-VERSION="14.04.5 LTS, Trusty Tahr"
-ID=ubuntu
-ID_LIKE=debian
-PRETTY_NAME="Ubuntu 14.04.5 LTS"
-VERSION_ID="14.04"
-```
-
-Everything was tested using Chrome Version 62.
-
-## tl;dr
-
-1. Make sure that you are running the [proper binstub
-   version](#binstub-versions) of `./bin/webpack-dev-server`.
-
-1. Change the `development.dev_server` entry `config/webpacker.yml` file into:
-
-    ```yaml
-    dev_server:
-      https: true
-      host: localhost
-      port: 8082
-      public: your-workspace-name-yourusername.c9users.io:8082
-      hmr: false
-      inline: false
-      overlay: true
-      disable_host_check: true
-      use_local_ip: false
-    ```
-
-1. Now running as usual `./bin/webpack-dev-server` in one terminal and
-   `./bin/rails s -b $IP -p $PORT` in another should work as expected.