diff --git a/README.md b/README.md
new file mode 100644
index 0000000..72ae934
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+
+
+# Castor
+Castor is a simple CLI for building z2f files.
+
+# Commands
+
+* `castor init`
+* `castor build [--zip] [--ztroot]`
+* `castor serve`
+* `castor install`
+* `castor install GitHubAcc/Repository/ReleaseVersion`
+* `castor help`
+* `castor version`
+
+# Installation
+Build the solution via `dotnet build`.
diff --git a/castor3-github-social-preview.png b/castor3-github-social-preview.png
new file mode 100644
index 0000000..39ac18e
Binary files /dev/null and b/castor3-github-social-preview.png differ
diff --git a/castor3-github-social-preview.svg b/castor3-github-social-preview.svg
new file mode 100644
index 0000000..6356542
--- /dev/null
+++ b/castor3-github-social-preview.svg
@@ -0,0 +1 @@
+
\ No newline at end of file