diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f484d76
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+## js-ipfs-gateway
+
+This is an application that runs in your browser as a gateway to the IPFS
+distributed web. It relies on js-ipfs to talk to the IPFS network.
+
+## Motivation
+
+This project aims to bring the distributed web to anyone with a web browser,
+without having to download any software or go through a centralized gateway.
+
+## Installation
+
+TODO
+
+## Usage
+
+TODO