bighadj22/codflow

The open-source, COD-first e-commerce + delivery platform for Algeria built agentic-ready. # CodFlow **The open-source, COD-first e-commerce platform for Algeria — built agentic-ready.** Cash on Delivery meets serverless infrastructure. Self-host your entire commerce stack on Cloudflare with zero transaction fees, connect to Algeria's delivery carriers, and optimize Meta ads for real deliveries instead of door refusals. --- ## Get Started Choose your path: ### 🚀 **I want to run CodFlow** See it in action and deploy your own store. **→ See It in Action** **→ What works today** **→ Quick setup guide** **→ Production deployment** ### 💻 **I want to contribute** Build features or customize CodFlow. **→ Contributing guide** **→ Architecture overview** **→ AI agent instructions** --- ## 🎥 See It in Action Watch the step-by-step setup guide: **▶️ Watch: CodFlow Setup & Deployment Guide** --- ## 🎯 The Problem CodFlow Solves E-commerce in Algeria is **95%+ Cash on Delivery (الدفع عند الاستلام)**. Western platforms like Shopify and local tools charge per-transaction fees, require expensive VPS hosting, and lock your data in their databases. **CodFlow is the first and only open-source COD e-commerce platform built for Algeria.** | The Reality | Western/Local Platforms | CodFlow | | :--- | :--- | :--- | | **Transaction fees eat margins** | 2–5% per order + monthly SaaS fees | **$0 transaction fees** — pay only Cloudflare hosting ($0–$5/mo) | | **Your data locked in their system** | Can't export, can't migrate, vendor lock-in | **You own everything** — D1 database, R2 images, full control | | **Expensive hosting** | VPS servers, maintenance, scaling costs | **Serverless Cloudflare** — auto-scales, zero maintenance | | **4+ carrier portals** | Juggle Yalidine, ZR, NOEST, EcoTrack separately | **Unified carrier API** — one integration for all carriers | | **In-house drivers ignored** | No native driver dispatch or per-wilaya pay | **Built-in driver management** with compensation and cash settlement | | **Ads optimize for form fills, not …