diff --git a/README.md b/README.md
new file mode 100644
index 0000000..90fd1a1
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+# Foxchat.NET
+
+a prototype chat server/protocol thing
+
+two types of servers: identity servers, which users log in to and which clients interact with,
+and chat servers, which actually host the guilds, channels, and messages.
+
+very *very* much not ready for use yet
+
+code is licensed under the Apache License 2.0
+
+## Packages
+
+- `Foxchat.Core`: shared classes and model definitions
+- `Foxchat.Identity`: identity server
+- `Foxchat.Chat`: chat server