Coșul Local App
Marketplace Delivery PWA
Coșul Local is an offline-ready Progressive Web Application (PWA) connecting Romanian consumers directly with regional food producers. It streamlines local food hubs supply chains by offering a high-performance marketplace interface, dynamic client order tracking, and delivery log management.
* TODO: Replace with your actual verified Core Web Vitals and Lighthouse scores.
infoConsumer Dashboard
Main workspace greeting users, displaying key statistics cards (pending, confirmed, delivered orders) and order list filters.
Key Capabilities & Features
Coșul Local integrates client-server synchronization, offline cart storage, and responsive views to deliver a unified local food hub app.
Consumer Statistics Overview
Responsive welcome headers displaying 4 themed cards representing total, pending, confirmed, and delivered order counts mapped instantly to database states.
Interactive Order Filters
Client-side filter toggles allowing users to instantly group orders by status (All, Pending, Confirmed, Delivered, Cancelled) with live indicators showing order counts per status.
Zustand Offline-Ready Cart
A light weight state store managing product quantities and delivery schedules locally, ensuring users don't lose their cart items when moving offline.
Dual Roles Management
Decoupled authenticated workspaces separating Consumer profiles from Producer inventory managers, featuring custom theme templates and tailored actions.
Technical Architecture
Coșul Local leverages Next.js 16 App Router along with Server Actions to manage server mutations securely. Database tables are hosted in a localized Supabase server (run via Docker locally) using auto-generated TypeScript schemas.
devicesFrontend Layer
- • App Router Layouts: Nested routes dynamically differentiating public `/piata` catalog from `(dashboard)/consumer` profiles.
- • Zustand store: Manages shopping cart updates and synchronizes with localStorage.
- • shadcn/ui & Tailwind: Modular design tokens ensuring quick style changes and mobile-first responsiveness.
boltServer Logic (Actions)
- • Secure Server Actions: Functions executing database writes (e.g. `consumer-orders.ts` or profile updates) with integrated validation.
- • Path Revalidations: Triggers Next.js `revalidatePath` on order submission/cancellation to ensure instant client sync.
- • Zod Validation: Strict schemas validating user settings and category updates.
cloud_queueSupabase Backend
- • Supabase SSR client: Manages cookie-based session verification for server-side fetches.
- • PostgreSQL Database: Hosts relational tables (profiles, products, orders, delivery_locations).
- • Supabase Storage: Buckets housing uploaded farm product images securely.
Project Screen Library
Click on any of the screenshots below to open them in the lightbox viewer.
