Warehouse App
Dashboard, product catalog with variants, barcode scanning, stock adjustments and history, categories, users, audit logs, and alerts.
Shaheen Inventory is a mobile-first warehouse stock-management app built with Expo Router and React Native in a feature-based architecture (core / features / shared) with TanStack Query, React Hook Form, and Zod. The home dashboard shows low-stock and out-of-stock KPI cards plus a recent stock-movements preview. The product module is a searchable, filterable, sortable catalog with rich detail pages, dynamic variants (color, size, storage, etc.), and a create-product form. Barcode scanning (camera or manual entry) resolves straight to a product. Stock operations let users receive (in), pick/sell (out), or correct (adjustment) inventory with reasons and references, and review both per-product and global movement feeds with before/after counts. A role-aware More hub exposes category management, a users directory with roles and permissions, a full filterable audit trail, low-stock notifications, profile, and appearance settings. The app ships as a demo on an in-memory mock adapter that mirrors the real backend's response shapes, so every screen and mutation is fully interactive with no server.
- Home dashboard with low-stock / out-of-stock counters and a live recent stock-movement feed.
- Product catalog with search, category/section/price/stock filters, sorting, and pagination.
- Product detail with pricing, stock, dimensions, and dynamic variants — plus a create-product flow.
- Barcode scanning (camera or manual) that resolves directly to a product.
- Stock adjustments (in / out / correction) with reasons and references, and full movement history.
- Role-aware More hub: categories, users & permissions, audit logs, and low-stock notifications.
- Light, dark, and system themes across every screen, with a native bottom-tab navigation.
Dashboard & Products
- Home surfaces low-stock and out-of-stock KPI cards with a recent-movements preview.
- Catalog supports free-text search, category/section/price/active filters, and sort by name, price, stock, or date.
- Product detail shows pricing, stock, low-stock threshold, dimensions, and a variant list.
- Create-product flow captures SKU, barcode, price, stock, category/section, image, and active state.
Stock & Scanning
- Barcode scan via camera or manual entry resolves straight to the matching product.
- Stock adjustments cover receive (in), pick/sell (out), and correction, with reason and reference.
- Per-product history and a global movement feed show signed quantity changes and before/after counts.
- Adjustments update the dashboard counters and product stock in real time.
Catalog & Administration
- Category management browses and edits a two-level catalog tree with detail pages.
- Users directory lists team members with roles, permissions, and detail pages.
- A full audit trail records changes across products, stock, categories, users, and auth, with filters.
- Low-stock notifications surface what needs attention, with an unread count in the More hub.
Architecture & UX
- Feature-based architecture: screens → hooks (TanStack Query) → api (normalizers) → typed models.
- Zod schemas validate form input on-device before any request is made.
- Runs on an in-memory mock adapter mirroring the backend's response shapes — fully interactive, no server.
- Light / dark / system theming, skeleton loaders, pull-to-refresh, infinite scroll, and haptics.