Releases: bighadj22/codflow
Release list
v1.1.0 — Astro Dashboard Cutover
The dashboard cutover release
The merchant dashboard moves from Next.js to Astro (cod-client-astro): prerendered static pages (zero Worker CPU for page serving) with a better-auth worker surface. The legacy Next.js dashboard stays in the tree marked LEGACY until removal.
Highlights
- 🛒 WhatsApp OTP verification (dzverify) — optional per-store phone verification at checkout, off by default, fail-open on provider quota exhaustion. Configure in Dashboard → Settings → Verification.
- 🚚 EcoTrack integration — 82 Algerian couriers (DHD, Conexlog, MSM Go, Packers, World Express…) behind one API, with credentials, catalog sync, and reconciliation.
- 🤖 MCP SDK v2 — OAuth via
@cloudflare/workers-oauth-provider(RFC 9728/8414 discovery, dynamic client registration, token revocation), stateless HMAC-sealed elicitation, dashboard login-ticket relay. - 💸 COD amount fix — the amount sent to carriers now includes the delivery fee (product price + fee).
- 🧪 Fresh-cloner experience — shared local D1, admin seeder, complete runbooks, CI for all 4 packages, no stale docs.
Migration notes (existing deployments)
- Create an
OAUTH_KVKV namespace and bind it in cod-server's wrangler.toml - Set new secrets on cod-server:
MCP_REQUEST_STATE_KEYandMCP_LOGIN_TICKET_SECRET - Set the same
BETTER_AUTH_SECRETandMCP_LOGIN_TICKET_SECRETon the cod-client-astro worker - Apply migration 0012:
cd cod-server && npm run db:migrate:remote - Deploy cod-server → cod-client-astro → theme01
See CHANGELOG.md for the full list.
CodFlow v1.0.0
First stable release of CodFlow — the open-source, COD-first e-commerce and delivery platform for Algeria, self-hosted on your own Cloudflare account.
Highlights
- COD-First Commerce Engine — full order lifecycle (pending → confirmed → dispatched → delivered / returned), offers & bundles, inventory with stock alerts, customer CRM, review moderation, team RBAC, and an activity audit trail.
- 58-Wilaya Delivery — unified adapters for Yalidine, ZR Express, NOEST, and EcoTrack plus an in-house driver fleet: dispatch, printable labels, stop-desk sync, per-wilaya driver pay, partial/full returns.
- Real-Delivery Meta CAPI — a Cloudflare Workflow fires
Purchaseevents only when cash is collected at the door, with durable retries and full advanced-matching hashing. - Agentic Core (MCP) — remote MCP server on Durable Objects with OAuth 2.1 + scoped RBAC tools; connects Claude Desktop, Cursor, ChatGPT, or custom agents.
- Edge Storefront — Astro 7 SSR, trilingual AR/FR/EN with native RTL, single-page COD checkout, volume offers, order-verified reviews.
- Self-Hosted & Fee-Free — Workers + D1 + R2 + KV under your account; auto-generated OpenAPI 3.1 docs at
/api/docs; ~1,150 automated tests across backend, dashboard, and storefront.
Getting Started
git clone https://github.com/bighadj22/codflow.git
cd codflow
npm ci # npm workspaces — one install for all packagesThen follow the setup guide in the README to create your Cloudflare resources, migrate/seed the database, and deploy. AI-assisted setups can simply tell their agent: "Set up CodFlow" — it follows the included codflow-setup runbook.
Notes
- Production storefronts should serve
cod-serverfrom a custom domain (Cloudflare blocks Worker→Worker fetches between*.workers.devhosts). - Full change details in CHANGELOG.md.
Thanks to everyone testing and contributing — this release makes a fresh clone run end-to-end out of the box. 🇩🇿