diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..86242146bb98efe1727c65c7bb9ee4cf2d0c171c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,47 @@
+D7018E Special Studies RUST
+===========================
+
+Assignment 4
+------------
+
+## Dependencies
+
+Cargo rustc cargo-clone xargo
+
+See [this guide](https://gitlab.henriktjader.com/d7018e-special-studies-embedded-systems/are_we_embedded_yet/blob/master/doc/Ecosystem.md)
+and [this](https://gitlab.henriktjader.com/d7018e-special-studies-embedded-systems/are_we_embedded_yet/blob/master/doc/Quickstart.md)
+for instructions.
+
+## Installation
+
+```
+git clone https://gitlab.henriktjader.com/D7018E-SS-RUST/a4_decode.git
+```
+or
+```
+git clone git@gitlab.henriktjader.com:D7018E-SS-RUST/a4_decode.git
+```
+for developers.
+
+
+
+## Usage
+
+### Compile:
+
+```
+xargo build
+```
+
+### Run:
+
+```
+arm-none-eabi-gdb debug/$TARGET/debug/app
+```
+
+## Description
+
+Will take the string from CODED and output the decoded string into PLAIN
+
+## Analysis
+