Repository navigation
Home
Farm fresh, just a click away. GleanGrid is an open-source pre-order marketplace for the farmers markets of Hyderabad, Sindh. Farmers publish their weekly stock, prices and pickup windows; customers reserve produce online and collect it at the stall, paying the farmer in person.
🌐 Live: gleangrid.ahmershah.dev · 📦 Code: ahmershahdev/GleanGrid · ⚖️ MIT licence
| I want to… | Read |
|---|---|
| Run GleanGrid on my machine | Getting Started |
| Understand how it's built | Architecture · Database Design |
| Learn how an order moves | Order Lifecycle |
| Use it as a shopper | Customer Guide |
| Sell on it | Farmer Guide |
| Run the platform | Admin Guide |
| Know how it's protected | Security Model |
| Understand online payments | Payments |
| See how it never oversells | Race Conditions |
| Put it online | Deployment |
| Add a language or fix a translation | Internationalisation |
| Understand SEO, speed and accessibility work | SEO and Performance |
| Run the tests / CI | Testing and CI |
| Fix a problem | Troubleshooting |
| Contribute | Contributing |
Shoppers rarely know which farmers will be at a market, what they'll bring, or at what price — so they arrive to sold-out stalls. Farmers can't take orders before market day, so they guess how much to pick. GleanGrid puts the week's stock online, lets customers reserve it against real inventory and choose a pickup window, and lets them pay online (Easypaisa, JazzCash or card) or at the stall, farmer to customer.
- Online payments with Easypaisa, JazzCash or card — or cash at pickup — with automatic refunds. No delivery, by design (MarketLink SRS §1.5).
- Sign in with Google or Facebook, price-history charts, a Sindh seasonal calendar, photo reviews, stall badges and back-in-stock alerts.
- Three roles: customer, farmer, administrator — each with its own dashboard.
- Eight languages including right-to-left Urdu and Arabic; light and dark themes.
- Built for bursty market mornings: row-level locks on stock, coupons and pickup capacity, idempotent payments, after-commit notifications — proven with a 50-process stress test.
- Layered protection: signed form tickets, Cloudflare Turnstile / reCAPTCHA v3, CSRF tokens regenerated on every page load, a new CSP nonce on every response, Argon2id, HMAC-verified payment callbacks.
Laravel 12 · PHP 8.2+ · Inertia.js 3 · React 19 · Tailwind CSS 4 · Vite 8 · Motion + Lenis · Leaflet / OpenStreetMap / OSRM · Recharts · MySQL 8 / MariaDB 10.4+ · Resend (e-mail).
GleanGrid was designed and built solely by Syed Ahmer Shah for the Aptech TechWiz 7 championship, answering the MarketLink — eGreen Basket brief.
Read the story: the case study (how it was designed and built) · The Last Mango Problem (race conditions in the checkout).