diff --git a/research/README.md b/research/README.md
new file mode 100644
index 0000000..5c4738f
--- /dev/null
+++ b/research/README.md
@@ -0,0 +1,357 @@
+# The IPFS User Interface Project
+
+> Defining the ideal UI/UX for IPFS Desktop, Companion, & WebUI
+
+We want to make IPFS GUIs beautiful, reusable, and unified. To do this, we’ll gather together a list of the features that appear in Desktop, Companion and WebUI, compare their implementations, and find consensus on the ideal way to offer up each concept to the users.
+
+With that list agreed, we’ll then **define the purpose and scope of each app**, and how it’s feature set integrates with the other apps. We don’t want each app to duplicate the entire feature set of the others, but each app should have enough functionality to be useful in isolation. Each app has to work within different constraints. A desktop app has greater freedom in its implementation than a browser WebExtension. We’ll optimise each app to make best use of the resources available.
+
+From there, we’ll design wireframes for each app, composing them from the list of ideal features, finding the UI/UX patterns that can be reproduced across the differing deployment environments. The goal here is not to force each app to be identical, but to come up with a common visual language, where the same feature looks familiar and behaves in a predictable way across all the apps, while the overall layout will be adapted to work best for the context. _The frame may change, but the buttons will work the same._
+
+See the [IPFS GUI Project Description](https://docs.google.com/document/d/1HzwTYo4BDDH4WIh0EULh0U9_WnT84FacDUdVtTExluQ/edit?usp=sharing) document for the original definition of this project.
+
+
+
+**Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)*
+
+ - [App Navigation](#app-navigation)
+ - [IPFS Node info](#ipfs-node-info)
+ - [WebUI > Home > NODE INFO](#webui--home--node-info)
+ - [Desktop > Info > Your Node](#desktop--info--your-node)
+ - [Companion > Browser action menu stats](#companion--browser-action-menu-stats)
+ - [Add Files](#add-files)
+ - [Sharing files](#sharing-files)
+ - [Browsing files](#browsing-files)
+ - [Connections / Peers](#connections--peers)
+ - [DAG / IPLD Explorer](#dag--ipld-explorer)
+ - [Pinning](#pinning)
+ - [Open WebUI](#open-webui)
+ - [IPFS Node Config vs Settings / Open Preferences](#ipfs-node-config-vs-settings--open-preferences)
+ - [Start / Stop IPFS Node](#start--stop-ipfs-node)
+ - [Control which IPFS node you connect to](#control-which-ipfs-node-you-connect-to)
+ - [Installation](#installation)
+ - [Installing Companion in Firefox](#installing-companion-in-firefox)
+ - [Installing Companion in Chrome](#installing-companion-in-chrome)
+ - [Installing Desktop on MacOS](#installing-desktop-on-macos)
+ - [Interesting features that we should talk about](#interesting-features-that-we-should-talk-about)
+
+
+
+## App Navigation
+
+WebUI and Desktop share a similar sidebar navigation style. They have different names for sections and sections are not in the same order. WebUI offers a DAG explorer, while Desktop offers a hash Pinning section.
+
+Companion is a browser action, so presents a drop-down menu, with context sensitive options. It again offers different initial options, and has it's own names for things.
+
+| webui | desktop | companion |
+|------------|----------------|-------------------|
+| |||
+| Home | Info | _Node type toggle_ |
+| Connections | Files | Share files via IPFS |
+| Files | Pin | Open WebUI |
+| DAG | Peers | Open Preferences |
+| Config | Settings | Switch to public gateway |
+
+Each of these will be explored in more detail below.
+
+A quick win would be to agree on the names of things, and their order of importance in a nav bar. For example we have Config, Settings and Open Preferences, to denote a similar action in all three apps. Of note WebUI is referring to it's IPFS node config, while Desktop is referring to app specific settings, like "launch at start up". Companion is referring to a similar concept as Desktop, as it also takes you to to add-on specific settings.
+
+## IPFS Node info
+
+Discussion: https://github.com/ipfs-shipyard/pm-ipfs-gui/issues/33
+
+All three apps show IPFS node stats as part of the initial UI that is show the user first, at startup.
+
+| | webui | desktop | companion |
+|-|------------|----------------|-------------------|
+| | |||
+| **nav section** | Home | Info | - |
+| **title** | NODE INFO | Your Node | - |
+
+There are significant inconsistencies between the apps around what info is shown and how it is presented. For example they are inconsistent on the idea of "version"
+- Desktop displays "protocol version".
+- Companion displays "backend app version" (go-ipfs or js-ipfs)
+- WebUI displays both.
+
+Let's dig into what is shown in each app...
+
+### WebUI > Home > NODE INFO
+
+
+
+- Peer ID: a raw QmHash
+- Location: "Northwich, C5, United Kingdom, Earth"
+- Agent Version: `go-ipfs/0.4.13/`
+- Protocol Version: `ipfs/0.1.0`
+- Public Key: raw key string.
+- Network Addresses: A list of `multiaddr`s
+
+The WebUI interface assumes the user is technically savvy and already familiar with IPFS concepts. I assume the network addresses are the interfaces my local daemon is listening on, but seeing addresses in `multiaddr` format is still new to me, so this all needs some explaining.
+
+Then there is the geocoded `Location`. It's fun, but has never been correct for me. We should consider if this is helpful or confusing, as it's not accurate. Perhaps it's accuracy should be limited to the country level if we think it's worth keeping. Including it at all, might be sending the wrong message as it initially looks like IPFS is tracking me.
+
+`Peer ID` is interesting. My address on the distributed web. This would benefit from some explaining as it's a concept we want to teach the users about. I'm not clear on why we show raw `Public Key` there as well.
+
+The `agent` & `protocol` version occupy prime UI space, front and center when you launch the app. This sort of info is normally place in an about menu; it's main use is debugging and issue reporting.
+
+There is then a section `NETWORK ADDRESSES` which shows the network interfaces that my node is bound to. These are presented in `multiaddr` form, which is new to most people, so would benefit from explaination, or moving off to a diagnostics page, rather than presenting them as the part of the initial user experience.
+
+Web UI has some useful meta-nav items for:
+
+- About ipfs - alas this just links to the ipfs.io homepage at the moment, but it's a nice idea to have an in app help and onboarding link available.
+- GitHub repo - That open-source issues list wont fix itself.
+- Report a bug - This is really nice. It jumps the user straight to the github create an issue page.
+- Enter a hash or path - This let's you paste in a CID and opens it in the DAG explorer tab to show the object links... the file list and their hashes in the case that the hash points to a directory.
+
+**These items are absent from IPFS comapanion and desktop and should be considered.**
+
+### Desktop > Info > Your Node
+
+
+
+- Repo size. Storage space used in MB.
+- Sharing [n] "objects". - What are objects? Files? dag nodes?
+- Peer ID: a raw QmHash
+- Location: "Northwich, C5, United Kingdom, Earth"
+- Bandwidth Used - Size in MB
+
+Other items are available, but only appear on scroll. I only found that out after a few weeks of usage. We need to reconsider the layout or find a clear visual cue to show the user there are more items.
+
+`Repo size` - in MB - This is surprising. Files added to an IPFS repo that aren't in the MFS will be counted in the repo size, but don't appear in the Files pane, so as a user I can't see how the numbers make sense.
+
+`Sharing [n] "objects"` - What are objects in this context? Files? IPLD nodes? What would a new user assume? How can we make this more intuitive? Is it useful? This [issue](https://github.com/ipfs-shipyard/ipfs-desktop/issues/530 ) is interesting
+
+> [why does the] number of objects shared keep going up
+>
+> It is geoip doing lookups. It should stop at some point
+
+`Location` - Same as WebUI. Fun, but we should consider if this is helpful or confusing, as it's not accurate. Perhaps it's accuracy should be limited to the country level if we think it's worth keeping.
+
+`Bandwidth used` Tell the user the time frame. Since when? right now? Today? Ever? Probably needs to be a chart and ability to throttle like in Transmission.
+
+`Up/Down speed` What's using my bandwidth? Which hashes? or is it just DHT noise?
+
+`protocol version` ipfs/0.1.0... as per WebUI, This is diagnostics info, not front page material.
+
+`Addresses` - This is presented as a list of `multiaddr`s that is change every second. We need to identify what value this provides to the user and possibly remove it.
+
+`Public key` - A raw public key. What do can i do with it? What is the relationship to my Peer Id. Why show both?
+
+### Companion > Browser action menu stats
+
+| External node | Emedded node |
+|---------------|--------------|
+|
| 
+
+- GATEWAY - the http address of the IPFS gateway you are using.
+- API - the http address of the IPFS API you are using.
+- VERSION - the version of the ipfs api impl as reported by `ipfs.version()`
+- PEERS - The current number of connected peers.
+
+The stats in companion are significantly different to those in Desktop and WebUI. They are more focused on showing you _which_ ipfs node you are talking to.
+
+## Add Files
+
+All three apps provide drag'n'drop and and a file picker dialog to add a file.
+
+| webui | desktop | companion |
+|-------|---------|-----------|
+|  |  | 
+
+**WebUI** provides a demarked file-drop area with a button to launch a native file picker dialog. No explanation is provided.
+
+Dropping a file gives positive feedback but nothing you can click on to see the file in the file list.
+
+**Adding large file (~300MB) causes an error.** A `allocation size overflow` error from `ipfs-webui` in the browser console, and no indication of what happened in the UI.
+
+| webui pre-file-drop | webui post-file-drop |
+|---------------------|----------------------|
+|  |  |
+
+**Desktop** let's you drop files anywhere on it, but provides no indication that it's possible. Dropping a file works well as the file list shows filenames and is ordered by date added, so the file you just dropped appears at the top of the list.
+
+Adding a large file is handled, showing an indeterminate progress bar, which helps inform the user that something is happening.
+
+There are 2 buttons in the bottom left of the Files pane to open a native file picker dialog. The `+` opens the dialog configured to allow you to pick a single file. The folder icon opens a dialog configured to allow only directories to be selected. This should be collapsed into a single feature.
+
+| desktop during-file-drop | desktop post-file-drop |
+|---------------------|----------------------|
+|  |  |
+
+**Companion** similar to webUI provides a demarked file-drop area with a button to launch a native file picker dialog. Companion calls the feature "Share files via IPFS" and shows the connected peers count.
+
+The current tab redirects to the url for the file just added. Adding a large file is handled, as the filepicker is a standard html file input. There is no progress indication; the usual browser page loading indicators give a clue that something is happening.
+
+| companion pre-file-drop | companion post-file-drop |
+|---------------------|----------------------|
+|  |  |
+
+See:
+
+- [ipfs-companion#342 - UX improvements for sharing local files](https://github.com/ipfs-shipyard/ipfs-companion/issues/342)
+- [ipfs-companion#423 - Display IPFS addresses instead of opening uploaded file](https://github.com/ipfs-shipyard/ipfs-companion/issues/423)
+
+## Sharing files
+
+Discussion: https://github.com/ipfs-shipyard/pm-ipfs-gui/issues/34
+
+**WebUI** offers nothing to help the user share a file in their repo. The file list presents a list of CIDs that the user can copy and paste, and manually edit to point to the gateway.
+
+**Desktop** offers a "Copy link" button when the user hovers over a file. Clicking copies the IPFS gateway address of the file to the users clipboard. No indication is given that the action succeeded. No other controls are provided, to edit or remove files.
+
+
+
+**Companion** adds extra sharing related links to the menu when the current tab is showing a file from IPFS. "Copy Canonical Address", copies a Nested URI `/ipfs/QmHash` address to the clipboard. "Copy Public Gateway URL", copies the full ipfs.io url for the file. Both indicate that it worked with a browser notification. There is no indication to the user that these extra features exist, they only see them by re-opening the IPFS browser action menu.
+
+
+
+See:
+- [ipfs-companion#398 - IPFS Protocol Indicator in Location Bar ](https://github.com/ipfs-shipyard/ipfs-companion/issues/398)
+
+## Browsing files
+
+Discussion: https://github.com/ipfs-shipyard/pm-ipfs-gui/issues/9
+
+**WebUI** list files by CID. It's not clear what order they are sorted in. Links are provided to open each file in a browser, or explore IPLD (labelled as DAG) data for the node are provided, along with a "x - remove" link.
+
+**Desktop** lists files by filename, sorted with most recently added at the top. The time the file was added is provided as muted, secondary text. In the 0.3, you can't drill down into folders, though I think this feature is available in the latest dev version.
+
+**Companion** has no file browsing feature. It is currently assumed the user will open the WebUI for this.
+
+See:
+
+- [ipfs-companion#415 - Save all uploads to MFS ](https://github.com/ipfs-shipyard/ipfs-companion/issues/415)
+
+## Connections / Peers
+
+Desktop and WebUI both have a page for showing info about all the other IPFS nodes you are currently connected to.
+
+| webui | desktop |
+|-------|---------|
+|  |  |
+
+**WebUI** shows a peer count, geolocated pins on a globe and list of Peer Id / Multiaddr pairs for each connection. Clicking on a list item expands it to show similar node info as show on the Home page about your local node. The process is resource intensive and causes "slow script" warnings in firefox.
+
+**Desktop** Shows your location and peer count, along with a list of Peer Id / Location pairs. No more info is available about the peers. There is a search bar that allows you to search for peers by id or location.
+
+**Companion** shows just the number of connected peers as a menu bar stat, and again when you go to share a file.
+
+## DAG / IPLD Explorer
+
+Discussion: https://github.com/ipfs-shipyard/pm-ipfs-gui/issues/11
+
+**WebUI** has a DAG explorer, which might be due a rename to "IPLD Explorer". It takes an IPFS hash (also due a rename to CID) and lists out all the links or data that in the object the CID points to. In the case of a directory, you can see a list of the files it contains, and each filename is a link to it's IPLD object, allowing you drill down, navigating through the links. Where a hash points to data, the raw data is rendered in plain text.
+
+| Empty state | Explore a cid | Drill into a data node |
+|-|-|-|
+| | |
+
+The UI/UX should be improved but the idea is interesting, and could become a vital tool for helping people to understand IPFS and IPLD.
+
+## Pinning
+
+Discussion: https://github.com/ipfs-shipyard/pm-ipfs-gui/issues/10
+
+**Desktop** allows you to pin a CID. You don't need to already store that content. You can paste in any CID and give it a label to remind yourself what it was.
+
+| Desktop pin pane | Add a pin |
+|------------------|-----------|
+|  |  |
+
+| Filled out form | PIN in progesss
+|-----------------|------------------|
+|  |  |
+
+**Companion** supports recursive pinning of arbitrary resources by navigating to the resource root CID and clicking on "Pin" in Browser/Page Action.
+
+## Open WebUI
+
+Both Desktop and Companion offer this, but is "Open WebUI" the right name for this action? As a companion or desktop user, I may have never seen the WebUI app, and so may have no intuitions as to what it's for.
+
+Desktop and companion have differing ideas as to what the best url for WebUI is.
+
+**Desktop**
+http://localhost:5001/ipfs/QmPhnvn747LqwPYMJmQVorMaGbMSgA7mRRoyyZYz3DoZRQ/#/
+
+**Companion**
+http://127.0.0.1:5001/ipfs/QmPhnvn747LqwPYMJmQVorMaGbMSgA7mRRoyyZYz3DoZRQ/#/
+
+Companion swiched to using `127.0.0.1` due to "Mixed Content Warning when using `localhost` Gateway", see: [ipfs-companion#328](https://github.com/ipfs-shipyard/ipfs-companion/issues/328)
+
+## IPFS Node Config vs Settings / Open Preferences
+
+Discussion: https://github.com/ipfs-shipyard/pm-ipfs-gui/issues/15
+
+**WebUI** allows you to modify the IPFS node config.
+
+**Desktop** and **Companion** have to deal with app specific settings and also let the user modify the IPFS node config as well.
+
+We need to think about how that comes across to the user. We can keep app settings and node config separate, but we should aim to present them as sections of the same page in the UI.
+
+## Start / Stop IPFS Node
+
+Desktop let's you start and stop your IPFS node. Companion and WebUI don't
+
+In Desktop the control is shown as a the `Power` icon, bottom right. It's not clear that that is it's purpose. I initially thought it was a fancy quit this app button.
+
+
+
+Using it fades out the node info, but it isn't clear what's happened, or that toggling the same button will bring it back to life. The other tabs show no indication that the node is stopped, and attempting to add a file causes an error.
+
+
+## Control which IPFS node you connect to
+
+**Companion** let's you toggle between an embedded js-ipfs node or an external IPFS daemon. In the preferences you can even have it connect to a remote IPFS node. You must bring your own IPFS node and launch it separately for companion to be useful.
+
+**Desktop** uses [`js-ipfsd-ctl`](https://github.com/ipfs/js-ipfsd-ctl) and bundles `go-ipfs`, and it's not configurable. If you run a local ipfs daemon, Desktop cannot start, and instead shows an error message, "Please stop your IPFS daemon before running this application".
+
+See:
+
+- [ipfs-desktop#542 - Let Station use pre-existing IPFS installation or already running daemon](https://github.com/ipfs-shipyard/ipfs-desktop/issues/542)
+- [ipfs-desktop#611 - Option to only start Frontend](https://github.com/ipfs-shipyard/ipfs-desktop/issues/611)
+
+**WebUI** is bundled with `go-ipfs` and only talks the IPFS node it was bundled with. It would be useful to have a WebUI that was portable, so it could be used with `js-ipfs`.
+
+## Installation
+
+The user journey starts with the install steps, so we should consider what we can do to make that process as seamless as possible.
+
+#### Installing Companion in Firefox
+
+
+
+#### Installing Companion in Chrome
+
+
+
+#### Installing Desktop on MacOS
+
+| Download from Github. Open .dmg | Find in Applications, click, deal with warning. |
+|----------------------|------------------------|
+|  |  |
+
+
+TODO:
+- ipfs-desktop - windows
+- ipfs-webui - shell
+
+## Interesting features that we should talk about
+
+**IPFS Desktop as minimal menubar app**. Right now there is friction around the correct size for the menubar app. There is the "keep it small" camp that feels that the app should strive to stay not much large than the current design. The other camp feels that a desktop app should feel free to take up as much space as it needs.
+
+Both paths have value, but we need to decide what it is we're building. If it's to be a minimal menubar app, then we should avoid adding intricate features like a file browser. Dropbox takes this approach, and provides a minimal menubar app, which offloads almost all interactions to the webapp and the OS filesystem integration.
+
+At the other end of the spectrum are regular desktop apps, like bittorrent clients, such as Transmission, which provide comprehensive info including folder listings, bandwidth utilization and throttling, and download progress with file chunk level resolution.
+
+We should pick one or the other. We can build both as two separate apps, but we should be clear on the goal.
+
+**DAG Explorer instead of a search bar**. Paste in a CID, see info about it. This seems it could be hugely useful for letting people play with IPLD and IPFS to build an intuition of how it fits together.
+
+**Share file link**. The most useful link to share right now is an url to a gateway. Anyone running Companion could resolve it via ipfs, and anyone not would have a working fallback. Presenting multiple options, one of which would require all your collegues to also be already using ipfs to work seems unhelpful at this point.
+
+**Pinning**
+A use-case for this is the [data-together](https://datatogether.org/) idea of sharing the hosting of content you feel is important. You can go to https://archives.ipfs.io/ and grab a hash for a dataset and replicate it all to your repo, to add more copies of it to the network and increase it's availability.
+
+
+
+More simply, you could use it. make sure a website you want to host is always available on your machine. All of this needs explaining, ideally in app, as it's a new way of thinking about content on the distributed web.
\ No newline at end of file
diff --git a/research/img/000-install-companion-chrome.gif b/research/img/000-install-companion-chrome.gif
new file mode 100644
index 0000000..572012b
Binary files /dev/null and b/research/img/000-install-companion-chrome.gif differ
diff --git a/research/img/000-install-companion-firefox.gif b/research/img/000-install-companion-firefox.gif
new file mode 100644
index 0000000..873241f
Binary files /dev/null and b/research/img/000-install-companion-firefox.gif differ
diff --git a/research/img/000-install-desktop-mac-1.png b/research/img/000-install-desktop-mac-1.png
new file mode 100644
index 0000000..06ff149
Binary files /dev/null and b/research/img/000-install-desktop-mac-1.png differ
diff --git a/research/img/000-install-desktop-mac-2.png b/research/img/000-install-desktop-mac-2.png
new file mode 100644
index 0000000..42b5922
Binary files /dev/null and b/research/img/000-install-desktop-mac-2.png differ
diff --git a/research/img/001-node-info-companion.png b/research/img/001-node-info-companion.png
new file mode 100644
index 0000000..59577d0
Binary files /dev/null and b/research/img/001-node-info-companion.png differ
diff --git a/research/img/001-node-info-desktop.png b/research/img/001-node-info-desktop.png
new file mode 100644
index 0000000..f5512b2
Binary files /dev/null and b/research/img/001-node-info-desktop.png differ
diff --git a/research/img/001-node-info-webui.png b/research/img/001-node-info-webui.png
new file mode 100644
index 0000000..b7aaf7f
Binary files /dev/null and b/research/img/001-node-info-webui.png differ
diff --git a/research/img/002-add-file-companion-1.png b/research/img/002-add-file-companion-1.png
new file mode 100644
index 0000000..7c00a54
Binary files /dev/null and b/research/img/002-add-file-companion-1.png differ
diff --git a/research/img/002-add-file-companion-2.png b/research/img/002-add-file-companion-2.png
new file mode 100644
index 0000000..33eb5f2
Binary files /dev/null and b/research/img/002-add-file-companion-2.png differ
diff --git a/research/img/002-add-file-companion-3.png b/research/img/002-add-file-companion-3.png
new file mode 100644
index 0000000..8849e61
Binary files /dev/null and b/research/img/002-add-file-companion-3.png differ
diff --git a/research/img/002-add-file-desktop-1.png b/research/img/002-add-file-desktop-1.png
new file mode 100644
index 0000000..cfde6e9
Binary files /dev/null and b/research/img/002-add-file-desktop-1.png differ
diff --git a/research/img/002-add-file-desktop-2.png b/research/img/002-add-file-desktop-2.png
new file mode 100644
index 0000000..6e1b4bb
Binary files /dev/null and b/research/img/002-add-file-desktop-2.png differ
diff --git a/research/img/002-add-file-desktop-3.png b/research/img/002-add-file-desktop-3.png
new file mode 100644
index 0000000..d625250
Binary files /dev/null and b/research/img/002-add-file-desktop-3.png differ
diff --git a/research/img/002-add-file-webui-1.png b/research/img/002-add-file-webui-1.png
new file mode 100644
index 0000000..77291d3
Binary files /dev/null and b/research/img/002-add-file-webui-1.png differ
diff --git a/research/img/002-add-file-webui-2.png b/research/img/002-add-file-webui-2.png
new file mode 100644
index 0000000..2205f2c
Binary files /dev/null and b/research/img/002-add-file-webui-2.png differ
diff --git a/research/img/003-peers-desktop-1.png b/research/img/003-peers-desktop-1.png
new file mode 100644
index 0000000..eb87a7d
Binary files /dev/null and b/research/img/003-peers-desktop-1.png differ
diff --git a/research/img/003-peers-webui-1.png b/research/img/003-peers-webui-1.png
new file mode 100644
index 0000000..7c53e72
Binary files /dev/null and b/research/img/003-peers-webui-1.png differ
diff --git a/research/img/003-peers-webui-2.png b/research/img/003-peers-webui-2.png
new file mode 100644
index 0000000..b4e7f44
Binary files /dev/null and b/research/img/003-peers-webui-2.png differ
diff --git a/research/img/004-ipld-explorer-webui-1.png b/research/img/004-ipld-explorer-webui-1.png
new file mode 100644
index 0000000..2ae24a9
Binary files /dev/null and b/research/img/004-ipld-explorer-webui-1.png differ
diff --git a/research/img/004-ipld-explorer-webui-2.png b/research/img/004-ipld-explorer-webui-2.png
new file mode 100644
index 0000000..c0c8ae2
Binary files /dev/null and b/research/img/004-ipld-explorer-webui-2.png differ
diff --git a/research/img/004-ipld-explorer-webui-3.png b/research/img/004-ipld-explorer-webui-3.png
new file mode 100644
index 0000000..d4536be
Binary files /dev/null and b/research/img/004-ipld-explorer-webui-3.png differ
diff --git a/research/img/005-pin-archive-1.png b/research/img/005-pin-archive-1.png
new file mode 100644
index 0000000..f481bcf
Binary files /dev/null and b/research/img/005-pin-archive-1.png differ
diff --git a/research/img/005-pin-desktop-1.png b/research/img/005-pin-desktop-1.png
new file mode 100644
index 0000000..243c5aa
Binary files /dev/null and b/research/img/005-pin-desktop-1.png differ
diff --git a/research/img/005-pin-desktop-2.png b/research/img/005-pin-desktop-2.png
new file mode 100644
index 0000000..a8bad05
Binary files /dev/null and b/research/img/005-pin-desktop-2.png differ
diff --git a/research/img/005-pin-desktop-3.png b/research/img/005-pin-desktop-3.png
new file mode 100644
index 0000000..fda39d7
Binary files /dev/null and b/research/img/005-pin-desktop-3.png differ
diff --git a/research/img/005-pin-desktop-4.png b/research/img/005-pin-desktop-4.png
new file mode 100644
index 0000000..4da7162
Binary files /dev/null and b/research/img/005-pin-desktop-4.png differ
diff --git a/research/img/companion-embedded-node.png b/research/img/companion-embedded-node.png
new file mode 100644
index 0000000..c1fc082
Binary files /dev/null and b/research/img/companion-embedded-node.png differ
diff --git a/research/img/desktop-node-stopped.png b/research/img/desktop-node-stopped.png
new file mode 100644
index 0000000..4c07c0f
Binary files /dev/null and b/research/img/desktop-node-stopped.png differ
diff --git a/research/img/ipfs-companion/install/chrome/screen-shot-2018-03-13-at-14-43-19.png b/research/img/ipfs-companion/install/chrome/screen-shot-2018-03-13-at-14-43-19.png
new file mode 100644
index 0000000..4bca8c8
Binary files /dev/null and b/research/img/ipfs-companion/install/chrome/screen-shot-2018-03-13-at-14-43-19.png differ
diff --git a/research/img/ipfs-companion/install/chrome/screen-shot-2018-03-13-at-14-43-25.png b/research/img/ipfs-companion/install/chrome/screen-shot-2018-03-13-at-14-43-25.png
new file mode 100644
index 0000000..a8d747b
Binary files /dev/null and b/research/img/ipfs-companion/install/chrome/screen-shot-2018-03-13-at-14-43-25.png differ
diff --git a/research/img/ipfs-companion/install/chrome/screen-shot-2018-03-13-at-14-43-31.png b/research/img/ipfs-companion/install/chrome/screen-shot-2018-03-13-at-14-43-31.png
new file mode 100644
index 0000000..5b5bed0
Binary files /dev/null and b/research/img/ipfs-companion/install/chrome/screen-shot-2018-03-13-at-14-43-31.png differ
diff --git a/research/img/ipfs-companion/install/chrome/screen-shot-2018-03-13-at-14-43-38.png b/research/img/ipfs-companion/install/chrome/screen-shot-2018-03-13-at-14-43-38.png
new file mode 100644
index 0000000..356c207
Binary files /dev/null and b/research/img/ipfs-companion/install/chrome/screen-shot-2018-03-13-at-14-43-38.png differ
diff --git a/research/img/ipfs-companion/install/chrome/screen-shot-2018-03-13-at-14-43-51.png b/research/img/ipfs-companion/install/chrome/screen-shot-2018-03-13-at-14-43-51.png
new file mode 100644
index 0000000..1ee3d3e
Binary files /dev/null and b/research/img/ipfs-companion/install/chrome/screen-shot-2018-03-13-at-14-43-51.png differ
diff --git a/research/img/ipfs-companion/install/chrome/screen-shot-2018-03-13-at-14-43-55.png b/research/img/ipfs-companion/install/chrome/screen-shot-2018-03-13-at-14-43-55.png
new file mode 100644
index 0000000..b52ab8e
Binary files /dev/null and b/research/img/ipfs-companion/install/chrome/screen-shot-2018-03-13-at-14-43-55.png differ
diff --git a/research/img/ipfs-companion/install/firefox/screen-shot-2018-03-13-at-14-40-11.png b/research/img/ipfs-companion/install/firefox/screen-shot-2018-03-13-at-14-40-11.png
new file mode 100644
index 0000000..717ace9
Binary files /dev/null and b/research/img/ipfs-companion/install/firefox/screen-shot-2018-03-13-at-14-40-11.png differ
diff --git a/research/img/ipfs-companion/install/firefox/screen-shot-2018-03-13-at-14-40-18.png b/research/img/ipfs-companion/install/firefox/screen-shot-2018-03-13-at-14-40-18.png
new file mode 100644
index 0000000..1285f83
Binary files /dev/null and b/research/img/ipfs-companion/install/firefox/screen-shot-2018-03-13-at-14-40-18.png differ
diff --git a/research/img/ipfs-companion/install/firefox/screen-shot-2018-03-13-at-14-40-24.png b/research/img/ipfs-companion/install/firefox/screen-shot-2018-03-13-at-14-40-24.png
new file mode 100644
index 0000000..5b570cc
Binary files /dev/null and b/research/img/ipfs-companion/install/firefox/screen-shot-2018-03-13-at-14-40-24.png differ
diff --git a/research/img/ipfs-companion/install/firefox/screen-shot-2018-03-13-at-14-40-28.png b/research/img/ipfs-companion/install/firefox/screen-shot-2018-03-13-at-14-40-28.png
new file mode 100644
index 0000000..7c7ee50
Binary files /dev/null and b/research/img/ipfs-companion/install/firefox/screen-shot-2018-03-13-at-14-40-28.png differ
diff --git a/research/img/ipfs-companion/install/firefox/screen-shot-2018-03-13-at-14-40-34.png b/research/img/ipfs-companion/install/firefox/screen-shot-2018-03-13-at-14-40-34.png
new file mode 100644
index 0000000..a033037
Binary files /dev/null and b/research/img/ipfs-companion/install/firefox/screen-shot-2018-03-13-at-14-40-34.png differ
diff --git a/research/what-we-want.md b/research/what-we-want.md
new file mode 100644
index 0000000..08f2112
--- /dev/null
+++ b/research/what-we-want.md
@@ -0,0 +1,24 @@
+
+# What we want from IPFS
+
+## Me, a casual user and web dev.
+
+I want to run a local IPFS node so I can share files with friends super easily, without needing to use a service covered in adverts.
+
+I want to be able to PIN datasets that I think are important, so I can contribute a little bandwidth to there continued availability on the web.
+
+I want to be able to host websites in IPFS, and have it be as easy as surge.sh / firebase hosting. I want it the site to still be available when I close my laptop.
+
+I want to be able to make a website I visit regularly work offline, so i can read it on the tube.
+
+I want to control how much bandwidth it uses. I don't want it to slow down my day to day browsing.
+
+## Me, a small business owner and member of a shared workspace.
+
+I want to set up an IPFS node for our company. I want us to be able to host static sites and content we make for clients on IPFS. I need it to be always available, and am willing to pay some money to make that work, as we already do so with other hosting. I need it to be fast, for non-ipfs as well as ipfs users.
+
+I'd like to set up a private IPFS node for sharing files with the company but not the whole world.
+
+I need it to be reliable, I don't have time to maintain it.
+
+I want to control how much bandwidth it uses. It shouldn't chew out all of the workspaces shared internet connection.