diff --git a/README.md b/README.md
index 546cc54..519c887 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,17 @@
 # js-libp2p-noise
-Noise libp2p handshake for js-libp2p
+
+[![](https://img.shields.io/badge/project-libp2p-yellow.svg?style=flat-square)](https://libp2p.io/)
+![](https://img.shields.io/github/issues-raw/nodefactoryio/js-libp2p-noise)
+![](https://img.shields.io/github/license/nodefactoryio/js-libp2p-noise)
+
+> Noise libp2p handshake for js-libp2p
+
+This repository contains TypeScript implementation of noise protocol, an encryption protocol used in libp2p.
+
+## Usage
+
+TBD
+
+## API
+
+TBD