diff --git a/README.md b/README.md
index a0c01df..a700c7a 100644
--- a/README.md
+++ b/README.md
@@ -101,3 +101,17 @@ Once you run the app the initialization files will appear in these locations
 ```
 
 Deleting those files will rese
+
+Accessing static apps
+---------------------
+
+Static apps are stored in `packages/pages`
+
+```
+# App ID as files with a list of packages they should load
+/srv/walnut/packages/pages/<domain.tld#path>       # https://domain.tld/path
+/srv/walnut/packages/pages/<domain.tld>            # https://domain.tld and https://domain.tld/foo match
+
+# packages are directories with reverse dns name   # used for debugging
+/srv/walnut/packages/pages/<tld.domain.package>    # matches apps.<domain.tld>/<package-name> and <domain.tld>/apps/<package-name>
+```