diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5e13c2e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,89 @@
+# HTML is a programming Language
+
+With the power of web components, HTML really can be a programming language.
+
+## Features
+
+### Conditional Statements
+
+```html
+
+
+
+```
+
+### Loops
+
+```html
+
+```
+
+### Pattern Matching
+
+```html
+
+
+
+ - ngmi with only ${salary} 😭
+
+
+ - Scraping by with ${salary} 🫥
+
+
+ - ${salary} is ok, I guess 😏
+
+
+ - Retire already, moneybags 🤑
+
+
+
+```
+
+### Functions
+
+```html
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+```
+
+#### Functions with Return Values
+
+```html
+
+ '{platform}' === '🦋'
+
+
+
+
+
+
+
+
+
+
+```
+
+## Project Goals
+
+- Write this library using itself.