diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..42d06c9
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,16 @@
+# Red Dwarf Server
+
+Red Dwarf but as a Go AppView server instead of a React TypeScript SPA
+
+you can use it right now by using `did:web:server.reddwarf.app` with any bluesky client that supports custom appviews (like for example [witchsky](https://witchsky.app/))
+
+still very early in development
+implemented routes:
+- app.bsky.actor.getProfiles
+- app.bsky.actor.getProfile
+- app.bsky.notification.listNotifications (placeholder)
+- app.bsky.labeler.getServices
+- app.bsky.feed.getFeedGenerators
+- app.bsky.feed.getPosts (post rendering is incomplete)
+- app.bsky.feed.getFeed (post rendering is incomplete)
+- app.bsky.unspecced.getConfig (placeholder)
\ No newline at end of file