diff --git a/README.md b/README.md
index 67160a7..3c66a6c 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,12 @@
 # 💀 (u1F480)
 [![Discord](https://badgen.net/badge/icon/discord?icon=discord&label)](https://discord.gg/NuGxJKtDKS)
+
+Make emojis great again! 💀 encourages programming using emojis. In fact, all your code will be written using emojis!
+
+## Specification
+So far it is just bullet points, I will work it out one day.
+* You may only use emojis. Every other character is a comment.
+* Numbers are represented as base5 using moon phase emojis. 🌑 = 0, 🌒 = 🌘 = 1, 🌓 = 🌗 = 2, 🌖 = 🌔 = 3, 🌕 = 4. E.g. 🌒🌕 = decimal 9. If applicable, every other moon emoji (🌙🌚🌛🌜🌝) is treated as a decimal point.
+* An error can be thrown using 🖕. This signals the implementation to halt and catch fire. Currently there is no way to handle errors. It is upto the language implementation to decide what to do next.
+* There are the following primitive types: ⭐️ boolean, 🌟 integer, ✨ floating number, 💫 chararacter, 🌌<type> array. An 🌌<T> type signifies that the the type is an array of T.
+* Variables can be defined using "🌱<type><name>". You can assign them a value using "📥<name> <value>". After every use (getting/setting) you need to water the variable using "🔥<name>". The variable needs to be freed from memory using "🔥<name>" if it is no longer used.