Skip to content
Back to search

codflow

The open-source, COD-first e-commerce + delivery platform for Algeria built agentic-ready.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/bighadj22/Wocart with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/bighadj22/Wocart'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/bighadj22--codflow/badge.svg)](/listings/bighadj22--codflow)

HTML

<a href="/listings/bighadj22--codflow"><img src="/api/listings/bighadj22--codflow/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Run CodFlow locally in 5 steps:

> 🤖 **Using an AI Coding Assistant?** CodFlow includes an autonomous setup skill. Tell your agent: *"Set up CodFlow"* and it will follow the [`codflow-setup` runbook](./.agents/skills/codflow-setup/SKILL.md).

**Already set up and want the latest version?** Don't redo the setup. Tell your agent: *"Update CodFlow"* — it will follow the [`codflow-update` runbook](./.agents/skills/codflow-update/SKILL.md), which pulls the latest code from this repository's `main` branch, applies new database migrations, keeps your resources, secrets, and store data intact, rebuilds and redeploys your workers, and reports each step in plain language.

Prerequisites

- **Node.js 22.12+** and npm - **Wrangler CLI**: `npm install -g wrangler` - Free **Cloudflare account**

1. Clone & Install

git clone https://github.com/bighadj22/codflow.git
cd codflow
npm ci

2. Create Cloudflare Resources

Names are yours to choose — scripts read them from the root `.env` (see step 3), so nothing is hardcoded.

wrangler login
wrangler d1 create my-codflow-db
wrangler r2 bucket create my-codflow-images
wrangler kv namespace create RATE_LIMIT
wrangler kv namespace create OAUTH_KV

3. Configure Environment

# Repo root — resource names for the seeders, the D1 wrapper, the R2 CORS
# setup and the storefront deploy helper. Precedence: process.env > .env > default.
cp .env.example .env
# Set COD_ACCOUNT_ID, COD_DB_NAME, COD_R2_BUCKET_NAME, COD_SERVER_URL, COD_MEDIA_DOMAIN

# Backend
cd cod-server
cp .dev.vars.example .dev.vars
cp wrangler.toml.example wrangler.toml
# Update wrangler.toml with your D1 database_id, R2 bucket_name, KV ids

# Dashboard
cd ../cod-client-astro
cp wrangler.toml.example wrangler.toml   # same D1 database_id as cod-server + your KV id
cp .env.example .env
cp .dev.vars.example .dev.vars
# Set BETTER_AUTH_SECRET (same value as cod-server's, e.g. openssl rand -hex 32)

# Storefront
cd ../cod-astro/theme01
cp .dev.vars.example .dev.vars

4. Setup Database & Admin

cd cod-server
npm run db:setup:local

cd ../cod-client-astro
ADMIN_EMAIL=admin@example.com ADMIN_NAME=Admin npm run seed:admin
# ⚠️ Save the generated password and API key

5. Start Dev Servers

Open three terminals:

# Terminal 1: Backend (http://localhost:8787)
cd cod-server && npm run dev

# Terminal 2: Dashboard (http://localhost:4321)
cd cod-client-astro && npm run dev

# Terminal 3: Storefront (http://localhost:4321 → use a different port, see theme README)
cd cod-astro/theme01 && npm run dev

> ⚠️ The dashboard and storefront both default to port 4321 — run them on > different ports (`astro dev --port 4322` for one of them) or run only one > at a time.

6. Enable Image Uploads

Product image uploads require R2 API tokens and CORS configuration. See the [R2 setup guide](./cod-server/src/endpoints/images/README.md) for: - Creating R2 API tokens - Setting CORS policy on the bucket - Adding a custom domain for serving images

**Need more detail?** See [`docs/DEPLOYMENT.md`](./docs/DEPLOYMENT.md) for production deployment.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 141 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="imgs/wocart_readme_banner.webp" alt="Wocart — open-source cash-on-delivery commerce for Algeria" width="100%">
  3. </p>
  4. # Wocart
  5. **The open-source, cash-on-delivery commerce platform for Algeria.**
  6. Wocart was formerly called CodFlow. The repository, packages, environment
  7. variables and live domains still carry the old name where renaming would
  8. break existing stores.
  9. [![Telegram](https://img.shields.io/badge/Telegram-Join%20our%20group-2AABEE?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/codflow_dz)
  10. [![Facebook](https://img.shields.io/badge/Facebook-Follow%20us-1877F2?style=for-the-badge&logo=facebook&logoColor=white)](https://www.facebook.com/wocartdz/)
  11. [![Instagram](https://img.shields.io/badge/Instagram-Follow%20us-E4405F?style=for-the-badge&logo=instagram&logoColor=white)](https://www.instagram.com/wocart_dz/)
  12. Run a whole store on your own Cloudflare account: storefront, merchant
  13. dashboard and API on Workers, D1, R2 and KV, with no transaction fees. Ship to
  14. Algeria's carriers or your own drivers, and send Meta the orders that were
  15. really delivered.
  16. **Documentation: [docs.wocart.store](https://docs.wocart.store)**
  17. > [!TIP]
  18. > **Rather not set it up yourself?** [Wocart Cloud](https://cloud.wocart.store)
  19. > deploys the same stores to your own Cloudflare account in a few clicks, with a
  20. > visual editor for their themes.
  21. >
  22. > [![Wocart Cloud](https://img.shields.io/badge/Wocart%20Cloud-Deploy%20a%20store-6D28D9?style=for-the-badge&logo=cloudflare&logoColor=white)](https://cloud.wocart.store)
  23. ---
  24. ## What is in the box
  25. **Storefront** (`cod-astro/theme-00`, built on the published
  26. [`@wocart/storefront`](https://www.npmjs.com/package/@wocart/storefront) and
  27. [`@wocart/theme`](https://www.npmjs.com/package/@wocart/theme) SDKs)
  28. - One-page cash-on-delivery order form, home delivery or carrier stop desk,
  29. with live shipping prices
  30. - Arabic (right-to-left), French and English
  31. - Landing pages, collections, offers (gifts, free shipping, quantity pricing)
  32. and coupons
  33. - An optional shopping cart, off by default
  34. - Reviews from verified orders, with photos and a voice note
  35. - Legal pages (terms, privacy, refunds, shipping), pre-written and editable
  36. - Optional WhatsApp phone verification ([DZVerify](https://dzverify.com)) and
  37. Cloudflare Turnstile bot protection
  38. **Merchant dashboard** (`cod-client-astro`)
  39. - Orders as work queues, from confirmation to delivery and returns
  40. - Products with variants, stock and low-stock alerts
  41. - Customers, groups and tags; abandoned checkouts
  42. - Team roles with fine-grained permissions, and API keys
  43. - Apps: Meta, DZVerify, Turnstile, Sendili email, WhatsApp button, Telegram
  44. and Reviews
  45. **Delivery**
  46. - Four carrier platforms behind one contract: Yalidine (and Guepex),
  47. ZR Express, NOEST and the EcoTrack platform
  48. - Your own drivers, with per-wilaya pay and cash settlement
  49. - Signed webhooks from Yalidine and ZR Express; the others are synced every
  50. five minutes
  51. **Growth and integration**
  52. - Meta Pixel and Conversions API, with the conversion you choose: `Lead` or
  53. `Purchase` at order, at confirmation or at delivery
  54. - Signed, retried webhooks for every order and delivery event
  55. - A documented REST API (OpenAPI) and an MCP server for AI agents
  56. ## Get started
  57. | I want to… | Read |
  58. | :--- | :--- |
  59. | Run it on my machine | [Local setup](https://docs.wocart.store/self-hosting/local) |
  60. | Put it in production | [Deploy](https://docs.wocart.store/self-hosting/deploy) |
  61. | Set every variable and binding | [Configuration](https://docs.wocart.store/self-hosting/configuration) |
  62. | Choose where images are stored | [Media](https://docs.wocart.store/self-hosting/media) |
  63. | Upgrade a running store | [Upgrading](https://docs.wocart.store/self-hosting/upgrading) |
  64. | Know what is not done yet | [Limitations](https://docs.wocart.store/self-hosting/limitations) |
  65. | Understand how it fits together | [Architecture](https://docs.wocart.store/architecture) |
  66. | Build a theme | [Theme SDK](https://docs.wocart.store/sdk/theme) |
  67. | Build a storefront | [Storefront SDK](https://docs.wocart.store/sdk/storefront) |
  68. | Call the API | [API reference](https://docs.wocart.store/api) |
  69. Features, one page each:
  70. [shopping cart](https://docs.wocart.store/features/cart) ·
  71. [order form](https://docs.wocart.store/features/order-form) ·
  72. [phone verification](https://docs.wocart.store/features/phone-verification) ·
  73. [bot protection](https://docs.wocart.store/features/bot-protection) ·
  74. [Meta](https://docs.wocart.store/features/meta) ·
  75. [legal pages](https://docs.wocart.store/features/legal-pages) ·
  76. [email](https://docs.wocart.store/features/email)
  77. ## npm packages
  78. Build your own storefront or theme on the same SDKs Theme-00 uses.
  79. | Package | What it is |
  80. | :--- | :--- |
  81. | [![@wocart/storefront](https://img.shields.io/npm/v/@wocart/storefront?label=%40wocart%2Fstorefront&color=6D28D9)](https://www.npmjs.com/package/@wocart/storefront) | The storefront SDK: typed catalog reads, basket, checkout, phone verification and order tracking, with Astro adapters |
  82. | [![@wocart/theme](https://img.shields.io/npm/v/@wocart/theme?label=%40wocart%2Ftheme&color=6D28D9)](https://www.npmjs.com/package/@wocart/theme) | The theme contract: component definitions, JSON page documents, and a reference Astro renderer |
  83. | [![create-wocart-theme](https://img.shields.io/npm/v/create-wocart-theme?label=create-wocart-theme&color=6D28D9)](https://www.npmjs.com/package/create-wocart-theme) | Starts a new theme on both SDKs |
  84. ```sh
  85. npm create wocart-theme@latest my-theme
  86. ```
  87. ## Repository
  88. | Folder | What it is |
  89. | :--- | :--- |
  90. | `cod-server/` | The API: Hono on Cloudflare Workers, D1 through Drizzle |
  91. | `cod-client-astro/` | The merchant dashboard (Astro) |
  92. | `cod-shared/` | Schema, queries, permissions and error codes shared by both |
  93. | `cod-astro/theme-00/` | The reference storefront theme |
  94. | `cod-docs/` | The documentation site, in English, French and Arabic |
  95. ```sh
  96. npm ci # every workspace, from the repo root
  97. npm run typecheck && npm test # cod-server, then the dashboard
  98. (cd cod-astro/theme-00 && npm ci && npm test) # the theme, on the npm SDKs
  99. ```
  100. ## Contributing
  101. Contributions are welcome. Read [CONTRIBUTING.md](./CONTRIBUTING.md) first;
  102. [AGENTS.md](./AGENTS.md) holds the repository's rules for coding agents. Keep
  103. credentials out of commits, and every claim in this README true to the code.
  104. Security issues: see [SECURITY.md](./SECURITY.md). Release notes:
  105. [CHANGELOG.md](./CHANGELOG.md).
  106. ## License
  107. [Apache License 2.0](./LICENSE). See also [NOTICE](./NOTICE).
  108. Repository: [github.com/bighadj22/Wocart](https://github.com/bighadj22/Wocart)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.