diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7a1299e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# Ghostty
+
+Ghostty is a fast, feature-rich, and cross-platform terminal emulator that uses platform-native UI and GPU acceleration.
+
+## Before you start
+
+Read the [file-location](https://ghostty.org/docs/config#file-location) section to understand where you have to clone this to.