diff --git a/README.md b/README.md
new file mode 100644
index 0000000..879c336
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+# xchem_db
+This repository contains the django models used to generate the XCDB schema.
+
+## To do:
+- automate migration on push to main
+- automate sql on push to main
+- automate commit to xchem branch on ispyb for sql
+- automate PR to xchem branch on ispyb for sql