diff --git a/examples/README.md b/examples/README.md
index a71be0f79d..364977886a 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -26,6 +26,7 @@ Clone this repo to explore these tutorials on your local machine:
 
 - [js-ipfs in the browser with Browserify](./browser-browserify)
 - [js-ipfs in the browser with Parcel.js](./browser-parceljs)
+- [js-ipfs in the browser with Vue](./browser-vue)
 - [js-ipfs in the browser with WebPack](./browser-webpack)
 - [js-ipfs in the browser with a `<script>` tag](./browser-script-tag)
 - [js-ipfs in electron](./run-in-electron)
diff --git a/examples/browser-vue/.gitignore b/examples/browser-vue/.gitignore
new file mode 100644
index 0000000000..bc9dec1f90
--- /dev/null
+++ b/examples/browser-vue/.gitignore
@@ -0,0 +1,21 @@
+.DS_Store
+/node_modules
+/dist
+
+# local env files
+.env.local
+.env.*.local
+
+# Log files
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Editor directories and files
+.idea
+.vscode
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
diff --git a/examples/browser-vue/README.md b/examples/browser-vue/README.md
new file mode 100644
index 0000000000..6e4aec6107
--- /dev/null
+++ b/examples/browser-vue/README.md
@@ -0,0 +1,41 @@
+# IPFS Vue app
+
+A minimal demonstration of how to use `js-ipfs` with `Vue`.
+
+![screenshot of the js ipfs node id info](./src/assets/ipfs-vue-screenshot.png)
+
+This project was bootstrapped with [Vue CLI](https://cli.vuejs.org/).
+
+## Project setup
+
+```bash
+npm install
+```
+
+### Compiles and hot-reloads for development
+
+```bash
+npm run serve
+```
+
+### Compiles and minifies for production
+
+```bash
+npm run build
+```
+
+### Run your tests
+
+```bash
+npm run test
+```
+
+### Lints and fixes files
+
+```bash
+npm run lint
+```
+
+### Customize configuration
+
+See [Configuration Reference](https://cli.vuejs.org/config/).
diff --git a/examples/browser-vue/babel.config.js b/examples/browser-vue/babel.config.js
new file mode 100644
index 0000000000..4f45f32b5e
--- /dev/null
+++ b/examples/browser-vue/babel.config.js
@@ -0,0 +1,3 @@
+module.exports = {
+  presets: ['@vue/app'],
+};
diff --git a/examples/browser-vue/package.json b/examples/browser-vue/package.json
new file mode 100644
index 0000000000..b9e3f99e1c
--- /dev/null
+++ b/examples/browser-vue/package.json
@@ -0,0 +1,47 @@
+{
+  "name": "browser-vue",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "serve": "vue-cli-service serve",
+    "build": "vue-cli-service build",
+    "lint": "vue-cli-service lint"
+  },
+  "dependencies": {
+    "core-js": "^2.6.5",
+    "ipfs": "file:../../",
+    "vue": "^2.6.10"
+  },
+  "devDependencies": {
+    "@vue/cli-plugin-babel": "^3.9.0",
+    "@vue/cli-plugin-eslint": "^3.9.0",
+    "@vue/cli-service": "^3.9.0",
+    "babel-eslint": "^10.0.1",
+    "eslint": "^5.16.0",
+    "eslint-plugin-vue": "^5.0.0",
+    "vue-template-compiler": "^2.6.10"
+  },
+  "eslintConfig": {
+    "root": true,
+    "env": {
+      "node": true
+    },
+    "extends": [
+      "plugin:vue/essential",
+      "eslint:recommended"
+    ],
+    "rules": {},
+    "parserOptions": {
+      "parser": "babel-eslint"
+    }
+  },
+  "postcss": {
+    "plugins": {
+      "autoprefixer": {}
+    }
+  },
+  "browserslist": [
+    "> 1%",
+    "last 2 versions"
+  ]
+}
diff --git a/examples/browser-vue/public/favicon.ico b/examples/browser-vue/public/favicon.ico
new file mode 100644
index 0000000000..b2f1f9683f
Binary files /dev/null and b/examples/browser-vue/public/favicon.ico differ
diff --git a/examples/browser-vue/public/index.html b/examples/browser-vue/public/index.html
new file mode 100644
index 0000000000..d9c8380d30
--- /dev/null
+++ b/examples/browser-vue/public/index.html
@@ -0,0 +1,20 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width,initial-scale=1.0" />
+    <link rel="icon" href="<%= BASE_URL %>favicon.ico" />
+    <title>IPFS Vue</title>
+  </head>
+  <body>
+    <noscript>
+      <strong
+        >We're sorry but browser-vue doesn't work properly without JavaScript enabled. Please enable it to
+        continue.</strong
+      >
+    </noscript>
+    <div id="app"></div>
+    <!-- built files will be auto injected -->
+  </body>
+</html>
diff --git a/examples/browser-vue/src/App.vue b/examples/browser-vue/src/App.vue
new file mode 100644
index 0000000000..dbe1621ef9
--- /dev/null
+++ b/examples/browser-vue/src/App.vue
@@ -0,0 +1,32 @@
+<template>
+  <div id="app">
+    <ipfs-info />
+  </div>
+</template>
+
+<script>
+import IpfsInfo from "./components/IpfsInfo.vue";
+
+export default {
+  name: "app",
+  components: {
+    IpfsInfo
+  }
+};
+</script>
+
+<style>
+body {
+  margin: 0;
+}
+#app {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  height: 100vh;
+  font-family: "Avenir", Helvetica, Arial, sans-serif;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+  text-align: center;
+}
+</style>
diff --git a/examples/browser-vue/src/assets/ipfs-vue-screenshot.png b/examples/browser-vue/src/assets/ipfs-vue-screenshot.png
new file mode 100644
index 0000000000..993b8628c6
Binary files /dev/null and b/examples/browser-vue/src/assets/ipfs-vue-screenshot.png differ
diff --git a/examples/browser-vue/src/assets/logo.svg b/examples/browser-vue/src/assets/logo.svg
new file mode 100644
index 0000000000..8d6a879e15
--- /dev/null
+++ b/examples/browser-vue/src/assets/logo.svg
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" style="enable-background:new" xmlns="http://www.w3.org/2000/svg" xmlns:osb="http://www.openswatchbook.org/uri/2009/osb" height="512" width="512" version="1.1" xmlns:cc="http://creativecommons.org/ns#" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 511.99999 511.99998" xmlns:dc="http://purl.org/dc/elements/1.1/">
+<defs>
+<linearGradient id="b" y2="771.51" gradientUnits="userSpaceOnUse" x2="527.72" y1="771.51" x1="84.315">
+<stop stop-color="#4a9ea1" offset="0"/>
+</linearGradient>
+<linearGradient id="a" y2="771.48" gradientUnits="userSpaceOnUse" x2="512.36" y1="771.48" x1="99.675">
+<stop stop-color="#63d3d7" offset="0"/>
+</linearGradient>
+</defs>
+<g transform="translate(-50.017 -515.51)">
+<path d="m84.315 899.51 221.7 128 221.7-128v-256l-221.7-127.99-221.7 128z" fill="url(#b)"/>
+<path fill="url(#a)" d="m283.13 546.35-160.74 92.806c0.32126 2.8543 0.32125 5.7352 0 8.5894l160.75 92.806c13.554-10.001 32.043-10.001 45.597 0l160.75-92.807c-0.32126-2.8543-0.32293-5.7338-0.001-8.588l-160.74-92.806c-13.554 10.001-32.044 10.001-45.599 0zm221.79 127.03-160.92 93.84c1.884 16.739-7.3611 32.751-22.799 39.489l0.18062 184.58c2.6325 1.1489 5.1267 2.5886 7.438 4.294l160.75-92.805c-1.884-16.739 7.3611-32.752 22.799-39.49v-185.61c-2.6325-1.1489-5.1281-2.5886-7.4394-4.294zm-397.81 1.0315c-2.3112 1.7054-4.8054 3.1465-7.438 4.2954v185.61c15.438 6.7378 24.683 22.75 22.799 39.489l160.74 92.806c2.3112-1.7054 4.8069-3.1465 7.4394-4.2954v-185.61c-15.438-6.7378-24.683-22.75-22.799-39.489l-160.74-92.81z"/>
+</g>
+<g transform="translate(0 -196.66)">
+<path d="m256 708.66 221.7-128v-256l-221.7 128v256z" fill-opacity=".25098"/>
+<path d="m256 708.66v-256l-221.7-128v256l221.7 128z" fill-opacity=".039216"/>
+<path d="m34.298 324.66 221.7 128 221.7-128-221.7-128-221.7 128z" fill-opacity=".13018"/>
+</g>
+</svg>
diff --git a/examples/browser-vue/src/components/IpfsInfo.vue b/examples/browser-vue/src/components/IpfsInfo.vue
new file mode 100644
index 0000000000..772fc6da0e
--- /dev/null
+++ b/examples/browser-vue/src/components/IpfsInfo.vue
@@ -0,0 +1,49 @@
+<template>
+  <div class="ipfs-info">
+    <img class="ipfs-logo" alt="IPFS logo" src="../assets/logo.svg" />
+    <h1>{{ status }}</h1>
+    <h2>ID: {{ id }}</h2>
+    <h2>Agent version: {{ agentVersion }}</h2>
+  </div>
+</template>
+
+<script>
+export default {
+  name: "IpfsInfo",
+  data: function() {
+    return {
+      status: "Connecting to IPFS...",
+      id: "",
+      agentVersion: ""
+    };
+  },
+  mounted: function() {
+    this.getIpfsNodeInfo();
+  },
+  methods: {
+    async getIpfsNodeInfo() {
+      try {
+        // Await for ipfs node instance.
+        const ipfs = await this.$ipfs;
+        // Call ipfs `id` method.
+        // Returns the identity of the Peer.
+        const { agentVersion, id } = await ipfs.id();
+        this.agentVersion = agentVersion;
+        this.id = id;
+        // Set successful status text.
+        this.status = "Connected to IPFS =)";
+      } catch (err) {
+        // Set error status text.
+        this.status = `Error: ${err}`;
+      }
+    }
+  }
+};
+</script>
+
+<!-- Add "scoped" attribute to limit CSS to this component only -->
+<style scoped>
+.ipfs-logo {
+  height: 10rem;
+}
+</style>
diff --git a/examples/browser-vue/src/main.js b/examples/browser-vue/src/main.js
new file mode 100644
index 0000000000..0c5dcb974c
--- /dev/null
+++ b/examples/browser-vue/src/main.js
@@ -0,0 +1,12 @@
+import Vue from 'vue';
+import App from './App.vue';
+import VueIpfs from './plugins/vue-ipfs';
+
+// Load our IPFS plugin.
+Vue.use(VueIpfs);
+
+Vue.config.productionTip = false;
+
+new Vue({
+  render: h => h(App),
+}).$mount('#app');
diff --git a/examples/browser-vue/src/plugins/vue-ipfs.js b/examples/browser-vue/src/plugins/vue-ipfs.js
new file mode 100644
index 0000000000..4bada24dc1
--- /dev/null
+++ b/examples/browser-vue/src/plugins/vue-ipfs.js
@@ -0,0 +1,14 @@
+import IPFS from 'ipfs'
+
+const plugin = {
+  install(Vue, opts = {}) {
+    Vue.prototype.$ipfs = IPFS.create(opts)
+  },
+}
+
+// Auto-install
+if (typeof window !== 'undefined' && window.Vue) {
+  window.Vue.use(plugin)
+}
+
+export default plugin
diff --git a/examples/browser-vue/vue.config.js b/examples/browser-vue/vue.config.js
new file mode 100644
index 0000000000..8fbad01d65
--- /dev/null
+++ b/examples/browser-vue/vue.config.js
@@ -0,0 +1,3 @@
+module.exports = {
+  chainWebpack: config => config.resolve.symlinks(false),
+}
