docs: update documentation with mobile stat cards UI improvements

- Added StatCard component description to README
- Updated frontend architecture in PROJECT_ARCHITECTURE.md
- Documented responsive design improvements (v1.9.21+)
- Mobile-first responsive design for inventory management
This commit is contained in:
Daniel Bedeleanu
2026-04-15 11:39:50 +03:00
parent 546eca6b9a
commit 10d75619bf
2 changed files with 19 additions and 2 deletions

View File

@@ -39,9 +39,20 @@ To generate a clean production package and snapshot the current state:
---
## 🎨 Recent UI/UX Improvements (v1.9.21+)
### Mobile-First Responsive Design
- **StatCard Component:** Reusable, responsive stat display component for mobile phones
- Two-column flexbox layout (label left, number right) prevents text overflow on narrow screens
- Responsive font sizing: `text-sm md:text-base` (labels), `text-lg md:text-xl` (numbers)
- Automatic label truncation with ellipsis for long text
- Accessible markup with `role="status"` and `aria-hidden` attributes
- **Pages Updated:** Inventory (Categories, Item Types, Total Boxes), Logs (Total Events, Check in/out), Admin (Local Archives)
- **Tested on:** iPhone SE (375px), iPhone 12 (390px), iPhone 14 Pro Max (430px), tablets (768px), desktop (1024px)
## 🏗 Technical Overview
* **Backend:** FastAPI (Python 3.12+)
* **Frontend:** Next.js 15+ (React PWA)
* **Frontend:** Next.js 15+ (React PWA) with responsive Tailwind CSS
* **Database:** SQLite (SQLAlchemy) with Dexie.js (IndexedDB) for client-side sync.
* **Proxy:** Caddy (Docker) or local-ssl-proxy (Standalone/Dev).
* **AI Engine:** Google Gemini (Generative AI SDK).