Reading the repo
Opening the box…
Reading the repo
Opening the box…
Assembly instructions
Free, self-hosted e-commerce for Algerian small businesses and individuals.
Saved setup from 10 h ago
Will it work on macOS?
Heads-upBuilding it yourself? It also needs 12 settings in .env (3 secret).
CONTRIBUTING.mdHelp is wanted. Most of it does not require being a developer.
OpenStore exists because shop owners in Algeria were paying 999 DZD a month plus a 35,000 to 65,000 DZD setup fee, or selling through Instagram DMs, because there was no affordable option. The most valuable contributions, in rough order:
git clone https://github.com/Meykiio/openstore-dz.git
cd openstore-dz
npm install
cp .env.example .env
Then follow the setup prompt in README.md. You need a Supabase project, either local
via Docker or free in the cloud.
npm run check
This runs typecheck, lint, 19 tests, a dead-code scan and a production build. All must pass. If you touch the database, also run:
npx supabase db advisors
.env files, API tokens, or database credentials.supabase/schema.sql, never through the Supabase console.feat(orders): add refusal reason field
fix(checkout): keep delivery fee visible after submit
docs(setup): clarify the Docker path in the README prompt
refactor: split OrderRow out of OrderList
test: cover the delivery fee calculator
supabase/schema.sql is the single source of truth. There are no migration files by
design, so that a shop owner can install with one paste.
GRANT. PostgREST checks
grants before policies; without the grant you get a 401 that looks like a policy bug.WITH CHECK clause, or a row can be updated into someone else's
ownership.(select fn()) so they evaluate once per statement
instead of once per row.Do not open a public issue. See SECURITY.md.
Contributions are accepted under AGPL-3.0-only, the same licence as the project.
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install
git clone https://github.com/Meykiio/openstore-dz.git cd openstore-dz
Node.js >=20.19.0
# needs nvm: brew install nvm (or https://github.com/nvm-sh/nvm) nvm install --lts
Fill in secrets: VITE_SUPABASE_PUBLISHABLE_KEY, GUEPEX_API_TOKEN, E2E_ADMIN_PASSWORD
cp .env.example .env
npm ci
npm run dev
npm test
git clone https://github.com/Meykiio/openstore-dz.git
cd openstore-dz
npm install
npx supabase start # or create a free project at supabase.com
cp .env.example .env # paste your URL and publishable key
npm run dev # http://localhost:8080
The one-click prompt below does all of that for you, including filling in the keys.
No reports for macOS yet.
GitManual AI Agent reads the 7 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.