Docs: Add Nginx streaming and compression configuration

Co-authored-by: contact <[email protected]>

Author: cursoragent

examples/nginx/README.md

@@ -43,6 +43,24 @@ This service sets up a MySQL database with predefined credentials and a persiste
 
 The `nginx.conf` file contains the NGINX configuration:
 
+### Streaming and compression
+
+SQLPage streams HTML as it is generated, so browsers can start rendering before the database finishes returning rows. To keep that behaviour through NGINX, prefer minimal buffering and let the proxy handle compression:
+
+```
+    proxy_buffering off;
+
+    gzip on;
+    gzip_buffers 2 4k;
+    gzip_types text/html text/plain text/css application/javascript application/json;
+
+    chunked_transfer_encoding on;
+```
+
+Disabling buffering lowers latency but increases the number of active connections; tune the gzip settings to balance CPU cost versus bandwidth, and re-enable buffering only if you need request coalescing or traffic smoothing. See the [proxy buffering](https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_buffering), [gzip](https://nginx.org/en/docs/http/ngx_http_gzip_module.html), and [chunked transfer](https://nginx.org/en/docs/http/ngx_http_core_module.html#chunked_transfer_encoding) directives for more guidance.
+
+When SQLPage runs behind a reverse proxy, set `compress_responses` to `false` in its configuration (documented [here](https://github.com/sqlpage/SQLPage/blob/main/configuration.md)) so that NGINX can perform compression once at the edge.
+
 ### Rate Limiting