Wocart
The open-source, cash-on-delivery commerce platform for Algeria.
Wocart was formerly called CodFlow. The repository, packages, environment
variables and live domains still carry the old name where renaming would
break existing stores.
Run a whole store on your own Cloudflare account: storefront, merchant
dashboard and API on Workers, D1, R2 and KV, with no transaction fees. Ship to
Algeria's carriers or your own drivers, and send Meta the orders that were
really delivered.
Documentation: docs.wocart.store
[!TIP]
Rather not set it up yourself? Wocart Cloud
deploys the same stores to your own Cloudflare account in a few clicks, with a
visual editor for their themes.
What is in the box
Storefront (cod-astro/theme-00, built on the published
@wocart/storefront and
@wocart/theme SDKs)
- One-page cash-on-delivery order form, home delivery or carrier stop desk,
with live shipping prices
- Arabic (right-to-left), French and English
- Landing pages, collections, offers (gifts, free shipping, quantity pricing)
and coupons
- An optional shopping cart, off by default
- Reviews from verified orders, with photos and a voice note
- Legal pages (terms, privacy, refunds, shipping), pre-written and editable
- Optional WhatsApp phone verification (DZVerify) and
Cloudflare Turnstile bot protection
Merchant dashboard (cod-client-astro)
- Orders as work queues, from confirmation to delivery and returns
- Products with variants, stock and low-stock alerts
- Customers, groups and tags; abandoned checkouts
- Team roles with fine-grained permissions, and API keys
- Apps: Meta, DZVerify, Turnstile, Sendili email, WhatsApp button, Telegram
and Reviews
Delivery
- Four carrier platforms behind one contract: Yalidine (and Guepex),
ZR Express, NOEST and the EcoTrack platform
- Your own drivers, with per-wilaya pay and cash settlement
- Signed webhooks from Yalidine and ZR Express; the others are synced every
five minutes
Growth and integration
- Meta Pixel and Conversions API, with the conversion you choose:
Lead or
Purchase at order, at confirmation or at delivery
- Signed, retried webhooks for every order and delivery event
- A documented REST API (OpenAPI) and an MCP server for AI agents
Get started
Features, one page each:
shopping cart ·
order form ·
phone verification ·
bot protection ·
Meta ·
legal pages ·
email
npm packages
Build your own storefront or theme on the same SDKs Theme-00 uses.
| Package | What it is |
|---|
| The storefront SDK: typed catalog reads, basket, checkout, phone verification and order tracking, with Astro adapters |
| The theme contract: component definitions, JSON page documents, and a reference Astro renderer |
| Starts a new theme on both SDKs |
npm create wocart-theme@latest my-theme
Repository
| Folder | What it is |
|---|
cod-server/ | The API: Hono on Cloudflare Workers, D1 through Drizzle |
cod-client-astro/ | The merchant dashboard (Astro) |
cod-shared/ | Schema, queries, permissions and error codes shared by both |
cod-astro/theme-00/ | The reference storefront theme |
cod-docs/ | The documentation site, in English, French and Arabic |
npm ci # every workspace, from the repo root
cd cod-server && npm test # and the same in cod-client-astro
(cd cod-astro/theme-00 && npm ci && npm test) # the theme, on the npm SDKs
Contributing
Contributions are welcome. Read CONTRIBUTING.md first;
AGENTS.md holds the repository's rules for coding agents. Keep
credentials out of commits, and every claim in this README true to the code.
Security issues: see SECURITY.md. Release notes:
CHANGELOG.md.
License
Apache License 2.0. See also NOTICE.
Repository: github.com/bighadj22/Wocart
