diff --git a/packages/serverless/README.md b/packages/serverless/README.md
new file mode 100644
index 0000000..aa40868
--- /dev/null
+++ b/packages/serverless/README.md
@@ -0,0 +1,9 @@
+## deployment is serverless
+
+this project deploys the UI and API to twilio functions https://doorman-6741-prod.twil.io
+
+It uses a cloud redis cache
+
+After the twilio functions I have setup a cloudflare worker at https://doorman.chromart.workers.dev
+
+The cloudflare worker just proxies requests so the endpoint is a bit nicer