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.
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
Markdown
[](/listings/bighadj22--codflow)HTML
<a href="/listings/bighadj22--codflow"><img src="/api/listings/bighadj22--codflow/badge.svg" alt="findsafeskills safety rating" /></a>Install
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.
- <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.
- [](https://t.me/codflow_dz)
- [](https://www.facebook.com/wocartdz/)
- [](https://www.instagram.com/wocart_dz/)
- 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](https://docs.wocart.store)**
- > [!TIP]
- > **Rather not set it up yourself?** [Wocart Cloud](https://cloud.wocart.store)
- > deploys the same stores to your own Cloudflare account in a few clicks, with a
- > visual editor for their themes.
- >
- > [](https://cloud.wocart.store)
- ---
- ## What is in the box
- **Storefront** (`cod-astro/theme-00`, built on the published
- [`@wocart/storefront`](https://www.npmjs.com/package/@wocart/storefront) and
- [`@wocart/theme`](https://www.npmjs.com/package/@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](https://dzverify.com)) 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](https://docs.wocart.store/self-hosting/local) |
- | Put it in production | [Deploy](https://docs.wocart.store/self-hosting/deploy) |
- | Set every variable and binding | [Configuration](https://docs.wocart.store/self-hosting/configuration) |
- | Choose where images are stored | [Media](https://docs.wocart.store/self-hosting/media) |
- | Upgrade a running store | [Upgrading](https://docs.wocart.store/self-hosting/upgrading) |
- | Know what is not done yet | [Limitations](https://docs.wocart.store/self-hosting/limitations) |
- | Understand how it fits together | [Architecture](https://docs.wocart.store/architecture) |
- | Build a theme | [Theme SDK](https://docs.wocart.store/sdk/theme) |
- | Build a storefront | [Storefront SDK](https://docs.wocart.store/sdk/storefront) |
- | Call the API | [API reference](https://docs.wocart.store/api) |
- Features, one page each:
- [shopping cart](https://docs.wocart.store/features/cart) ·
- [order form](https://docs.wocart.store/features/order-form) ·
- [phone verification](https://docs.wocart.store/features/phone-verification) ·
- [bot protection](https://docs.wocart.store/features/bot-protection) ·
- [Meta](https://docs.wocart.store/features/meta) ·
- [legal pages](https://docs.wocart.store/features/legal-pages) ·
- [email](https://docs.wocart.store/features/email)
- ## npm packages
- Build your own storefront or theme on the same SDKs Theme-00 uses.
- | Package | What it is |
- | :--- | :--- |
- | [](https://www.npmjs.com/package/@wocart/storefront) | The storefront SDK: typed catalog reads, basket, checkout, phone verification and order tracking, with Astro adapters |
- | [](https://www.npmjs.com/package/@wocart/theme) | The theme contract: component definitions, JSON page documents, and a reference Astro renderer |
- | [](https://www.npmjs.com/package/create-wocart-theme) | Starts a new theme on both SDKs |
- ```sh
- 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 |
- ```sh
- 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](./CONTRIBUTING.md) first;
- [AGENTS.md](./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](./SECURITY.md). Release notes:
- [CHANGELOG.md](./CHANGELOG.md).
- ## License
- [Apache License 2.0](./LICENSE). See also [NOTICE](./NOTICE).
- Repository: [github.com/bighadj22/Wocart](https://github.com/bighadj22/Wocart)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.