diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fd7b45c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# gitworkshop.dev
+
+decentralised alternative to github over nostr
+
+a web client to collaborate on issues and code proposals for git repositories via nostr
+
+available at https://gitworkshop.dev or can be run locally with the same experience as https://gitworkshop.dev doesnt host any data 
+
+pairs with sister project see [gitworkshop.dev/ngit](https://gitworkshop.dev/ngit)
+
+[gitworkshop.dev/about](https://gitworkshop.dev/about) for more details
+
+## Contributions Welcome!
+
+use ngit to submit proposals!
+
+[gitworkshop.dev/repo/ngit](https://gitworkshop.dev/repo/gitworkshop) to report issues and see proposals