Codflow MCP Server

<p align="center"> <img src="imgs/wocart_readme_banner.webp" alt="Wocart — open-source cash-on-delivery commerce for Algeria" width="100%"> </p>

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

I want to…	Read
Run it on my machine	Local setup
Put it in production	Deploy
Set every variable and binding	Configuration
Choose where images are stored	Media
Upgrade a running store	Upgrading
Know what is not done yet	Limitations
Understand how it fits together	Architecture
Build a theme	Theme SDK
Build a storefront	Storefront SDK
Call the API	API reference

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