diff --git a/JAVASCRIPT.md b/JAVASCRIPT.md
new file mode 100644
index 0000000..f11f1fc
--- /dev/null
+++ b/JAVASCRIPT.md
@@ -0,0 +1,72 @@
+Flag for Drupal 8
+=================
+
+Contents:
+ * Introduction
+ * Install Node
+ * Use node to install yarn
+ * Working on flag javascript
+ * Building JavaScript
+
+Introduction
+------------
+
+We have a javascript environment that parallels that found in D8's core
+subdirectory. Modern javascript in the form of es6.js files are transpiled
+into backwards compatible javascript targeted to a list of supported browsers.
+
+This document is largely based on the following D8 core change record.
+
+https://www.drupal.org/node/2815083
+
+Install Node
+------------
+
+This depends largely on you operating system. A suitable package can be
+downloaded here.
+
+https://nodejs.org/en/download/current/
+
+Verifying node.
+
+This command can be used to report the installed version
+
+node --version
+
+Use node to install yarn
+------------------------
+
+This command can be used to install yarn
+
+npm i -g yarn
+
+Working on flag Javascript
+--------------------------
+
+When developing javaScript locally you can use the watcher to make changes and
+have them compiled as you save as well as generate source maps.
+
+cd % flag_root_directory %
+yarn install
+yarn run watch:js
+
+This watcher will only watch changes in files with the .es6.js extension.
+
+If you want to build source maps during development use, yarn run watch:js-dev.
+
+Building Javascript
+--------------------
+
+To build all javaScript run yarn run build:js. This will create .js transpiled
+versions of the .es6.js files. Source maps will not be included with the built
+files.
+
+If you want to only transpile a specific file you can pass the --file flag.
+
+yarn run build:js -- --file misc/drupal.es6.js
+
+
+
+
+
+