diff --git a/.gitignore b/.gitignore
index d7223c6b87..17751ce051 100644
--- a/.gitignore
+++ b/.gitignore
@@ -8,6 +8,7 @@ logs
 *.log
 # npm pack
 *.tgz
+**/tests_output
 
 coverage
 
diff --git a/.travis.yml b/.travis.yml
index 0250f38df7..e37d79cef1 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -34,6 +34,10 @@ addons:
       # Fixes error while loading shared libraries: libgconf-2.so.4: cannot open shared object file: No such file or directory
       # https://github.com/electron/electron/issues/1518
       - libgconf-2-4
+      # Ensure chrome is the latest version
+      # https://stackoverflow.com/questions/57903415/travis-ci-chrome-62-instead-of-77
+      - dpkg
+  chrome: stable
 
 script: npx nyc -s npx aegir test -t node --timeout 10000 --bail
 after_success:
@@ -74,26 +78,26 @@ jobs:
         - npx aegir test -t electron-renderer --bail --timeout 10000
 
     - stage: test
-      name: interop node
+      name: interop - node
       script:
         - cd node_modules/ipfs-interop
         - IPFS_JS_EXEC=./../../src/cli/bin.js IPFS_REUSEPORT=false npx aegir test -t node --bail
 
     - stage: test
-      name: interop browser
+      name: interop - browser
       script:
         - cd node_modules/ipfs-interop
         - IPFS_JS_EXEC=./../../src/cli/bin.js IPFS_REUSEPORT=false npx aegir test -t browser --bail
 
     - stage: test
-      name: interop electron-main
+      name: interop - electron-main
       os: osx
       script:
         - cd node_modules/ipfs-interop
         - IPFS_JS_EXEC=./../../src/cli/bin.js IPFS_REUSEPORT=false npx aegir test -t electron-main -f ./test/node.js --bail --timeout 10000
 
     - stage: test
-      name: interop electron-renderer
+      name: interop - electron-renderer
       os: osx
       script:
         - cd node_modules/ipfs-interop
@@ -101,34 +105,178 @@ jobs:
 
     - stage: test
       if: branch =~ /^release\/.*$/
-      name: ipfs-companion
+      name: external - ipfs-companion
       script:
         - npm run test:external -- ipfs-companion https://github.com/ipfs-shipyard/ipfs-companion.git
 
     - stage: test
       if: branch =~ /^release\/.*$/
-      name: npm-on-ipfs
+      name: external - npm-on-ipfs
       script:
         - npm run test:external -- npm-on-ipfs https://github.com/ipfs-shipyard/npm-on-ipfs.git
 
     - stage: test
       if: branch =~ /^release\/.*$/
-      name: ipfs-pubsub-room
+      name: external - ipfs-pubsub-room
       script:
         - npm run test:external -- ipfs-pubsub-room https://github.com/ipfs-shipyard/ipfs-pubsub-room.git
 
     - stage: test
       if: branch =~ /^release\/.*$/
-      name: peer-base
+      name: external - peer-base
       script:
         - npm run test:external -- peer-base https://github.com/peer-base/peer-base.git
 
     - stage: test
       if: branch =~ /^release\/.*$/
-      name: service-worker-gateway
+      name: external - service-worker-gateway
       script:
         - npm run test:external -- service-worker-gateway https://github.com/ipfs-shipyard/service-worker-gateway.git
 
+    - stage: test
+      if: branch =~ /^release\/.*$/
+      name: example - browser-add-readable-stream
+      script:
+        - cd examples
+        - npm install
+        - npm run test -- browser-add-readable-stream
+
+    - stage: test
+      if: branch =~ /^release\/.*$/
+      name: example - browser-browserify
+      script:
+        - cd examples
+        - npm install
+        - npm run test -- browser-browserify
+
+    - stage: test
+      if: branch =~ /^release\/.*$/
+      name: example - browser-create-react-app
+      script:
+        - cd examples
+        - npm install
+        - npm run test -- browser-create-react-app
+
+    - stage: test
+      if: branch =~ /^release\/.*$/
+      name: example - browser-mfs
+      script:
+        - cd examples
+        - npm install
+        - npm run test -- browser-mfs
+
+    - stage: test
+      if: branch =~ /^release\/.*$/
+      name: example - browser-parceljs
+      script:
+        - cd examples
+        - npm install
+        - npm run test -- browser-parceljs
+
+    - stage: test
+      if: branch =~ /^release\/.*$/
+      name: example - browser-readablestream
+      script:
+        - cd examples
+        - npm install
+        - npm run test -- browser-readablestream
+
+    - stage: test
+      if: branch =~ /^release\/.*$/
+      name: example - browser-script-tag
+      script:
+        - cd examples
+        - npm install
+        - npm run test -- browser-script-tag
+
+    - stage: test
+      if: branch =~ /^release\/.*$/
+      name: example - browser-video-streaming
+      script:
+        - cd examples
+        - npm install
+        - npm run test -- browser-video-streaming
+
+    - stage: test
+      if: branch =~ /^release\/.*$/
+      name: example - browser-vue
+      script:
+        - cd examples
+        - npm install
+        - npm run test -- browser-vue
+
+    - stage: test
+      if: branch =~ /^release\/.*$/
+      name: example - browser-webpack
+      script:
+        - cd examples
+        - npm install
+        - npm run test -- browser-webpack
+
+    - stage: test
+      if: branch =~ /^release\/.*$/
+      name: example - circuit-relaying
+      script:
+        - cd examples
+        - npm install
+        - npm run test -- circuit-relaying
+
+    - stage: test
+      if: branch =~ /^release\/.*$/
+      name: example - custom-ipfs-repo
+      script:
+        - cd examples
+        - npm install
+        - npm run test -- custom-ipfs-repo
+
+    - stage: test
+      if: branch =~ /^release\/.*$/
+      name: example - custom-libp2p
+      script:
+        - cd examples
+        - npm install
+        - npm run test -- custom-libp2p
+
+    - stage: test
+      if: branch =~ /^release\/.*$/
+      name: example - exchange-files-in-browser
+      script:
+        - cd examples
+        - npm install
+        - npm run test -- exchange-files-in-browser
+
+    - stage: test
+      if: branch =~ /^release\/.*$/
+      name: example - explore-ethereum-blockchain
+      script:
+        - cd examples
+        - npm install
+        - npm run test -- explore-ethereum-blockchain
+
+    - stage: test
+      if: branch =~ /^release\/.*$/
+      name: example - ipfs-101
+      script:
+        - cd examples
+        - npm install
+        - npm run test -- ipfs-101
+
+    - stage: test
+      if: branch =~ /^release\/.*$/
+      name: example - running-multiple-nodes
+      script:
+        - cd examples
+        - npm install
+        - npm run test -- running-multiple-nodes
+
+    - stage: test
+      if: branch =~ /^release\/.*$/
+      name: example - traverse-ipld-graphs
+      script:
+        - cd examples
+        - npm install
+        - npm run test -- traverse-ipld-graphs
+
     - stage: tag
       # only run on changes to master
       if: branch = master AND type = push AND fork = false
diff --git a/examples/README.md b/examples/README.md
index 364977886a..0c08338979 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -49,3 +49,27 @@ In this section, you will find explanations to different pieces of IPFS Architec
 - Storing and Retrieving blocks (soon™)
 - IPLD (InterPlanetary Linked-Data) (soon™)
 - IPFS Networking - Managing your swarm, libp2p and more (soon™)
+
+## Adding new examples
+
+All examples should include a `test.js` file.  The implementation will differ depending on if your example is intended to run under node or the browser.
+
+### Browser `test.js`
+
+All browser examples should either be a whole webapp or a simple demo (e.g. just `index.html` and `index.js` files).
+
+#### Webapp
+
+Webapps must have a `package.json` that contains either a `build` or a `bundle` script.  This script should place all assets in a folder named `dist`, `build` or `public` including an `index.html` file.  During testing this will have a web server run over it using `http-server`.
+
+#### Simple demo
+
+Simple demos must have an `index.html` file in the root of the demo folder.  This file will be loaded in a browser and tested via a `file://` URL.
+
+#### Browser `test.js`
+
+Your `test.js` file should contain a [Nightwatch](https://www.npmjs.com/package/nightwatch) scenario that will be executed.  The URL to example will be present in the `IPFS_EXAMPLE_TEST_URL` environmental variable when the test is run.
+
+### Node
+
+Your `test.js` file should export an async function that sets up your test, runs any assertions, tears down anything set up and throws an error if the test fails.
diff --git a/examples/browser-add-readable-stream/index.html b/examples/browser-add-readable-stream/index.html
index dffc1ceed2..4c3b9a7499 100644
--- a/examples/browser-add-readable-stream/index.html
+++ b/examples/browser-add-readable-stream/index.html
@@ -1,7 +1,11 @@
+<!doctype html>
 <html>
+  <head>
+    <title>Add readable stream</title>
+  </head>
   <body>
     <pre id="output"></pre>
-    <script src="https://unpkg.com/ipfs/dist/index.js"></script>
+    <script src="../../dist/index.js"></script>
     <script src="index.js"></script>
   </body>
 </html>
diff --git a/examples/browser-add-readable-stream/test.js b/examples/browser-add-readable-stream/test.js
new file mode 100644
index 0000000000..87f76119ca
--- /dev/null
+++ b/examples/browser-add-readable-stream/test.js
@@ -0,0 +1,13 @@
+'use strict'
+
+module.exports = {
+  'Add readable stream example': function (browser) {
+    browser
+      .url(process.env.IPFS_EXAMPLE_TEST_URL)
+      .waitForElementVisible('#output')
+
+    browser.expect.element('#output').text.to.contain('directory/ QmVgJePRxp1vhRxDcJWdmuFGfUB5S5RYTtG1NR3bQM4BBn')
+
+    browser.end()
+  }
+}
diff --git a/examples/browser-browserify/package.json b/examples/browser-browserify/package.json
index c534b6030b..047d4c4fb4 100644
--- a/examples/browser-browserify/package.json
+++ b/examples/browser-browserify/package.json
@@ -11,10 +11,13 @@
   "keywords": [],
   "license": "MIT",
   "devDependencies": {
-    "ipfs": "file:../../",
     "browserify": "^16.2.3",
     "concat-stream": "^2.0.0",
-    "http-server": "~0.11.1"
+    "http-server": "~0.11.1",
+    "ipfs": "file:../../"
   },
-  "dependencies": {}
+  "dependencies": {},
+  "browser": {
+    "ipfs": "ipfs/dist"
+  }
 }
diff --git a/examples/browser-browserify/public/index.html b/examples/browser-browserify/public/index.html
index a2ea58def4..041385a09d 100644
--- a/examples/browser-browserify/public/index.html
+++ b/examples/browser-browserify/public/index.html
@@ -14,9 +14,9 @@
   </head>
   <body>
     <h1>JS IPFS - Add data to IPFS from the browser</h1>
-    <textarea id="source"></textarea>
-    <button id="store">add to ipfs</button>
-    <div>
+    <textarea id="source" placeholder="Enter some text here"></textarea>
+    <button id="store">Add text to ipfs</button>
+    <div id="output" style="display: none">
       <div>found in ipfs:</div>
       <div class="content" id="hash">[ipfs hash]</div>
       <div class="content" id="content">[ipfs content]</div>
diff --git a/examples/browser-browserify/src/index.js b/examples/browser-browserify/src/index.js
index afea210ea0..af565ae325 100644
--- a/examples/browser-browserify/src/index.js
+++ b/examples/browser-browserify/src/index.js
@@ -9,22 +9,23 @@ document.addEventListener('DOMContentLoaded', async () => {
 
   async function store () {
     const toStore = document.getElementById('source').value
+    const result = await node.add(toStore)
 
-    const res = await node.add(toStore)
-
-    res.forEach((file) => {
+    for (const file of result) {
       if (file && file.hash) {
         console.log('successfully stored', file.hash)
-        display(file.hash)
+
+        await display(file.hash)
       }
-    })
+    }
   }
 
   async function display (hash) {
-    // buffer: true results in the returned result being a buffer rather than a stream
     const data = await node.cat(hash)
+
     document.getElementById('hash').innerText = hash
     document.getElementById('content').innerText = data
+    document.getElementById('output').setAttribute('style', 'display: block')
   }
 
   document.getElementById('store').onclick = store
diff --git a/examples/browser-browserify/test.js b/examples/browser-browserify/test.js
new file mode 100644
index 0000000000..4b729108d4
--- /dev/null
+++ b/examples/browser-browserify/test.js
@@ -0,0 +1,21 @@
+'use strict'
+
+const pkg = require('./package.json')
+
+module.exports = {
+  [pkg.name]: function (browser) {
+    browser
+      .url(process.env.IPFS_EXAMPLE_TEST_URL)
+      .waitForElementVisible('#source')
+      .setValue('#source', 'hello')
+      .waitForElementVisible('#store')
+      .pause(1000)
+      .click('#store')
+      .waitForElementVisible('#output')
+
+    browser.expect.element('#hash').text.to.contain('QmWfVY9y3xjsixTgbd9AorQxH7VtMpzfx2HaWtsoUYecaX')
+    browser.expect.element('#content').text.to.contain('hello')
+
+    browser.end()
+  }
+}
diff --git a/examples/browser-create-react-app/package.json b/examples/browser-create-react-app/package.json
index be623e00d0..37734fb3e3 100644
--- a/examples/browser-create-react-app/package.json
+++ b/examples/browser-create-react-app/package.json
@@ -8,7 +8,7 @@
     "ipfs-css": "^0.13.1",
     "react": "^16.8.0",
     "react-dom": "^16.8.0",
-    "react-scripts": "3.1.1",
+    "react-scripts": "^3.2.0",
     "tachyons": "^4.11.1"
   },
   "scripts": {
diff --git a/examples/browser-create-react-app/src/App.js b/examples/browser-create-react-app/src/App.js
index 8d8a20d483..f742be5208 100755
--- a/examples/browser-create-react-app/src/App.js
+++ b/examples/browser-create-react-app/src/App.js
@@ -36,12 +36,12 @@ const IpfsId = (props) => {
   if (!props) return null
   return (
     <section className='bg-snow mw7 center mt5'>
-      <h1 className='f3 fw4 ma0 pv3 aqua montserrat tc'>Connected to IPFS</h1>
+      <h1 className='f3 fw4 ma0 pv3 aqua montserrat tc' data-test='title'>Connected to IPFS</h1>
       <div className='pa4'>
         {['id', 'agentVersion'].map((key) => (
           <div className='mb4' key={key}>
             <Title>{key}</Title>
-            <div className='bg-white pa2 br2 truncate monospace'>{props[key]}</div>
+            <div className='bg-white pa2 br2 truncate monospace' data-test={key}>{props[key]}</div>
           </div>
         ))}
       </div>
diff --git a/examples/browser-create-react-app/src/hooks/use-ipfs-factory.js b/examples/browser-create-react-app/src/hooks/use-ipfs-factory.js
index 31c88fe08e..fa0464d484 100644
--- a/examples/browser-create-react-app/src/hooks/use-ipfs-factory.js
+++ b/examples/browser-create-react-app/src/hooks/use-ipfs-factory.js
@@ -25,7 +25,7 @@ export default function useIpfsFactory ({ commands }) {
     return function cleanup () {
       if (ipfs && ipfs.stop) {
         console.log('Stopping IPFS')
-        ipfs.stop()
+        ipfs.stop().catch(err => console.error(err))
         setIpfsReady(false)
       }
     }
diff --git a/examples/browser-create-react-app/test.js b/examples/browser-create-react-app/test.js
new file mode 100644
index 0000000000..812769aca0
--- /dev/null
+++ b/examples/browser-create-react-app/test.js
@@ -0,0 +1,16 @@
+'use strict'
+
+const pkg = require('./package.json')
+
+module.exports = {
+  [pkg.name]: function (browser) {
+    browser
+      .url(process.env.IPFS_EXAMPLE_TEST_URL)
+      .waitForElementVisible('[data-test=title]')
+      .assert.containsText('[data-test=title]', 'Connected to IPFS')
+      .assert.elementPresent('[data-test=id')
+      .assert.elementPresent('[data-test=agentVersion')
+      .end()
+  }
+}
+
diff --git a/examples/browser-mfs/package.json b/examples/browser-mfs/package.json
index c6558793c8..47dc9915a2 100644
--- a/examples/browser-mfs/package.json
+++ b/examples/browser-mfs/package.json
@@ -18,7 +18,7 @@
     "webpack-cli": "^3.0.8"
   },
   "dependencies": {
-    "ipfs": "../../",
+    "ipfs": "file:../../",
     "mime-sniffer": "~0.0.3"
   }
 }
diff --git a/examples/browser-mfs/test.js b/examples/browser-mfs/test.js
new file mode 100644
index 0000000000..59f88a0460
--- /dev/null
+++ b/examples/browser-mfs/test.js
@@ -0,0 +1,47 @@
+'use strict'
+
+const pkg = require('./package.json')
+
+module.exports = {
+  [pkg.name]: function (browser) {
+    browser
+      .url(process.env.IPFS_EXAMPLE_TEST_URL)
+      .waitForElementNotVisible('#modal-screen')
+      .waitForElementVisible('#log')
+
+    browser.expect.element('#log').text.to.contain('IPFS: Drop some files into this window to get started')
+
+    browser.waitForElementVisible('#button-mkdir')
+      .click('#button-mkdir')
+      .waitForElementVisible('#form-mkdir-path')
+      .clearValue('#form-mkdir-path')
+      .setValue('#form-mkdir-path', '/folder')
+      .click('#button-form-mkdir-submit')
+
+    browser.expect.element('#files').text.to.contain('folder/')
+
+    browser.click('#button-cp')
+      .waitForElementVisible('#form-cp-path')
+      .clearValue('#form-cp-path')
+      .setValue('#form-cp-path', '/folder')
+      .clearValue('#form-cp-dest')
+      .setValue('#form-cp-dest', '/folder-copy')
+      .click('#button-form-cp-submit')
+
+    browser.expect.element('#files').text.to.contain('folder-copy/')
+
+    browser.click('#button-mv')
+      .waitForElementVisible('#form-mv-path')
+      .clearValue('#form-mv-path')
+      .setValue('#form-mv-path', '/folder')
+      .clearValue('#form-mv-dest')
+      .setValue('#form-mv-dest', '/folder-other')
+      .click('#button-form-mv-submit')
+
+    browser.expect.element('#files').text.to.not.contain('folder/')
+    browser.expect.element('#files').text.to.contain('folder-other/')
+
+    browser.end()
+  }
+}
+
diff --git a/examples/browser-parceljs/test.js b/examples/browser-parceljs/test.js
new file mode 100644
index 0000000000..ad5f99558a
--- /dev/null
+++ b/examples/browser-parceljs/test.js
@@ -0,0 +1,15 @@
+'use strict'
+
+const pkg = require('./package.json')
+
+module.exports = {
+  [pkg.name]: function (browser) {
+    browser
+      .url(process.env.IPFS_EXAMPLE_TEST_URL)
+      .waitForElementVisible('#output')
+
+    browser.expect.element('#output').text.to.contain('The contents of the file was: Hello from parcel.js bundled ipfs example')
+
+    browser.end()
+  }
+}
diff --git a/examples/browser-readablestream/test.js b/examples/browser-readablestream/test.js
new file mode 100644
index 0000000000..7434853ba8
--- /dev/null
+++ b/examples/browser-readablestream/test.js
@@ -0,0 +1,269 @@
+'use strict'
+
+const pkg = require('./package.json')
+
+module.exports = {
+  [pkg.name]: function (browser) {
+    browser
+      .url(process.env.IPFS_EXAMPLE_TEST_URL)
+      .waitForElementVisible('#output')
+
+    browser.expect.element('#output').text.to.contain('IPFS: Then press the "Go!" button to start playing a video')
+
+    browser.executeAsync(async function (done) {
+      const container = document.querySelector('#container')
+
+      // fake dropping a file
+      container.ondrop({
+        preventDefault: () => {},
+        dataTransfer: {
+          items: [{
+            kind: 'file',
+            getAsFile: () => {
+              // actually an .mp4 file, believe it or not
+              return [
+                0x00, 0x00, 0x00, 0x14, 0x66, 0x74, 0x79, 0x70,
+                0x71, 0x74, 0x20, 0x20, 0x00, 0x00, 0x00, 0x00,
+                0x71, 0x74, 0x20, 0x20, 0x00, 0x00, 0x00, 0x08,
+                0x77, 0x69, 0x64, 0x65, 0x00, 0x00, 0x00, 0xe0,
+                0x6d, 0x64, 0x61, 0x74, 0x00, 0x00, 0x00, 0x15,
+                0x06, 0x05, 0x11, 0x03, 0x87, 0xf4, 0x4e, 0xcd,
+                0x0a, 0x4b, 0xdc, 0xa1, 0x94, 0x3a, 0xc3, 0xd4,
+                0x9b, 0x17, 0x1f, 0x00, 0x80, 0x00, 0x00, 0x00,
+                0x23, 0x25, 0xb8, 0x08, 0x02, 0x02, 0x7f, 0xfa,
+                0x78, 0x1f, 0x03, 0xf4, 0x82, 0x9f, 0xb9, 0xc6,
+                0x5f, 0xef, 0x65, 0x2b, 0x9e, 0x18, 0xe1, 0x93,
+                0xfb, 0xfb, 0x3a, 0x7f, 0x3f, 0x5d, 0x6c, 0xe9,
+                0x20, 0xb9, 0x16, 0xe0, 0x00, 0x00, 0x00, 0x31,
+                0x25, 0x12, 0xe0, 0x20, 0x08, 0x09, 0xff, 0xfa,
+                0x78, 0x1f, 0x03, 0xf4, 0x82, 0x9f, 0xb9, 0xc6,
+                0x5f, 0xef, 0x65, 0x2b, 0x9e, 0x18, 0xe1, 0x93,
+                0xfb, 0xfb, 0x3a, 0x7f, 0x24, 0x94, 0x7d, 0x69,
+                0xbf, 0x5d, 0xcd, 0xe6, 0xa6, 0xc0, 0xf0, 0xa7,
+                0x91, 0xa8, 0x7c, 0x09, 0x66, 0xdf, 0x20, 0x89,
+                0xae, 0x00, 0x00, 0x00, 0x15, 0x06, 0x05, 0x11,
+                0x03, 0x87, 0xf4, 0x4e, 0xcd, 0x0a, 0x4b, 0xdc,
+                0xa1, 0x94, 0x3a, 0xc3, 0xd4, 0x9b, 0x17, 0x1f,
+                0x00, 0x80, 0x00, 0x00, 0x00, 0x08, 0x21, 0xe1,
+                0x09, 0x10, 0x4f, 0xfe, 0xaa, 0x8c, 0x00, 0x00,
+                0x00, 0x09, 0x21, 0x13, 0x84, 0x24, 0x41, 0x3f,
+                0xfe, 0xaa, 0x8c, 0x00, 0x00, 0x00, 0x15, 0x06,
+                0x05, 0x11, 0x03, 0x87, 0xf4, 0x4e, 0xcd, 0x0a,
+                0x4b, 0xdc, 0xa1, 0x94, 0x3a, 0xc3, 0xd4, 0x9b,
+                0x17, 0x1f, 0x00, 0x80, 0x00, 0x00, 0x00, 0x08,
+                0x01, 0xa8, 0x81, 0x62, 0x08, 0xff, 0x20, 0x20,
+                0x00, 0x00, 0x00, 0x08, 0x01, 0x12, 0xa2, 0x05,
+                0x88, 0x23, 0x20, 0x20, 0x00, 0x00, 0x05, 0xa6,
+                0x6d, 0x6f, 0x6f, 0x76, 0x00, 0x00, 0x00, 0x6c,
+                0x6d, 0x76, 0x68, 0x64, 0x00, 0x00, 0x00, 0x00,
+                0xd9, 0xc3, 0xbb, 0x69, 0xd9, 0xc3, 0xbb, 0x69,
+                0x00, 0x00, 0x17, 0x70, 0x00, 0x00, 0x00, 0x68,
+                0x00, 0x01, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x40, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02,
+                0x00, 0x00, 0x03, 0xc0, 0x74, 0x72, 0x61, 0x6b,
+                0x00, 0x00, 0x00, 0x5c, 0x74, 0x6b, 0x68, 0x64,
+                0x00, 0x00, 0x00, 0x0f, 0xd9, 0xc3, 0xbb, 0x69,
+                0xd9, 0xc3, 0xbb, 0x69, 0x00, 0x00, 0x00, 0x01,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x68,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00,
+                0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x40, 0x00, 0x00, 0x00, 0x00, 0x38, 0x00, 0x00,
+                0x00, 0x34, 0x00, 0x00, 0x00, 0x00, 0x00, 0x44,
+                0x74, 0x61, 0x70, 0x74, 0x00, 0x00, 0x00, 0x14,
+                0x63, 0x6c, 0x65, 0x66, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x38, 0x00, 0x00, 0x00, 0x34, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x14, 0x70, 0x72, 0x6f, 0x66,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x38, 0x00, 0x00,
+                0x00, 0x34, 0x00, 0x00, 0x00, 0x00, 0x00, 0x14,
+                0x65, 0x6e, 0x6f, 0x66, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x38, 0x00, 0x00, 0x00, 0x34, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x24, 0x65, 0x64, 0x74, 0x73,
+                0x00, 0x00, 0x00, 0x1c, 0x65, 0x6c, 0x73, 0x74,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01,
+                0x00, 0x00, 0x00, 0x68, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x02, 0x62,
+                0x6d, 0x64, 0x69, 0x61, 0x00, 0x00, 0x00, 0x20,
+                0x6d, 0x64, 0x68, 0x64, 0x00, 0x00, 0x00, 0x00,
+                0xd9, 0xc3, 0xbb, 0x69, 0xd9, 0xc3, 0xbb, 0x69,
+                0x00, 0x00, 0x17, 0x70, 0x00, 0x00, 0x01, 0x2c,
+                0x55, 0xc4, 0x00, 0x00, 0x00, 0x00, 0x00, 0x31,
+                0x68, 0x64, 0x6c, 0x72, 0x00, 0x00, 0x00, 0x00,
+                0x6d, 0x68, 0x6c, 0x72, 0x76, 0x69, 0x64, 0x65,
+                0x61, 0x70, 0x70, 0x6c, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x10, 0x43, 0x6f, 0x72,
+                0x65, 0x20, 0x4d, 0x65, 0x64, 0x69, 0x61, 0x20,
+                0x56, 0x69, 0x64, 0x65, 0x6f, 0x00, 0x00, 0x02,
+                0x09, 0x6d, 0x69, 0x6e, 0x66, 0x00, 0x00, 0x00,
+                0x14, 0x76, 0x6d, 0x68, 0x64, 0x00, 0x00, 0x00,
+                0x01, 0x00, 0x40, 0x80, 0x00, 0x80, 0x00, 0x80,
+                0x00, 0x00, 0x00, 0x00, 0x38, 0x68, 0x64, 0x6c,
+                0x72, 0x00, 0x00, 0x00, 0x00, 0x64, 0x68, 0x6c,
+                0x72, 0x61, 0x6c, 0x69, 0x73, 0x61, 0x70, 0x70,
+                0x6c, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x17, 0x43, 0x6f, 0x72, 0x65, 0x20, 0x4d,
+                0x65, 0x64, 0x69, 0x61, 0x20, 0x44, 0x61, 0x74,
+                0x61, 0x20, 0x48, 0x61, 0x6e, 0x64, 0x6c, 0x65,
+                0x72, 0x00, 0x00, 0x00, 0x24, 0x64, 0x69, 0x6e,
+                0x66, 0x00, 0x00, 0x00, 0x1c, 0x64, 0x72, 0x65,
+                0x66, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x01, 0x00, 0x00, 0x00, 0x0c, 0x61, 0x6c, 0x69,
+                0x73, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x01,
+                0x91, 0x73, 0x74, 0x62, 0x6c, 0x00, 0x00, 0x00,
+                0xb6, 0x73, 0x74, 0x73, 0x64, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00,
+                0xa6, 0x61, 0x76, 0x63, 0x31, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02,
+                0x00, 0x00, 0x00, 0x02, 0x00, 0x00, 0x38, 0x00,
+                0x34, 0x00, 0x48, 0x00, 0x00, 0x00, 0x48, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x05,
+                0x48, 0x2e, 0x32, 0x36, 0x34, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x18, 0xff, 0xff, 0x00, 0x00, 0x00, 0x2a, 0x61,
+                0x76, 0x63, 0x43, 0x01, 0x4d, 0x40, 0x0a, 0xff,
+                0xe1, 0x00, 0x13, 0x27, 0x4d, 0x40, 0x0a, 0xa9,
+                0x18, 0x84, 0xf2, 0xcf, 0x80, 0xb5, 0x01, 0x01,
+                0x01, 0x30, 0xad, 0x7b, 0xdf, 0x01, 0x01, 0x00,
+                0x04, 0x28, 0xfe, 0x09, 0x88, 0x00, 0x00, 0x00,
+                0x12, 0x63, 0x6f, 0x6c, 0x72, 0x6e, 0x63, 0x6c,
+                0x63, 0x00, 0x01, 0x00, 0x01, 0x00, 0x01, 0x00,
+                0x00, 0x00, 0x10, 0x70, 0x61, 0x73, 0x70, 0x00,
+                0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x01, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x18, 0x73,
+                0x74, 0x74, 0x73, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x03, 0x00,
+                0x00, 0x00, 0x64, 0x00, 0x00, 0x00, 0x28, 0x63,
+                0x74, 0x74, 0x73, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x03, 0x00, 0x00, 0x00, 0x01, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x00,
+                0x00, 0x00, 0x64, 0x00, 0x00, 0x00, 0x01, 0xff,
+                0xff, 0xff, 0x9c, 0x00, 0x00, 0x00, 0x20, 0x63,
+                0x73, 0x6c, 0x67, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x64, 0xff, 0xff, 0xff, 0x9c, 0x00,
+                0x00, 0x00, 0x64, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x01, 0x2c, 0x00, 0x00, 0x00, 0x14, 0x73,
+                0x74, 0x73, 0x73, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x01, 0x00,
+                0x00, 0x00, 0x0f, 0x73, 0x64, 0x74, 0x70, 0x00,
+                0x00, 0x00, 0x00, 0x20, 0x10, 0x18, 0x00, 0x00,
+                0x00, 0x1c, 0x73, 0x74, 0x73, 0x63, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00,
+                0x00, 0x01, 0x00, 0x00, 0x00, 0x03, 0x00, 0x00,
+                0x00, 0x01, 0x00, 0x00, 0x00, 0x20, 0x73, 0x74,
+                0x73, 0x7a, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x03, 0x00, 0x00,
+                0x00, 0x75, 0x00, 0x00, 0x00, 0x32, 0x00, 0x00,
+                0x00, 0x31, 0x00, 0x00, 0x00, 0x14, 0x73, 0x74,
+                0x63, 0x6f, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x01, 0x00, 0x00, 0x00, 0x24, 0x00, 0x00,
+                0x00, 0x92, 0x6d, 0x65, 0x74, 0x61, 0x00, 0x00,
+                0x00, 0x22, 0x68, 0x64, 0x6c, 0x72, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x6d, 0x64,
+                0x74, 0x61, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x38, 0x6b, 0x65, 0x79, 0x73,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01,
+                0x00, 0x00, 0x00, 0x28, 0x6d, 0x64, 0x74, 0x61,
+                0x63, 0x6f, 0x6d, 0x2e, 0x61, 0x70, 0x70, 0x6c,
+                0x65, 0x2e, 0x71, 0x75, 0x69, 0x63, 0x6b, 0x74,
+                0x69, 0x6d, 0x65, 0x2e, 0x70, 0x69, 0x78, 0x65,
+                0x6c, 0x64, 0x65, 0x6e, 0x73, 0x69, 0x74, 0x79,
+                0x00, 0x00, 0x00, 0x30, 0x69, 0x6c, 0x73, 0x74,
+                0x00, 0x00, 0x00, 0x28, 0x00, 0x00, 0x00, 0x01,
+                0x00, 0x00, 0x00, 0x20, 0x64, 0x61, 0x74, 0x61,
+                0x00, 0x00, 0x00, 0x1e, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x38, 0x00, 0x00, 0x00, 0x34,
+                0x00, 0x00, 0x00, 0x1c, 0x00, 0x00, 0x00, 0x1a,
+                0x00, 0x00, 0x01, 0x72, 0x6d, 0x65, 0x74, 0x61,
+                0x00, 0x00, 0x00, 0x22, 0x68, 0x64, 0x6c, 0x72,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x6d, 0x64, 0x74, 0x61, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x00, 0x00, 0x00, 0x00, 0x9d, 0x6b, 0x65,
+                0x79, 0x73, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+                0x00, 0x04, 0x00, 0x00, 0x00, 0x20, 0x6d, 0x64,
+                0x74, 0x61, 0x63, 0x6f, 0x6d, 0x2e, 0x61, 0x70,
+                0x70, 0x6c, 0x65, 0x2e, 0x71, 0x75, 0x69, 0x63,
+                0x6b, 0x74, 0x69, 0x6d, 0x65, 0x2e, 0x6d, 0x61,
+                0x6b, 0x65, 0x00, 0x00, 0x00, 0x21, 0x6d, 0x64,
+                0x74, 0x61, 0x63, 0x6f, 0x6d, 0x2e, 0x61, 0x70,
+                0x70, 0x6c, 0x65, 0x2e, 0x71, 0x75, 0x69, 0x63,
+                0x6b, 0x74, 0x69, 0x6d, 0x65, 0x2e, 0x6d, 0x6f,
+                0x64, 0x65, 0x6c, 0x00, 0x00, 0x00, 0x24, 0x6d,
+                0x64, 0x74, 0x61, 0x63, 0x6f, 0x6d, 0x2e, 0x61,
+                0x70, 0x70, 0x6c, 0x65, 0x2e, 0x71, 0x75, 0x69,
+                0x63, 0x6b, 0x74, 0x69, 0x6d, 0x65, 0x2e, 0x73,
+                0x6f, 0x66, 0x74, 0x77, 0x61, 0x72, 0x65, 0x00,
+                0x00, 0x00, 0x28, 0x6d, 0x64, 0x74, 0x61, 0x63,
+                0x6f, 0x6d, 0x2e, 0x61, 0x70, 0x70, 0x6c, 0x65,
+                0x2e, 0x71, 0x75, 0x69, 0x63, 0x6b, 0x74, 0x69,
+                0x6d, 0x65, 0x2e, 0x63, 0x72, 0x65, 0x61, 0x74,
+                0x69, 0x6f, 0x6e, 0x64, 0x61, 0x74, 0x65, 0x00,
+                0x00, 0x00, 0xab, 0x69, 0x6c, 0x73, 0x74, 0x00,
+                0x00, 0x00, 0x1d, 0x00, 0x00, 0x00, 0x01, 0x00,
+                0x00, 0x00, 0x15, 0x64, 0x61, 0x74, 0x61, 0x00,
+                0x00, 0x00, 0x01, 0x47, 0x42, 0x15, 0xc7, 0x41,
+                0x70, 0x70, 0x6c, 0x65, 0x00, 0x00, 0x00, 0x26,
+                0x00, 0x00, 0x00, 0x02, 0x00, 0x00, 0x00, 0x1e,
+                0x64, 0x61, 0x74, 0x61, 0x00, 0x00, 0x00, 0x01,
+                0x47, 0x42, 0x15, 0xc7, 0x4d, 0x61, 0x63, 0x42,
+                0x6f, 0x6f, 0x6b, 0x50, 0x72, 0x6f, 0x31, 0x34,
+                0x2c, 0x32, 0x00, 0x00, 0x00, 0x30, 0x00, 0x00,
+                0x00, 0x03, 0x00, 0x00, 0x00, 0x28, 0x64, 0x61,
+                0x74, 0x61, 0x00, 0x00, 0x00, 0x01, 0x47, 0x42,
+                0x15, 0xc7, 0x4d, 0x61, 0x63, 0x20, 0x4f, 0x53,
+                0x20, 0x58, 0x20, 0x31, 0x30, 0x2e, 0x31, 0x34,
+                0x2e, 0x36, 0x20, 0x28, 0x31, 0x38, 0x47, 0x39,
+                0x35, 0x29, 0x00, 0x00, 0x00, 0x30, 0x00, 0x00,
+                0x00, 0x04, 0x00, 0x00, 0x00, 0x28, 0x64, 0x61,
+                0x74, 0x61, 0x00, 0x00, 0x00, 0x01, 0x47, 0x42,
+                0x15, 0xc7, 0x32, 0x30, 0x31, 0x39, 0x2d, 0x31,
+                0x30, 0x2d, 0x30, 0x39, 0x54, 0x31, 0x37, 0x3a,
+                0x32, 0x38, 0x3a, 0x35, 0x38, 0x2b, 0x30, 0x31,
+                0x30, 0x30
+              ]
+            }
+          }]
+        }
+      })
+
+      done()
+    })
+
+    browser.expect.element('#output').text.to.contain('IPFS: Added ')
+
+    browser.click('#gobutton')
+      .executeAsync(function (done) {
+        const video = document.getElementById('video')
+        video.addEventListener('canplay', function () {
+          done()
+        })
+
+        setTimeout(() => {
+          done('Did not start streaming video after 1m')
+        }, 60000)
+      }, [], (result) => {
+        if (result.value) {
+          throw new Error(result.value)
+        }
+      })
+
+    browser.end()
+  }
+}
+
+
diff --git a/examples/browser-script-tag/index.html b/examples/browser-script-tag/index.html
index 3f52de9d97..b30672ea45 100644
--- a/examples/browser-script-tag/index.html
+++ b/examples/browser-script-tag/index.html
@@ -2,7 +2,7 @@
 <html>
 <head>
   <title>IPFS in the Browser</title>
-  <script src="https://unpkg.com/ipfs/dist/index.min.js"></script>
+  <script src="../../dist/index.js"></script>
   <script type="text/javascript">
     document.addEventListener('DOMContentLoaded', async () => {
       const node = await Ipfs.create({ repo: 'ipfs-' + Math.random() })
diff --git a/examples/browser-script-tag/test.js b/examples/browser-script-tag/test.js
new file mode 100644
index 0000000000..fdbd20d070
--- /dev/null
+++ b/examples/browser-script-tag/test.js
@@ -0,0 +1,28 @@
+'use strict'
+
+module.exports = {
+  'Browser script tag': function (browser) {
+    browser
+      .url(process.env.IPFS_EXAMPLE_TEST_URL)
+      .executeAsync(function (done) {
+        let count = 0
+        const interval = setInterval(() => {
+          if (count === 10 || window.node) {
+            clearInterval(interval)
+
+            done(window.node ? null : 'Did not load node after 10s')
+          }
+
+          count++
+        }, 1000)
+      }, [], (result) => {
+        if (result.value) {
+          throw new Error(result.value)
+        }
+      })
+
+    browser.expect.element('#status').text.to.contain('Node status: online')
+
+    browser.end()
+  }
+}
diff --git a/examples/browser-video-streaming/test.js b/examples/browser-video-streaming/test.js
new file mode 100644
index 0000000000..11da73ec59
--- /dev/null
+++ b/examples/browser-video-streaming/test.js
@@ -0,0 +1,25 @@
+'use strict'
+
+module.exports = {
+  'Browser video streaming': function (browser) {
+    browser
+      .url(process.env.IPFS_EXAMPLE_TEST_URL)
+      .waitForElementPresent('#video')
+      .executeAsync(function (done) {
+        const video = document.getElementById('video')
+        video.addEventListener('canplay', function () {
+          done()
+        })
+
+        setTimeout(() => {
+          done('Did not start streaming video after 1m')
+        }, 60000)
+      }, [], (result) => {
+        if (result.value) {
+          throw new Error(result.value)
+        }
+      })
+
+    browser.end()
+  }
+}
diff --git a/examples/browser-vue/test.js b/examples/browser-vue/test.js
new file mode 100644
index 0000000000..34c1b461ce
--- /dev/null
+++ b/examples/browser-vue/test.js
@@ -0,0 +1,16 @@
+'use strict'
+
+const pkg = require('./package.json')
+
+module.exports = {
+  [pkg.name]: function (browser) {
+    browser
+      .url(process.env.IPFS_EXAMPLE_TEST_URL)
+      .waitForElementVisible('.ipfs-info')
+
+    browser.expect.element('.ipfs-info h1').text.to.contain('Connected to IPFS')
+
+    browser.end()
+  }
+}
+
diff --git a/examples/browser-webpack/package.json b/examples/browser-webpack/package.json
index 350476b19a..c30a7ef004 100644
--- a/examples/browser-webpack/package.json
+++ b/examples/browser-webpack/package.json
@@ -3,6 +3,7 @@
   "version": "1.0.0",
   "description": "Bundle js-ipfs with WebPack",
   "scripts": {
+    "build": "webpack",
     "start": "node server.js"
   },
   "license": "MIT",
@@ -12,6 +13,7 @@
     "@babel/preset-env": "^7.2.3",
     "@babel/preset-react": "^7.0.0",
     "babel-loader": "^8.0.5",
+    "copy-webpack-plugin": "^5.0.4",
     "react": "^16.7.0",
     "react-dom": "^16.7.0",
     "react-hot-loader": "^4.8.8",
diff --git a/examples/browser-webpack/server.js b/examples/browser-webpack/server.js
index 0b4a68fcf6..4a1a8ebdfb 100644
--- a/examples/browser-webpack/server.js
+++ b/examples/browser-webpack/server.js
@@ -5,12 +5,11 @@ const WebpackDevServer = require('webpack-dev-server')
 const config = require('./webpack.config')
 
 const wds = new WebpackDevServer(webpack(config), {
-  publicPath: config.output.publicPath,
   hot: true,
   historyApiFallback: true
 })
 
-wds.listen(3000, 'localhost', (err, result) => {
+wds.listen(3000, 'localhost', (err) => {
   if (err) {
     throw err
   }
diff --git a/examples/browser-webpack/test.js b/examples/browser-webpack/test.js
new file mode 100644
index 0000000000..d8cdd3c63d
--- /dev/null
+++ b/examples/browser-webpack/test.js
@@ -0,0 +1,18 @@
+'use strict'
+
+const pkg = require('./package.json')
+
+module.exports = {
+  [pkg.name]: function (browser) {
+    browser
+      .url(process.env.IPFS_EXAMPLE_TEST_URL)
+      .waitForElementVisible('#root h1')
+
+    browser.expect.element('#root h1').text.to.contain('Everything is working!')
+    browser.expect.element('#root').text.to.contain('Added a file!')
+    browser.expect.element('#root').text.to.contain('hello world from webpacked IPFS')
+
+    browser.end()
+  }
+}
+
diff --git a/examples/browser-webpack/webpack.config.js b/examples/browser-webpack/webpack.config.js
index c12a025963..de12448fe9 100644
--- a/examples/browser-webpack/webpack.config.js
+++ b/examples/browser-webpack/webpack.config.js
@@ -2,6 +2,7 @@
 
 var path = require('path')
 var webpack = require('webpack')
+const CopyWebpackPlugin = require('copy-webpack-plugin')
 
 module.exports = {
   devtool: 'eval',
@@ -12,11 +13,17 @@ module.exports = {
   ],
   output: {
     path: path.join(__dirname, 'dist'),
-    filename: 'bundle.js',
+    filename: 'static/bundle.js',
     publicPath: '/static/'
   },
   plugins: [
-    new webpack.HotModuleReplacementPlugin()
+    new webpack.HotModuleReplacementPlugin(),
+    new CopyWebpackPlugin([{
+      from: 'index.html'
+    }, {
+      from: 'img',
+      to: 'static/img'
+    }])
   ],
   module: {
     rules: [
diff --git a/examples/circuit-relaying/README.md b/examples/circuit-relaying/README.md
index 7def3ae9d2..be33d79bab 100644
--- a/examples/circuit-relaying/README.md
+++ b/examples/circuit-relaying/README.md
@@ -16,10 +16,10 @@ Here is a simple diagram depicting how a typical circuit-relay connection might
 +---------------------+         |          |         +---------------------+
 |       Node A        |---------> FIREWALL <---------|        Node B       |
 +----------^----------+         |          |         +----------^----------+
-           |                                                    |           
-           |               +---------------------+              |           
-           +--------------->   Circuit Relay     <--------------+           
-                           +---------------------+                          
+           |                                                    |
+           |               +---------------------+              |
+           +--------------->   Circuit Relay     <--------------+
+                           +---------------------+
 ```
 
 `Node A` tries to connect to `Node B` but, UH-OH! There is a firewall in between that's preventing it from happening. If both `Node A` and `Node B` know about a relay, they can use it to establish the connection.
diff --git a/examples/circuit-relaying/src/app.js b/examples/circuit-relaying/src/app.js
index dd34347c1c..32bb634206 100644
--- a/examples/circuit-relaying/src/app.js
+++ b/examples/circuit-relaying/src/app.js
@@ -36,9 +36,6 @@ document.addEventListener('DOMContentLoaded', async () => {
         enabled: true // make this node a relay (HOP)
       }
     },
-    pubsub: {
-      enabled: true
-    },
     config: {
       Bootstrap: []
     }
diff --git a/examples/circuit-relaying/test.js b/examples/circuit-relaying/test.js
new file mode 100644
index 0000000000..3c295fd482
--- /dev/null
+++ b/examples/circuit-relaying/test.js
@@ -0,0 +1,145 @@
+'use strict'
+
+const fs = require('fs-extra')
+const os = require('os')
+const path = require('path')
+const execa = require('execa')
+const delay = require('delay')
+const DaemonFactory = require('ipfsd-ctl')
+const df = DaemonFactory.create({
+  type: 'js',
+  exec: path.resolve(`${__dirname}/../../src/cli/bin.js`),
+  IpfsClient: require('ipfs-http-client')
+})
+const {
+  startServer
+} = require('../utils')
+const pkg = require('./package.json')
+
+async function testUI (url, relay, localPeerIdFile, remotePeerIdFile) {
+  const proc = execa('nightwatch', [ path.join(__dirname, 'test.js') ], {
+    cwd: path.resolve(__dirname, '../'),
+    env: {
+      ...process.env,
+      CI: true,
+      IPFS_EXAMPLE_TEST_URL: url,
+      IPFS_RELAY_ADDRESS: relay,
+      IPFS_LOCAL_PEER_ID_FILE: localPeerIdFile,
+      IPFS_REMOTE_PEER_ID_FILE: remotePeerIdFile
+    }
+  })
+  proc.all.on('data', (data) => {
+    process.stdout.write(data)
+  })
+
+  await proc
+}
+
+async function runTest () {
+  const ipfsd = await df.spawn({
+    initOptions: { bits: 512 },
+    config: {
+      Addresses: {
+        Swarm: [
+          `/ip4/127.0.0.1/tcp/0/ws`
+        ]
+      },
+      Bootstrap: [],
+      relay: {
+        enabled: true,
+        hop: {
+          enabled: true
+        }
+      }
+    }
+  })
+  const server1 = await startServer(__dirname)
+  const server2 = await startServer(__dirname)
+
+  try {
+    const id = await ipfsd.api.id()
+    const address = id.addresses.filter(addr => addr.includes('/ws/ipfs/Qm')).pop()
+
+    if (!address) {
+      throw new Error(`Could not find web socket address in ${id.addresses}`)
+    }
+
+    const peerA = path.join(os.tmpdir(), `test-${Date.now()}-a.txt`)
+    const peerB = path.join(os.tmpdir(), `test-${Date.now()}-b.txt`)
+
+    await Promise.all([
+      testUI(server1.url, id.addresses[0], peerA, peerB),
+      testUI(server2.url, id.addresses[0], peerB, peerA)
+    ])
+  } finally {
+    await ipfsd.stop()
+    await server1.stop()
+    await server2.stop()
+  }
+}
+
+module.exports = runTest
+
+module.exports[pkg.name] = function (browser) {
+  let localPeerId = null
+  let remotePeerId = null
+
+  browser
+    .url(process.env.IPFS_EXAMPLE_TEST_URL)
+    .waitForElementVisible('#peer')
+    .clearValue('#peer')
+    .setValue('#peer', process.env.IPFS_RELAY_ADDRESS)
+    .pause(1000)
+    .click('#connect')
+
+  browser.expect.element('#peers-addrs').text.to.contain(process.env.IPFS_RELAY_ADDRESS)
+
+  // exchange peer info
+  browser.getText('#addrs', (result) => {
+    localPeerId = result.value.trim()
+    console.info('got local peer id', localPeerId)
+  })
+    .perform(async (browser, done) => {
+      console.info('writing local peer id')
+      await fs.writeFile(process.env.IPFS_LOCAL_PEER_ID_FILE, localPeerId)
+
+      console.info('reading remote peer id')
+      for (let i = 0; i < 100; i++) {
+        try {
+          remotePeerId = await fs.readFile(process.env.IPFS_REMOTE_PEER_ID_FILE, {
+            encoding: 'utf8'
+          })
+
+          console.info('got remote peer id', remotePeerId)
+          done()
+
+          break
+        } catch (err) {
+
+        }
+
+        await delay(1000)
+      }
+
+      console.info('connecting to remote peer', remotePeerId)
+
+      browser
+        .clearValue('#peer')
+        .setValue('#peer', remotePeerId)
+        .pause(1000)
+        .click('#connect')
+
+      browser.expect.element('#peers-addrs').text.to.contain(remotePeerId)
+
+      browser
+        .clearValue('#message')
+        .setValue('#message', 'hello')
+        .pause(1000)
+        .click('#send')
+
+      browser.expect.element('#msgs').text.to.contain(`${remotePeerId.substr(-4)}: hello`)
+      browser.expect.element('#msgs').text.to.contain(`${localPeerId.substr(-4)}: hello`)
+    })
+
+  browser.end()
+}
diff --git a/examples/custom-ipfs-repo/index.js b/examples/custom-ipfs-repo/index.js
index ebb1c576c6..71b6669e8e 100644
--- a/examples/custom-ipfs-repo/index.js
+++ b/examples/custom-ipfs-repo/index.js
@@ -1,5 +1,7 @@
 'use strict'
 
+const log = require('why-is-node-running')
+
 const IPFS = require('ipfs')
 const Repo = require('ipfs-repo')
 const fsLock = require('ipfs-repo/src/lock')
@@ -64,7 +66,13 @@ const customRepositoryOptions = {
 async function main () {
   // Initialize our IPFS node with the custom repo options
   const node = await IPFS.create({
-    repo: new Repo('/tmp/custom-repo/.ipfs', customRepositoryOptions)
+    repo: new Repo('/tmp/custom-repo/.ipfs', customRepositoryOptions),
+
+    // This just means we dont try to connect to the network which isn't necessary
+    // to demonstrate custom repos
+    config: {
+      Bootstrap: []
+    }
   })
 
   // Test the new repo by adding and fetching some data
diff --git a/examples/custom-ipfs-repo/package.json b/examples/custom-ipfs-repo/package.json
index f992ca99a9..9e88e6e34a 100644
--- a/examples/custom-ipfs-repo/package.json
+++ b/examples/custom-ipfs-repo/package.json
@@ -9,8 +9,8 @@
   },
   "license": "MIT",
   "dependencies": {
-    "datastore-fs": "~0.8.0",
+    "datastore-fs": "^0.9.1",
     "ipfs": "file:../../",
-    "ipfs-repo": "~0.26.1"
+    "ipfs-repo": "^0.28.0"
   }
 }
diff --git a/examples/custom-ipfs-repo/test.js b/examples/custom-ipfs-repo/test.js
new file mode 100644
index 0000000000..6c5da35a6b
--- /dev/null
+++ b/examples/custom-ipfs-repo/test.js
@@ -0,0 +1,22 @@
+'use strict'
+
+const path = require('path')
+const execa = require('execa')
+const fs = require('fs')
+
+async function test () {
+  const proc = execa('node', [ path.join(__dirname, 'index.js') ], {
+    cwd: path.resolve(__dirname)
+  })
+  proc.all.on('data', (data) => {
+    process.stdout.write(data)
+  })
+
+  await proc
+
+  if (!fs.existsSync('/tmp/custom-repo/.ipfs')) {
+    throw new Error('Custom repo was not created at /tmp/custom-repo/.ipfs')
+  }
+}
+
+module.exports = test
diff --git a/examples/custom-libp2p/package.json b/examples/custom-libp2p/package.json
index 944b8a2b7f..904579511e 100644
--- a/examples/custom-libp2p/package.json
+++ b/examples/custom-libp2p/package.json
@@ -10,9 +10,9 @@
   "license": "MIT",
   "dependencies": {
     "ipfs": "file:../../",
-    "libp2p": "~0.26.1",
+    "libp2p": "^0.26.2",
     "libp2p-bootstrap": "~0.9.7",
-    "libp2p-kad-dht": "~0.15.0",
+    "libp2p-kad-dht": "~0.16.0",
     "libp2p-mdns": "~0.12.2",
     "libp2p-secio": "~0.11.1",
     "libp2p-spdy": "~0.13.3",
diff --git a/examples/custom-libp2p/test.js b/examples/custom-libp2p/test.js
new file mode 100644
index 0000000000..d6bbb14db1
--- /dev/null
+++ b/examples/custom-libp2p/test.js
@@ -0,0 +1,72 @@
+'use strict'
+
+const path = require('path')
+const execa = require('execa')
+const Libp2p = require('libp2p')
+const TCP = require('libp2p-tcp')
+const SPDY = require('libp2p-spdy')
+const MPLEX = require('pull-mplex')
+const SECIO = require('libp2p-secio')
+const PeerInfo = require('peer-info')
+const PeerId = require('peer-id')
+const multiaddr = require('multiaddr')
+const promisify = require('promisify-es6')
+const PeerBook = require('peer-book')
+
+async function test () {
+  let output = ''
+
+  const proc = execa('node', [ path.join(__dirname, 'index.js') ], {
+    cwd: path.resolve(__dirname)
+  })
+  proc.all.on('data', async (data) => {
+    process.stdout.write(data)
+
+    output += data.toString('utf8')
+
+    if (output.includes('The node now has')) {
+      // the node has started up, try to dial it
+      const address = output.trim().match(/Swarm listening on (.*)\n/)[1]
+
+      console.info('Dialling', address)
+
+      const peerInfo = new PeerInfo(await promisify(PeerId.create)())
+      peerInfo.multiaddrs.add(multiaddr('/ip4/127.0.0.1/tcp/0'))
+
+      const libp2p = new Libp2p({
+        peerInfo,
+        peerBook: new PeerBook(),
+        modules: {
+          transport: [
+            TCP
+          ],
+          streamMuxer: [
+            MPLEX,
+            SPDY
+          ],
+          connEncryption: [
+            SECIO
+          ]
+        }
+      })
+      await libp2p.start()
+      await libp2p.dial(address)
+
+      console.info('Dialled', address)
+
+      proc.kill()
+
+      await libp2p.stop()
+    }
+  })
+
+  await proc.catch(() => {
+    // throw new Error('libp2p should have been killed')
+  }, (err) => {
+    if (err.exitSignal !== 'SIGTERM') {
+      throw err
+    }
+  })
+}
+
+module.exports = test
diff --git a/examples/exchange-files-in-browser/package.json b/examples/exchange-files-in-browser/package.json
index a12b50f5be..f2421f8793 100644
--- a/examples/exchange-files-in-browser/package.json
+++ b/examples/exchange-files-in-browser/package.json
@@ -13,5 +13,8 @@
   },
   "dependencies": {
     "ipfs": "file:../../"
+  },
+  "browser": {
+    "ipfs": "ipfs/dist"
   }
 }
diff --git a/examples/exchange-files-in-browser/public/app.js b/examples/exchange-files-in-browser/public/app.js
index 928be5f857..f23ca84f14 100644
--- a/examples/exchange-files-in-browser/public/app.js
+++ b/examples/exchange-files-in-browser/public/app.js
@@ -10,7 +10,8 @@ const $nodeAddresses = document.querySelector('.node-addresses')
 const $logs = document.querySelector('#logs')
 // Peers
 const $peers = document.querySelector('#peers')
-const $peersList = $peers.querySelector('tbody')
+const $peersList = $peers.querySelector('#connected-peers')
+const $workspacePeersList = $peers.querySelector('#workspace-peers')
 const $multiaddrInput = document.querySelector('#multiaddr-input')
 const $connectButton = document.querySelector('#peer-btn')
 // Files
@@ -72,6 +73,15 @@ async function start () {
       }
     }, 1000)
 
+    setInterval(async () => {
+      try {
+        await refreshWorkspacePeerList()
+      } catch (err) {
+        err.message = `Failed to refresh the workspace peer list: ${err.message}`
+        onError(err)
+      }
+    }, 1000)
+
     setInterval(async () => {
       try {
         await sendFileList()
@@ -276,6 +286,17 @@ async function refreshPeerList () {
   $peersList.innerHTML = peersAsHtml
 }
 
+async function refreshWorkspacePeerList () {
+  const peers = await node.pubsub.peers(workspace)
+
+  const peersAsHtml = peers.reverse()
+    .map((addr) => {
+      return `<tr><td>${addr}</td></tr>`
+    }).join('')
+
+  $workspacePeersList.innerHTML = peersAsHtml
+}
+
 /* ===========================================================================
    Error handling
    =========================================================================== */
diff --git a/examples/exchange-files-in-browser/public/index.html b/examples/exchange-files-in-browser/public/index.html
index 6cfff8a1fd..cbf8000c59 100644
--- a/examples/exchange-files-in-browser/public/index.html
+++ b/examples/exchange-files-in-browser/public/index.html
@@ -44,7 +44,18 @@ <h3>Workspace</h3>
 
       <div class="columns">
         <div id="peers" class="box disabled">
-          <h2>Peers</h2>
+          <h2>Workspace Peers</h2>
+
+          <table>
+            <thead>
+              <tr>
+                <th>Connected Peers</th>
+              </tr>
+            </thead>
+            <tbody id="workspace-peers"></tbody>
+          </table>
+
+          <h2>Network Peers</h2>
 
           <div class="input-button">
             <input id="multiaddr-input" type="text" placeholder="Multiaddr" disabled />
@@ -57,7 +68,7 @@ <h2>Peers</h2>
                 <th>Connected Peers</th>
               </tr>
             </thead>
-            <tbody></tbody>
+            <tbody id="connected-peers"></tbody>
           </table>
         </div>
 
diff --git a/examples/exchange-files-in-browser/test.js b/examples/exchange-files-in-browser/test.js
new file mode 100644
index 0000000000..be41709401
--- /dev/null
+++ b/examples/exchange-files-in-browser/test.js
@@ -0,0 +1,169 @@
+'use strict'
+
+const fs = require('fs-extra')
+const path = require('path')
+const os = require('os')
+const execa = require('execa')
+const delay = require('delay')
+const DaemonFactory = require('ipfsd-ctl')
+const df = DaemonFactory.create({
+  type: 'js',
+  exec: path.resolve(`${__dirname}/../../src/cli/bin.js`),
+  IpfsClient: require('ipfs-http-client')
+})
+const {
+  startServer
+} = require('../utils')
+const pkg = require('./package.json')
+
+async function testUI (env) {
+  const proc = execa('nightwatch', [ path.join(__dirname, 'test.js') ], {
+    cwd: path.resolve(__dirname, '../'),
+    env: {
+      ...process.env,
+      ...env,
+      CI: true
+    }
+  })
+  proc.all.on('data', (data) => {
+    process.stdout.write(data)
+  })
+
+  await proc
+}
+
+async function runTest () {
+  const ipfsd = await df.spawn({
+    initOptions: { bits: 512 },
+    config: {
+      Addresses: {
+        Swarm: [
+          `/ip4/127.0.0.1/tcp/0/ws`
+        ]
+      },
+      Bootstrap: []
+    }
+  })
+
+  const [{
+    hash: cid
+  }] = await ipfsd.api.add('A file with some content')
+  const server1 = await startServer(__dirname)
+  const server2 = await startServer(__dirname)
+
+  try {
+    const id = await ipfsd.api.id()
+    const address = id.addresses.filter(addr => addr.includes('/ws/ipfs/Qm')).pop()
+
+    if (!address) {
+      throw new Error(`Could not find web socket address in ${id.addresses}`)
+    }
+
+    let workspaceName = `test-${Date.now()}`
+    const peerA = path.join(os.tmpdir(), `test-${Date.now()}-a.txt`)
+    const peerB = path.join(os.tmpdir(), `test-${Date.now()}-b.txt`)
+
+    await Promise.all([
+      testUI({
+        IPFS_EXAMPLE_TEST_URL: server1.url,
+        IPFS_RELAY_ADDRESS: id.addresses[0],
+        IPFS_CID: cid,
+        IPFS_WORKSPACE_NAME: workspaceName,
+        IPFS_ADD_FILE: true,
+        IPFS_LOCAL_PEER_ID_FILE: peerA,
+        IPFS_REMOTE_PEER_ID_FILE: peerB
+      }),
+      testUI({
+        IPFS_EXAMPLE_TEST_URL: server1.url,
+        IPFS_RELAY_ADDRESS: id.addresses[0],
+        IPFS_CID: cid,
+        IPFS_WORKSPACE_NAME: workspaceName,
+        IPFS_LOCAL_PEER_ID_FILE: peerB,
+        IPFS_REMOTE_PEER_ID_FILE: peerA
+      })
+    ])
+  } finally {
+    await ipfsd.stop()
+    await server1.stop()
+    await server2.stop()
+  }
+}
+
+module.exports = runTest
+
+module.exports[pkg.name] = function (browser) {
+  let localPeerId = null
+  let remotePeerId = null
+
+  browser
+    .url(process.env.IPFS_EXAMPLE_TEST_URL)
+    .waitForElementVisible('.node-addresses li pre')
+    .pause(1000)
+
+  console.info('dialling relay', process.env.IPFS_RELAY_ADDRESS)
+
+  browser
+    .clearValue('#multiaddr-input')
+    .setValue('#multiaddr-input', process.env.IPFS_RELAY_ADDRESS)
+    .pause(1000)
+    .click('#peer-btn')
+
+  const relayPeerId = process.env.IPFS_RELAY_ADDRESS.split('/').pop()
+
+  browser.expect.element('#connected-peers').text.to.contain(relayPeerId)
+
+  console.info('joining workspace', process.env.IPFS_WORKSPACE_NAME)
+
+  browser
+    .clearValue('#workspace-input')
+    .setValue('#workspace-input', process.env.IPFS_WORKSPACE_NAME)
+    .pause(1000)
+    .click('#workspace-btn')
+
+  // exchange peer info
+  browser.getText('.node-id', (result) => {
+    localPeerId = result.value.trim()
+    console.info('got local peer id', localPeerId)
+  })
+    .perform(async (browser, done) => {
+      console.info('writing local peer id')
+      await fs.writeFile(process.env.IPFS_LOCAL_PEER_ID_FILE, localPeerId)
+
+      console.info('reading remote peer id')
+      for (let i = 0; i < 100; i++) {
+        try {
+          remotePeerId = await fs.readFile(process.env.IPFS_REMOTE_PEER_ID_FILE, {
+            encoding: 'utf8'
+          })
+
+          console.info('got remote peer id', remotePeerId)
+          done()
+
+          break
+        } catch (err) {
+
+        }
+
+        await delay(1000)
+      }
+
+      console.info('waiting for remote peer', remotePeerId, 'to join workspace')
+      browser.expect.element('#workspace-peers').text.to.contain(remotePeerId)
+
+      await delay(1000)
+    })
+
+  // only one browser should add the file to the workspace
+  if (process.env.IPFS_ADD_FILE) {
+    browser
+      .clearValue('#cid-input')
+      .setValue('#cid-input', process.env.IPFS_CID)
+      .pause(1000)
+      .click('#fetch-btn')
+  }
+
+  // but should both see the added file
+  browser.expect.element('#file-history').text.to.contain(process.env.IPFS_CID)
+
+  browser.end()
+}
diff --git a/examples/explore-ethereum-blockchain/test.js b/examples/explore-ethereum-blockchain/test.js
new file mode 100644
index 0000000000..46556250dd
--- /dev/null
+++ b/examples/explore-ethereum-blockchain/test.js
@@ -0,0 +1,50 @@
+'use strict'
+
+const fs = require('fs-extra')
+const path = require('path')
+const DaemonFactory = require('ipfsd-ctl')
+const df = DaemonFactory.create({
+  type: 'proc',
+  exec: require('../../')
+})
+
+async function runTest () {
+  const ipfsd = await df.spawn({
+    initOptions: { bits: 512 },
+    config: {
+      Addresses: {
+        Swarm: []
+      },
+      Bootstrap: []
+    },
+    disposable: true
+  })
+
+  let cids = []
+
+  console.info('Importing eth-blocks')
+  for (const file of await fs.readdir(path.join(__dirname, 'eth-stuffs'))) {
+    const ethBlock = await fs.readFile(path.join(__dirname, 'eth-stuffs', file))
+    const block = await ipfsd.api.block.put(ethBlock, {
+      format: 'eth-block',
+      mhtype: 'keccak-256'
+    })
+
+    cids.push(block.cid)
+  }
+
+  console.info('Reading eth-blocks back out')
+  for (const cid of cids) {
+    try {
+      await ipfsd.api.dag.get(cid)
+      console.error('block was ok', cid.toString())
+    } catch (err) {
+      console.error('block was invalid', cid.toString())
+      console.error(err)
+    }
+  }
+
+  await ipfsd.stop()
+}
+
+module.exports = runTest
diff --git a/examples/ipfs-101/test.js b/examples/ipfs-101/test.js
new file mode 100644
index 0000000000..73e96d1e97
--- /dev/null
+++ b/examples/ipfs-101/test.js
@@ -0,0 +1,12 @@
+'use strict'
+
+const path = require('path')
+const {
+  waitForOutput
+} = require('../utils')
+
+async function runTest () {
+  await waitForOutput('Added file contents:', path.resolve(__dirname, '1.js'))
+}
+
+module.exports = runTest
diff --git a/examples/nightwatch.conf.js b/examples/nightwatch.conf.js
new file mode 100644
index 0000000000..573a1d9fab
--- /dev/null
+++ b/examples/nightwatch.conf.js
@@ -0,0 +1,35 @@
+'use strict'
+
+const { ephemeralPort } = require('./utils')
+
+const WEBRIVER_PORT = ephemeralPort()
+
+// config used to test examples
+module.exports = {
+  src_folders: ['tests'],
+
+  webdriver: {
+    start_process: true,
+    server_path: 'node_modules/.bin/chromedriver',
+    port: WEBRIVER_PORT,
+    cli_args: [
+      `--port=${WEBRIVER_PORT}`
+    ]
+  },
+
+  test_settings: {
+    default: {
+      desiredCapabilities: {
+        browserName: 'chrome',
+        chromeOptions: {
+          args: ['headless']
+        }
+      }
+    }
+  },
+
+  globals: {
+    asyncHookTimeout: 120000,
+    waitForConditionTimeout: 60000
+  }
+}
diff --git a/examples/package.json b/examples/package.json
new file mode 100644
index 0000000000..dd98a16161
--- /dev/null
+++ b/examples/package.json
@@ -0,0 +1,19 @@
+{
+  "name": "ipfs-examples",
+  "version": "1.0.0",
+  "description": "Examples of how to use IPFS",
+  "scripts": {
+    "test": "node ./test.js",
+    "test:all": "node ./test-all.js"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "chromedriver": "^77.0.0",
+    "delay": "^4.1.0",
+    "execa": "^2.1.0",
+    "fs-extra": "^8.1.0",
+    "http-server": "~0.11.1",
+    "nightwatch": "^1.2.4",
+    "which": "^2.0.1"
+  }
+}
diff --git a/examples/run-in-electron/test.js b/examples/run-in-electron/test.js
new file mode 100644
index 0000000000..9ee32162a8
--- /dev/null
+++ b/examples/run-in-electron/test.js
@@ -0,0 +1,13 @@
+'use strict'
+
+const {
+  waitForOutput
+} = require('../utils')
+
+async function runTest () {
+  await waitForOutput('protocolVersion', 'npm', ['run', 'start'], {
+    cwd: __dirname
+  })
+}
+
+module.exports = runTest
diff --git a/examples/running-multiple-nodes/test.js b/examples/running-multiple-nodes/test.js
new file mode 100644
index 0000000000..b7b3e93c7d
--- /dev/null
+++ b/examples/running-multiple-nodes/test.js
@@ -0,0 +1,79 @@
+'use strict'
+
+const IPFS = require('ipfs')
+
+const execa = require('execa')
+const os = require('os')
+const path = require('path')
+const hat = require('hat')
+const {
+  ephemeralPort,
+  waitForOutput
+} = require('../utils')
+
+async function  testCli () {
+  await Promise.all([
+    startCliNode(),
+    startCliNode()
+  ])
+}
+
+async function startCliNode () {
+  const repoDir = path.join(os.tmpdir(), `repo-${hat()}`)
+  const opts = {
+    env: {
+      ...process.env,
+      IPFS_PATH: repoDir
+    }
+  }
+  const ipfs = path.resolve(__dirname, '../../src/cli/bin.js')
+
+  await execa(ipfs, ['init'], opts)
+  await execa(ipfs, ['config', 'Addresses.Swarm', '--json', JSON.stringify([`/ip4/0.0.0.0/tcp/${ephemeralPort()}`, `/ip4/127.0.0.1/tcp/${ephemeralPort()}/ws`])], opts)
+  await execa(ipfs, ['config', 'Addresses.API', `/ip4/127.0.0.1/tcp/${ephemeralPort()}`], opts)
+  await execa(ipfs, ['config', 'Addresses.Gateway', `/ip4/127.0.0.1/tcp/${ephemeralPort()}`], opts)
+
+  return waitForOutput('Daemon is ready', ipfs, ['daemon'], opts)
+}
+
+async function testProgramatically () {
+  await Promise.all([
+    startProgramaticNode(),
+    startProgramaticNode()
+  ])
+}
+
+async function startProgramaticNode () {
+  const repoDir = path.join(os.tmpdir(), `repo-${hat()}`)
+  const node = new IPFS({
+    repo: repoDir,
+    config: {
+      Addresses: {
+        Swarm: [
+          `/ip4/0.0.0.0/tcp/${ephemeralPort()}`,
+          `/ip4/127.0.0.1/tcp/${ephemeralPort()}/ws`
+        ],
+        API: `/ip4/127.0.0.1/tcp/${ephemeralPort()}`,
+        Gateway: `/ip4/127.0.0.1/tcp/${ephemeralPort()}`
+      },
+      Bootstrap: []
+    }
+  })
+
+  console.info('Initialising programmatic node')
+  await node.init()
+  console.info('Starting programmatic node')
+  await node.start()
+  console.info('Stopping programmatic node')
+  await node.stop()
+}
+
+async function runTest () {
+  console.info('Testing CLI recipe')
+  await testCli()
+  console.info('Testing Programmatic recipe')
+  await testProgramatically()
+  console.info('Done!')
+}
+
+module.exports = runTest
diff --git a/examples/test-all.js b/examples/test-all.js
new file mode 100644
index 0000000000..3ee99e45fa
--- /dev/null
+++ b/examples/test-all.js
@@ -0,0 +1,33 @@
+'use strict'
+
+process.on('unhandedRejection', (err) => {
+  console.error(err)
+
+  process.exit(1)
+})
+
+const path = require('path')
+const fs = require('fs')
+const {
+  waitForOutput
+} = require('./utils')
+
+async function testAll () {
+  for (const dir of fs.readdirSync(__dirname)) {
+    if (dir === 'node_modules' || dir === 'tests_output') {
+      continue
+    }
+
+    const stats = fs.statSync(path.join(__dirname, dir))
+
+    if (!stats.isDirectory()) {
+      continue
+    }
+
+    await waitForOutput('npm info ok', 'npm', ['test', '--', dir], {
+      cwd: __dirname
+    })
+  }
+}
+
+testAll()
diff --git a/examples/test.js b/examples/test.js
new file mode 100644
index 0000000000..8d0a01441a
--- /dev/null
+++ b/examples/test.js
@@ -0,0 +1,119 @@
+'use strict'
+
+process.env.NODE_ENV = 'test'
+process.env.CI = true // needed for some "clever" build tools
+
+const fs = require('fs-extra')
+const path = require('path')
+const execa = require('execa')
+const dir = path.join(__dirname, process.argv[2])
+const { startServer } = require('./utils')
+
+testExample(dir)
+  .then(() => {}, (err) => {
+    if (err.exitCode) {
+      process.exit(err.exitCode)
+    }
+
+    console.error(err)
+    process.exit(1)
+  })
+
+async function testExample (dir) {
+  await installDeps(dir)
+  await build(dir)
+
+  if (dir.includes('examples/browser-')) {
+    await runBrowserTest(dir)
+  } else {
+    await runNodeTest(dir)
+  }
+}
+
+async function installDeps (dir) {
+  if (!fs.existsSync(path.join(dir, 'package.json'))) {
+    console.info('Nothing to install in', dir)
+    return
+  }
+
+  if (fs.existsSync(path.join(dir, 'node_modules'))) {
+    console.info('Dependencies already installed in', dir)
+    return
+  }
+
+  const proc = execa.command('npm install', {
+    cwd: dir
+  })
+  proc.all.on('data', (data) => {
+    process.stdout.write(data)
+  })
+
+  await proc
+}
+
+async function build (dir) {
+  const pkgJson = path.join(dir, 'package.json')
+
+  if (!fs.existsSync(pkgJson)) {
+    console.info('Nothing to build in', dir)
+    return
+  }
+
+  const pkg = require(pkgJson)
+  let build
+
+  if (pkg.scripts.bundle) {
+    build = 'bundle'
+  }
+
+  if (pkg.scripts.build) {
+    build = 'build'
+  }
+
+  if (!build) {
+    console.info('No "build" or "bundle" script in', pkgJson)
+    return
+  }
+
+  const proc = execa('npm', ['run', build], {
+    cwd: dir
+  })
+  proc.all.on('data', (data) => {
+    process.stdout.write(data)
+  })
+
+  await proc
+}
+
+async function runBrowserTest (dir) {
+  console.info('Running browser tests in', dir)
+
+  const server = await startServer(dir)
+
+  console.info('Running tests at', server.url)
+
+  const proc = execa('nightwatch', [ path.join(dir, 'test.js') ], {
+    cwd: __dirname,
+    env: {
+      ...process.env,
+      IPFS_EXAMPLE_TEST_URL: server.url
+    }
+  })
+  proc.all.on('data', (data) => {
+    process.stdout.write(data)
+  })
+
+  try {
+    await proc
+  } finally {
+    server.stop()
+  }
+}
+
+async function runNodeTest (dir) {
+  console.info('Running node tests in', dir)
+
+  const runTest = require(path.join(dir, 'test.js'))
+
+  await runTest()
+}
diff --git a/examples/traverse-ipld-graphs/README.md b/examples/traverse-ipld-graphs/README.md
index a460caff2a..7a13cabfb6 100644
--- a/examples/traverse-ipld-graphs/README.md
+++ b/examples/traverse-ipld-graphs/README.md
@@ -20,7 +20,7 @@ This tutorial goes through several operations over IPLD graphs using the [DAG AP
 ## [traverse through a git repo](./git.js)
 The example objects contained in "git-objects" have already been decompressed with zlib.  An example of how to do this:
 
-    $ cat .git/objects/7d/df25817f57c2090a9568cdb17106a76dad7d04 | zlib-flate -uncompress > 7ddf25817f57c2090a9568cdb17106a76dad7d04 
+    $ cat .git/objects/7d/df25817f57c2090a9568cdb17106a76dad7d04 | zlib-flate -uncompress > 7ddf25817f57c2090a9568cdb17106a76dad7d04
 
 ## Video of the demos
 
diff --git a/examples/traverse-ipld-graphs/test.js b/examples/traverse-ipld-graphs/test.js
new file mode 100644
index 0000000000..cea342cd67
--- /dev/null
+++ b/examples/traverse-ipld-graphs/test.js
@@ -0,0 +1,33 @@
+'use strict'
+
+const path = require('path')
+const {
+  waitForOutput
+} = require('../utils')
+
+async function runTest () {
+  console.info('Testing put.js')
+  await waitForOutput('bafyreigsccjrxlioppkkzv27se4gxh2aygbxfnsobkaxxqiuni544uk66a', path.resolve(__dirname, 'put.js'))
+
+  console.info('Testing get.js')
+  await waitForOutput('{"name":"David","likes":["js-ipfs","icecream","steak"]}', path.resolve(__dirname, 'get.js'))
+
+  console.info('Testing get-path.js')
+  await waitForOutput('js-ipfs', path.resolve(__dirname, 'get-path.js'))
+
+  console.info('Testing get-path-accross-formats.js')
+  await waitForOutput('capoeira', path.resolve(__dirname, 'get-path-accross-formats.js'))
+
+  console.info('Testing tree.js')
+  await waitForOutput("'hobbies/0/Links' ]", path.resolve(__dirname, 'tree.js'))
+
+  console.info('Testing eth.js')
+  await waitForOutput('302516', path.resolve(__dirname, 'eth.js'))
+
+  console.info('Testing git.js')
+  await waitForOutput("'hello world!'", path.resolve(__dirname, 'git.js'))
+
+  console.info('Done!')
+}
+
+module.exports = runTest
diff --git a/examples/utils.js b/examples/utils.js
new file mode 100644
index 0000000000..acb1147250
--- /dev/null
+++ b/examples/utils.js
@@ -0,0 +1,154 @@
+'use strict'
+
+const fs = require('fs-extra')
+const path = require('path')
+const execa = require('execa')
+const which = require('which')
+
+async function startServer (dir) {
+  async function serveFrom (path) {
+    return new Promise((resolve, reject) => {
+      let output = ''
+
+      const proc = execa.command(`http-server ${path} -a 127.0.0.1`, {
+        cwd: __dirname
+      })
+      proc.all.on('data', (data) => {
+        process.stdout.write(data)
+
+        const line = data.toString('utf8')
+        output += line
+
+        if (output.includes('Hit CTRL-C to stop the server')) {
+          // find the port
+          const port = output.match(/http:\/\/127.0.0.1:(\d+)/)[1]
+
+          if (!port) {
+            throw new Error(`Could not find port in ${output}`)
+          }
+
+          resolve({
+            stop: () => {
+              console.info('Stopping server')
+              proc.kill('SIGINT', {
+                forceKillAfterTimeout: 2000
+              })
+            },
+            url: `http://127.0.0.1:${port}`
+          })
+        }
+      })
+
+      proc.then(() => {}, (err) => reject(err))
+    })
+  }
+
+  // start something..
+  const serverPaths = [
+    path.join(dir, 'build'),
+    path.join(dir, 'dist'),
+    path.join(dir, 'public')
+  ]
+
+  for (const p of serverPaths) {
+    if (fs.existsSync(p)) {
+      return serveFrom(p)
+    }
+  }
+
+  // running a bare index.html file
+  const files = [
+    path.join(dir, 'index.html')
+  ]
+
+  for (const f of files) {
+    if (fs.existsSync(f)) {
+      console.info('Found bare file', f)
+
+      if (!fs.existsSync(path.resolve(dir, '../../dist'))) {
+        console.info('Building IPFS')
+        const proc = execa.command('npm run build', {
+          cwd: path.resolve(dir, '../../'),
+          env: {
+            ...process.env,
+            CI: true // needed for some "clever" build tools
+          }
+        })
+        proc.all.on('data', (data) => {
+          process.stdout.write(data)
+        })
+
+        await proc
+      }
+
+      return Promise.resolve({
+        url: `file://${f}`,
+        stop: () => {}
+      })
+    }
+  }
+
+  throw new Error('Browser examples must contain a `public`, `dist` or `build` folder or an `index.html` file')
+}
+
+function ephemeralPort (min = 49152, max = 65535) {
+  return Math.floor(Math.random() * (max - min + 1) + min)
+}
+
+async function isExecutable (command) {
+  try {
+    await fs.access(command, fs.constants.X_OK)
+
+    return true
+  } catch (err) {
+    if (err.code === 'ENOENT') {
+      return isExecutable(await which(command))
+    }
+
+    if (err.code === 'EACCES') {
+      return false
+    }
+
+    throw err
+  }
+}
+
+async function waitForOutput (expectedOutput, command, args = [], opts = {}) {
+  if (!await isExecutable(command)) {
+    args.unshift(command)
+    command = 'node'
+  }
+
+  const proc = execa(command, args, opts)
+  let output = ''
+  let time = 120000
+
+  let timeout = setTimeout(() => {
+    throw new Error(`Did not see "${expectedOutput}" in output from "${[command].concat(args).join(' ')}" after ${time/1000}s`)
+  }, time)
+
+  proc.all.on('data', (data) => {
+    process.stdout.write(data)
+
+    output += data.toString('utf8')
+
+    if (output.includes(expectedOutput)) {
+      clearTimeout(timeout)
+      proc.kill()
+    }
+  })
+
+  try {
+    await proc
+  } catch (err) {
+    if (!err.killed) {
+      throw err
+    }
+  }
+}
+
+module.exports = {
+  startServer,
+  ephemeralPort,
+  waitForOutput
+}