diff --git a/README.md b/README.md
new file mode 100644
index 00000000..2684349c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,20 @@
+
+# damus
+
+A twitter-like [nostr](nostr) client for iPhone, iPad and MacOS.
+
+## Spec Compliance
+
+damus implements the following [Nostr Implementation Possibilities](nips)
+
+- [NIP-01: Basic protocol flow](nip01)
+- [NIP-08: Mentions](nip08)
+- [NIP-10: Reply conventions](nip10)
+- [NIP-12: Generic tag queries (hashtags)](nip12)
+
+[nostr]: https://github.com/fiatjaf/nostr
+[nips]: https://github.com/nostr-protocol/nips
+[nip01]: https://github.com/nostr-protocol/nips/blob/master/01.md
+[nip08]: https://github.com/nostr-protocol/nips/blob/master/08.md
+[nip10]: https://github.com/nostr-protocol/nips/blob/master/10.md
+[nip12]: https://github.com/nostr-protocol/nips/blob/master/12.md