1 files changed, 24 insertions, 0 deletions

diff --git a/readme.md b/readme.md
index 7500744..b5844f2 100644
--- a/readme.md
+++ b/readme.md
@@ -115,6 +115,13 @@ of annotated raw SQL queries, exposing them as callable Python functions.
 * `./sql/`
   * `tables.sql`: database initialisation statements
   * `queries.sql`: annotated SQL queries (from which the DAO is derived)
+
+* `./app/`
+  * `app_database.py`: database connection pool and transaction helper
+  * `app_sessions.py`: (signed cookies) session data management helpers
+  * `app_{account,wallet}.py`: page-specific request handlers
+  * `app.py`: FastAPI web application entry point
+
 * `./flake.nix`: project runtime and development environment description
 
 ### Security considerations
@@ -196,6 +203,23 @@ before being created and initialised again:
 dropdb app
 ```
 
+### Local application server
+
+The server application can be started in development mode with:
+
+```sh
+uvicorn \
+  --reload-dir app \
+  --reload-dir templates \
+  --reload \
+  --app-dir app \
+  app:main
+```
+
+This server will listen to incoming requests to a locally bound port. It will
+automatically reload itself when its files are edited, and display logs about
+type checking and runtime errors.
+
 
 ## Copyright and licensing