deslop

README.md

@@ -89,3 +89,47 @@ Dodatkowe przyklady:
    docker compose -f docker/compose.yml exec app sh -c 'flask lists create-from-template --template-id 7 --owner admin --when "2026-03-24 09:15" --title "Poranna lista"'
    ```
 
+
+## Uproszczenie UI i skalowanie
+
+Interfejs korzysta z jednokolorowych, konturowych ikon SVG zapisanych lokalnie
+w `shopping_app/static/icons/tabler/`. Ikony są wykorzystywane także przez
+JavaScript (`shopping_app/static/js/ui_icons.js`). Nie wymagają CDN.
+
+W `.env` można ustawić:
+
+```dotenv
+UI_SCALE=100
+```
+
+Obsługiwane wartości: `100` (domyślnie), `90`, `80`, `70`. Pozostałe wartości
+są traktowane jako `100`. Zmiana wymaga ponownego uruchomienia procesu Flask
+(np. odtworzenia kontenera aplikacji). Przy `100` globalne skalowanie nie jest
+włączane. Niższe wartości pomniejszają również tekst i obszary dotykowe,
+dlatego na telefonach rekomendowane jest `100`.
+
+**Opcjonalnie:** aby zastąpić dołączone konturowe SVG oryginalnymi plikami
+projektu [Tabler Icons](https://github.com/tabler/tabler-icons) (licencja MIT),
+wykonaj przy dostępie do Internetu:
+
+```bash
+python _tools/sync_tabler_icons.py
+```
+
+Skrypt pobierze komplet oryginalnych ikon z repozytorium Tabler, odtworzy
+lokalny `sprite.svg`, bez wprowadzania zależności sieciowej w czasie działania
+aplikacji. Dołączone SVG mają spójny styl Tabler, ale bez uruchomienia tego
+skryptu nie należy traktować ich jako zweryfikowanych oryginalnych plików
+Tabler Icons.
+
+Aktualizacja istniejącej instalacji: skopiuj zmodyfikowane pliki do katalogu
+projektu, zachowaj lokalne `.env`, a następnie odtwórz kontener `app` np.:
+
+```bash
+docker compose --env-file .env -f docker/compose.yml up -d --force-recreate app
+```
+
+Nie używaj trybu `deploy` skryptu `deploy_docker.sh` do wdrażania zmian tylko
+z rozpakowanego ZIP-a, ponieważ uruchamia on `git pull` i może nadpisać lokalny
+kod. Skalowanie przetestowano w Chromium; na innych silnikach oraz na
+fizycznych telefonach należy dodatkowo zweryfikować działanie modali i układ.