Wocart README

The project's README from github.com/bighadj22/Wocart. As one markdown file: README.md.

Wocart — open-source cash-on-delivery commerce for Algeria

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.

Telegram Facebook Instagram

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.

Wocart Cloud


What is in the box

Storefront (cod-astro/theme-00, built on the published @wocart/storefront and @wocart/theme SDKs)

Merchant dashboard (cod-client-astro)

Delivery

Growth and integration

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
@wocart/storefront The storefront SDK: typed catalog reads, basket, checkout, phone verification and order tracking, with Astro adapters
@wocart/theme The theme contract: component definitions, JSON page documents, and a reference Astro renderer
create-wocart-theme 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
npm run typecheck && npm test   # cod-server, then the dashboard
(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

Wocart (bighadj22/Wocart)

Searching Database…

423 ·GitHub
What is this?CodFlow is an open-source, Cash-on-Delivery (COD) e-commerce and delivery platform built specifically for Algeria, deployable on your own Cloudflare account with zero transaction fees.
Is this a single app or a full stack of separate services?It is a self-hosted stack of three apps — a storefront (cod-astro), a merchant dashboard (cod-client-astro), and a backend (cod-server) — all running on Cloudflare Workers with D1, R2, and KV.
How do I get it running?Clone the repo, create Cloudflare D1/R2/KV resources with Wrangler, configure the root .env, run the database/admin setup step, then start the storefront, dashboard, and backend dev servers in separate terminals.
Do I need anything before I start?You need Node.js 22.12+ with npm, the Wrangler CLI, and a free Cloudflare account; no VPS or external database is required.
Any gotchas when running it locally or in production?The storefront and dashboard both default to port 4321, so one must run on a different port locally; in production, Cloudflare blocks Worker-to-Worker fetch between .workers.dev domains, so at least the backend needs a custom domain.
Who owns the store data?CodFlow is fully self-hosted on your own Cloudflare account, so you own the D1 database and R2 images with no vendor lock-in or data export restrictions.
Which Algerian delivery carriers does it support?It integrates 4 Algerian carriers plus EcoTrack, giving access to 80+ couriers through one unified API, with real-time HMAC-verified webhook tracking for Yalidine and ZR Express.
What can an AI agent do through the MCP integration?CodFlow exposes 15 RBAC-gated MCP tool sets (orders, products, stock, landing pages, customers, drivers, etc.) secured via OAuth, letting assistants like Claude, Cursor, ChatGPT, or LibreChat manage the store directly.
Why does it fire ad conversion events at delivery instead of checkout?Meta Pixel normally fires on checkout submission even though 30–50% of COD orders get refused at the door, so CodFlow can fire the server-side Conversions API event only at confirmed delivery to optimize ad spend for real buyers.
How much does hosting actually cost?Because everything runs serverless on Cloudflare Workers, D1, R2, and KV, hosting typically costs $0–$5/month with zero per-transaction fees.
Creator
bighadj22
Size
18.6 MB
Stars
423
Age
2mo
Commits · 90 Days