One connected system for Moroccan commerce — built at the edge, owned by the business that runs it.
Atlas Commerce (web · Android · desktop) · Atlas Shop · Support
🔄 Auto-refreshed from the GitHub API — last update 2026-11-10. No manual edits needed.
What we do · Repositories · Done · Not done yet · Roadmap · Contact
Etherealmber is a software organization based in Morocco, building one connected platform for the businesses that keep the country running: wholesalers, shops, warehouses, workshops and family companies.
We ship one product family, not a pile of disconnected tools. Atlas Commerce is the operational core — stock, checkout, invoicing, purchasing, staff. Everything else connects to it: the native Android app moves with it, the Rust desktop client mirrors it, and the shop front we are building now reads directly from it.
No opaque SaaS subscriptions, no dedicated servers, no locked-in vendor. Every deployment lives in the client's own Cloudflare account, and the business owns the database, the backups and the code.
This page maintains itself. Counts, versions and progress bars are regenerated by
scripts/update-profile.mjsthrough the profile workflow — daily, on every push, or on demand. Versions come from each repository's releases andpackage.json; estimates come fromprofile/progress.json.
| Retail & wholesale operations | Multi-warehouse stock, bin locations, lots + FEFO expiry, thresholds, audited movements, rolling inventory, transfers, kits/BOM |
| Checkout & cash | Fast POS with VR receipts, multi-method payments, refunds, cash drawer balance |
| Invoicing & receivables | VAT invoices, due dates, credit notes, status pipeline + journal, CSV exports, Partner API v1, event webhooks |
| Purchasing & suppliers | Bills, receipts, supplier references and price breaks |
| People & money | Clients (ICE, credit limits), vendors, employees, cash balance, expenses, finance reports |
| Scan & OCR | Native barcode scanning, photo-driven product requests, invoice and quote OCR |
| AI assistance | Atlas Agent — grounded on live stock, sales and balances, with per-action permissions and confirmation |
| Security | Password + OTP, WebAuthn / passkeys, 60-second single-use QR pairing, device fingerprint binding, role-based access, audit log |
| Field & desktop | Native Kotlin app for Android 9+, Rust desktop client for Windows / macOS / Linux |
| Repository | What it is | Version | Delivery |
|---|---|---|---|
| atlas-commerce | ERP / POS / invoicing core — Cloudflare Workers, D1, R2, React |  |
 |
| atlas-commerce-android | Native Android companion — Kotlin + Jetpack Compose, Android 9+ |  |
  |
| atlas-commerce-desktop | Native desktop client — Rust + egui, Windows / macOS / Linux |  |
  |
| afmarbre-main | Client platform — catalogue, quotes, CMS admin on Workers | — |
 |
| .github | Organization profile and brand assets (this page) | — |
  |
Operational core (shipping today)
- Stock — multi-warehouse, bin locations, lots + FEFO expiry, thresholds, audited movements, rolling inventory, transfers, kits/BOM
- Point of sale — VR receipts without VAT, multi-method payments, refunds, cash drawer balance
- Invoicing — VAT invoices, receivables and due dates, credit notes, CSV export, status pipeline with journal
- Purchasing — bills, receptions, supplier references, price breaks
- Parties — clients with ICE and credit limits, vendors, employees
- Scan & OCR — native barcode scanning, photo-driven product requests, invoice/quote OCR
- Atlas Agent (AI) — grounded on live data, per-action permissions, explicit confirmation before writes
- Authentication — password + OTP, WebAuthn / passkeys, 60-second single-use QR pairing, Turnstile, rate limiting
- Administration — users and roles, API keys + webhooks, encrypted D1 → R2 backups, audit log, version journal
- Partner API v1 — scoped keys,
Idempotency-Keywrites, OpenAPI document - Output — printable labels (QR + CODE128 + price), reports, alert center
Engineering delivery
- Full roadmap v209 delivered — 10 / 10 workstreams (scan-first operations, lots/FEFO, alert center, supplier parts, status pipeline, labels, kits/BOM, attachments QC, bin locations, webhooks)
- CI guards — no API or front-end change merges without passing the gates
- GitHub automations — automatic issue triage (FR/EN), self-repair bots, release/support sync blocks
- Self-hosting documentation:
SETUP.md, Android ↔ Worker contract, WebAuthn guide, finance API docs
Native companion, shipping continuously
- Native Kotlin + Jetpack Compose (Material 3),
minSdk 28— Android 9+ including handheld scanners - Strict multi-server & multi-account isolation —
AES-256-GCMper server,SHA-256scoped caches, full purge on switch - Guided onboarding — server URL → live
/api/healthprobe (D1 + R2) → sign-in - Sign-in — password + OTP, one-tap email verification link, or QR pairing from the PC
- Operations — stock, POS quick sales, receipts, invoices, barcode scanning, alert inbox
- Atlas Agent — synchronized threads with the web app, live token quota bars
- Security — no password stored, opt-in biometric / device-PIN unlock, camera released when leaving Scan
- Privacy — crash reporting off unless explicitly opted in
- Extras — monthly PDF reports with 7-day private cache, OTA APK updates, issue templates, bug-hunter workflow
Native client for Windows, macOS and Linux
- Rust + egui (fastframe) — no browser engine, no telemetry,
reqwest+ rustls - Guided start — splash, welcome, server choice with live
/api/healthprobe, saved servers - Sign-in — password + OTP,
atlascommerce://verifydeep link, QR pairing - Screens — dashboard, products and stock movements, invoice history, quick sales with idempotency keys, Atlas Agent, notifications
- Desktop life — custom title bar, tray, single instance, start-at-login, refresh interval, native notifications
- Security — device fingerprint (
X-Device-Fingerprint) bound to sessions, no password ever stored,0600files - Updates — GitHub Releases only,
update.json,checksums.txt, Ed25519 signature, blocking mandatory updates
- Organization profile, brand and documentation live in
.github - Client deployment running for A-F Marbre (Worker + KV + D1 + R2, catalogue, quotes, CMS admin)
- Releases, pull requests and issues tracked live in the counters at the top of this page
Honest list — these are the open items, in the order they are being worked on.
| Item | Status | Notes |
|---|---|---|
| Atlas Shop — connected storefront |  ⚪ not started |
Plans to read products, prices, stock and media from Atlas Commerce through the Partner API + webhooks. Repository not created yet |
| Support portal |  ⚪ planned |
Sync hooks (SUPPORT-SYNC) already wired into the Atlas Commerce README; no standalone portal yet |
| DGI e-invoicing clearance |  🟡 partial |
UBL 2.1 output and legal mentions exist locally; real-time clearance waits on the official API (mandate 2026–2028) |
| Attendance module |  🟡 backend only |
Settings flag and data model in place, UI not delivered |
| Android ↔ Worker agent parity |  🟡 in progress |
SSE contract (token, tool, done, error) documented; Android-side integration still to ship |
| Payroll bulletin & CSV export |  🟡 partial |
Employee records done; CNSS / AMO bulletin and export pending |
| Customer dunning | ⚪ not started |
Reminders for unpaid invoices (email / WhatsApp link) |
| Accounting export (FEC-like) | ⚪ not started |
Accountant-ready ledger export |
| Desktop feature parity |  🟡 early |
Core screens done, remaining modules follow the web + Android |
| Worker monolith peel |  🟡 ongoing |
routes/, repositories/, services/ extracted; index.ts still carries clusters |
| TypeScript baseline cleanup |  🟡 ongoing |
~310 pre-existing tsc errors tracked as deltas only |
| Product | Progress | Reading |
|---|---|---|
| Atlas Commerce (web core) |  85 % |
Feature-complete core at 0.8.0-beta, in beta; remaining work is hardening, payroll, DGI readiness |
| Atlas Commerce Android |  90 % |
Stable daily use at 1.5.3; Atlas Agent SSE parity outstanding |
| Atlas Commerce Desktop | 55 % |
Core modules shipped at 0.1.9; parity work continues |
| Atlas Shop | 0 % |
Not started — the next major build |
| Support portal | 10 % |
Planned, sync hooks prepared |
| One connected platform | 55 % |
Commerce + native clients live; the shared connection layer and shop complete the picture |
Percentages are engineering estimates derived from shipped scope versus the documented 2026–2027 target, not billing or commercial data.
Legend — 🟢 done · 🟡 in progress · ⚪ planned
2026 Q4 ──┤ Atlas Commerce 1.0 · Android 2.0 · desktop hardening
2027 Q1 ──┤ Atlas Shop v1 (catalogue) · Support portal v1
2027 Q2 ──┤ Atlas Shop checkout · shared connection layer · desktop parity
2027 Q3 ──┤ Unified accounts, alerts & billing across the suite · DGI readiness
2027 Q4 ──┤ Complete, enhanced system · docs · v1.x everywhere
| Quarter | Milestone | Scope | Status | Progress |
|---|---|---|---|---|
| Q4 2026 | Atlas Commerce 1.0 | Close the gap to general availability: hardening, payroll bulletin, attendance UI, remove the beta tag (live: 0.8.0-beta) |
🟡 in progress | |
| Q4 2026 | Atlas Commerce Android 2.0 | Agent SSE parity with the web, final stability pass, store-ready release (live: 1.5.3) |
🟡 in progress | |
| Q4 2026 | Desktop 0.2 | Reach usable parity on stock, clients and invoices (live: 0.1.9) |
🟡 in progress | |
| Q1 2027 | Atlas Shop v1 — catalogue | New repository; products, prices, stock availability and media read live from Atlas Commerce via Partner API v1 | ⚪ not started | |
| Q1 2027 | Support portal v1 | Public help, requests and status, connected to the same customer records | ⚪ planned | |
| Q2 2027 | Atlas Shop — orders & checkout | Cart, orders, payment options, stock reservation written back to the ERP | ⚪ planned | |
| Q2 2027 | Shared connection layer | One contract across Commerce ↔ Shop ↔ Android ↔ Desktop ↔ Support: scoped keys, idempotency, stock.* / doc.* webhooks |
🟡 partial |  |
| Q2 2027 | Desktop 1.0 | Full module parity and signed auto-updates for all three platforms (live: 0.1.9) |
⚪ planned | |
| Q3 2027 | Unified experience | Single sign-on across products, one alert inbox, one customer view | ⚪ planned |  |
| Q3 2027 | DGI e-invoicing readiness | Clearance pipeline the moment the official API opens; 10-year archive | 🟡 partial | |
| Q4 2027 | Complete, enhanced system | Documentation, polish, migrations, v1.x across every client — one platform | ⚪ planned |  |
Targets, stated plainly
- ✅ End of 2026 — Atlas Commerce and Atlas Commerce for Android finished
- 🛍️ During 2027 — Atlas Shop connected to Atlas Commerce, support page launched
- 🚀 Before the end of 2027 — the complete, enhanced system
one system products share data, not just branding
edge-first Cloudflare Workers · D1 · R2 · Durable Objects
no lock-in the client owns the account, the data and the deploy
private by default secrets in Wrangler, never in the repo
native clients Kotlin and Rust — no browser engine on phone or desktop
French terrain UI written for the field, in the language of the field
verifiable work CI guards, issue bots, signed releases
- 🔒 Ownership over convenience — the business owns the database, the backups and the code
- ⚡ Fast where it hurts — one scan, one keypress, one ticket
- 🧩 Boring infrastructure — one Worker, one SQLite database, one bucket
- 🇲🇦 Local reality first — ICE/IF, VAT, VR receipts, French labels, phone-first usage
- 📖 Working in the open — MIT where we can, READMEs that explain the system
- 🐛 Bugs & features — issues on atlas-commerce · Android · Desktop
- 🔐 Security — private report through a GitHub security advisory; please don't disclose publicly before a fix
- 🤝 Work with us — demos and deployments: reach us through GitHub
- 🌍 Based in Morocco · working across the country
Thank you for the support. Every issue, report and piece of feedback is what turns this into a complete system by 2027. 🙏
Built in Morocco, deployed on the edge. 🇲🇦
MIT © 2026 Etherealmber · stats auto-refreshed by workflow
