diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4fe47d0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# Capybara engine
+
+## What
+
+Capybara engine is a runtime for the JavaScript (ECMAScript) programming language.
+
+The initial target is too conform to ECMAScript 2023 as described on [https://tc39.es/ecma262/2023].
+
+## What is not included
+- Any sort of APIs not defined in the language specification (like stuff nodejs has or the different browser APIs)
+- HTML & DOM systems (HTML rendering will be a seperate module)
+
+## Later features once js runtime is stable
+- wasm
+
+## How
+- Base featureset included in runtime
+- Register functions and objects before execution time