diff --git a/README.md b/README.md
index d1da1b4..818b916 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,13 @@
 walnut
 ======
 
-An opinionated, constrained, secure application framework with a hard shell - like iOS, but for a home server.
+An opinionated, constrained, secure application framework with a hard shell - kinda like iOS, but for a server.
+
+Applications are written in express, but instead of using `require` for generic packages,
+they use `req.getSiteCapability(pkg)` and are restricted to packages that have been
+allowed by app, device, site, or user permission. Any configuration for the capability
+(external passwords, api keys, etc) will be set up beforehand so that they are not exposed
+to the application.
 
 Security Features
 -----------------