From fbe5dd91a2d575cee4a424ba68b44c9777bca41e Mon Sep 17 00:00:00 2001 From: pollutri Date: Fri, 29 May 2026 16:26:11 +0200 Subject: [PATCH] Aggiornato readme con la documentazione del proxy --- README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/README.md b/README.md index 4074977..47881fc 100644 --- a/README.md +++ b/README.md @@ -302,6 +302,19 @@ Punti chiave: - **`timeout=600`**: upload video fino a 1 GB e download dei backup ZIP possono superare i 30s. - `BASE_PATH` e il target del proxy devono combaciare. Per tornare alla radice: `BASE_PATH = ''` + proxy verso `http://localhost:3000/`. +### Compatibilità senza proxy / alla radice + +`BASE_PATH` è una scelta **build-time** (il prefisso viene inlinato nel bundle al `npm run build`), non runtime. Entrambi gli scenari sono supportati: + +| `BASE_PATH` | Risponde su | Proxy necessario? | +|---|---|---| +| `''` | `/` (radice) | No | +| `'/cards'` | `/cards` | No per far girare l'app; sì solo per esporla pubblicamente sotto `/cards/` | + +- Con `BASE_PATH = ''` l'app è identica alla versione senza sotto-percorso: gira sulla radice e l'helper [`withBasePath`](lib/url.ts) diventa un no-op. È il percorso di regressione. +- Con `BASE_PATH = '/cards'` l'app vive **sempre** sotto `/cards`, anche **senza** proxy: in locale la raggiungi su `http://localhost:3000/cards` (la radice `/` dà 404). Il proxy serve solo a esporla pubblicamente. +- Un singolo build **non** può rispondere contemporaneamente su `/` e su `/cards`: per cambiare percorso modifica `BASE_PATH` e ricompila. + ## Prerequisiti di sistema Sul server servono alcuni binari di sistema (richiamati direttamente, non via npm):