Repository navigation
Releases
v1.1.0: money through time
Added
- Money through time: the background shows Moroccan money one era at a time, today's series first, then from the oldest forward. The eras are the Hassani rial (1882–1920), Moroccan franc (1921–1959), first dirhams (1960–1986) and the 1987, 2002, 2013 and 2023–2024 series. There are 72 notes and coins, each drawn in its true colour, size ratio, value and metal (bimetallic rings included), with its main motif. Wide screens show the era's years and name in the side gutter. The catalogue lives in
src/data/money.ts. (#32)
Changed
- Background pieces sit in the side gutters, where the cards don't cover them, and are a little stronger. On phones they are smaller and fewer, and under reduced motion one era stays still. (#32)
Live: https://darija-money-converter.vercel.app · Full changelog: v1.0.0...v1.1.0
v1.0.0: Hsabli · حسبلي
Changed
- New name: Hsabli · حسبلي ("count it for me"), formerly Chhal?. chhal.ma is an unrelated Moroccan calculator site, so the old name was confusing. hsabli.ma was free on the ANRT-accredited registrar wadi.ma at the time of the switch. The new name appears in the app (Arabic, French, English), page title, install name, share card, backdrop and README; the coin inscription is now Latin (HSABLI · DIRHAM), because browsers don't join Arabic letters on a curved path. The word شحال is still understood when people type it. (#28)
Live: https://darija-money-converter.vercel.app · Full changelog: v0.9.2...v1.0.0
v0.9.2: preload fonts
Readex Pro is preloaded: mobile layout shift 0.155 → 0. Lighthouse on production: mobile 98/100/100/100, desktop 100/100/100/100.
v0.9.1: no direction flip on first paint
Language and direction are set before the first paint (desktop layout shift 0.8 → 0.002). The coin flip button has a clean name, and the result's unit label meets AA contrast.
v0.9.0: polish and voice in every language
Chhal v0.9
- Reads aloud in your language: Darija in Arabic, a French voice in French, an English voice in English. Darija phrases for the seller stay Darija.
- No jumping page (layout shift 0.8 → 0), stronger text contrast (WCAG AA in light and dark), clean coin button name.
- npm run e2e:voice: 25 automated checks with a fake mic and speaker across ar/fr/en and four mic languages. (#24)
v0.8.0: Rif douro and الميا, Oujda douro
Chhal v0.8: the Rif and Oujda count differently, and now so does the app.
- Rif (Nador, Al Hoceima, Driouch, Zaio): 1 douro = 0.5 DH (1 DH = 2 douros), and الميا (مية دورو) = 50 DH = 1,000 rial.
جوج د الميا= 100 DH. (#22) - Oujda / Berkane: 1 douro = 5 santim, the same as a rial (1 DH = 20 douros).
- Franc = santim, especially in the north: 10 DH = 1,000 francs.
- Detect my place puts Nador and Al Hoceima in the Rif. The API takes
region=rif.
These regional values are still marked "needs confirmation". If your city counts differently, use the report link in the app.
v0.7.0: franc, wrapped chips, Moroccan-money background
Chhal v0.7: the franc gets its own unit, the example chips stop getting cut off, and the page background now shows Moroccan money.
Live app: https://darija-money-converter.vercel.app
Highlights
- Franc (#19):
500 فرنك= 5 DH. The franc is the old name of the santim. The dirham replaced the Moroccan franc in 1960 at 100 francs = 1 DH, and the santim took over the subdivision in 1974. The region dialog has a "What is a franc?" switch: centime (default) or a whole dirham, the way some French speakers use it (reported, flagged as unconfirmed). The API takesfranc=santim|dirham. - No more cut-off chips (#18): the "Try:" examples wrap onto new lines, and the result card's buttons move under the amount on narrow phones.
- Background (#20): a zellige field, flag-green and coin-gold glows, and drifting 10 DH coins, 20/50/100/200 DH note silhouettes and the words people say. It is decorative, still under reduced motion, and lighter on phones.
Quality
124 tests pass. Checked in headless Chromium at 375 px in Arabic dark and French light.
Sources for the franc: Wikipedia: Moroccan dirham, Remitly, Journey Beyond Travel. Full list in CHANGELOG.md.
v0.6.0 — live rates API, Moroccan-star coin, Darija voice, place
شحال؟ Chhal? v0.6: a live rates API, the Moroccan star on the coin, Darija voice in and out, and place detection.
Live app: https://darija-money-converter.vercel.app
Highlights
- Live rates API (#13):
GET /api/ratesreturns MAD rates with the daily change and a 30-day history (CORS-open, CDN-cached).GET /api/convert?q=جوج د المليونexposes the Darija parser as JSON. In the app, every currency shows ▲/▼ change and a 30-day sparkline, refreshing every 15 minutes. - Coin logo (#14): a raised, green-enamelled, interlaced Moroccan star on a bimetallic coin. There is deliberately no royal portrait: the King's image is legally protected and a portrait side would imitate real currency.
- Voice (#15)
- The mic understands Darija, Standard Arabic, French and English (
عشرون ألف ريال,vingt mille rials,fifteen thousand), with live text and a level meter. - Read-aloud prefers Moroccan Arabic voices and has a voice and speed picker.
- The mic understands Darija, Standard Arabic, French and English (
- Detect my place (#16): sets the doro region from your nearest city, or switches to your home currency abroad. Matching runs on your device and coordinates are never sent.
Quality
120 tests. API endpoints verified on a Vercel preview before merge.
API docs: README → Public API. Full list in CHANGELOG.md.
v0.5.0 — euro & dollar, coin logo, souk kit
شحال؟ Chhal? v0.5: euro and dollar, a real-money logo, and a souk kit.
Live app: https://darija-money-converter.vercel.app
Highlights
- Euro, dollar & more (#6). Type
100 euro,50€,$20,ألف أوروorميتين دولار. GBP, CAD, CHF, SAR and AED are also available. Two-word names (ريال سعودي,فرنك سويسري) never clash with the Moroccan rial or franc. Rates are daily mid-market values, cached for offline use and clearly labelled as approximate. - Coin logo (#7). A bimetallic brass and nickel piece with a reeded edge, zellige star and a struck "CHHAL · شحال؟ · DIRHAM" inscription. Tap it to flip.
- Souk kit (#8 #9 #10).
- Haggle: counter-offers in Darija ("نعطيك تسعمية ريال") and useful phrases with audio.
- Pay: which notes and coins to hand over.
- Learn: a cheat sheet and a price quiz with streaks.
- Calculator (#11):
3 x 15 dh,500 ريال × 4.
Quality
91 tests, including round trips: every haggle offer and quiz phrase must parse back to its amount.
Rates by ExchangeRate-API. Full list in CHANGELOG.md.
v0.4.0 — Chhal? first release
First working release of شحال؟ Chhal? — Darija Money Converter. All four roadmap milestones are done.
Live app: https://darija-money-converter.vercel.app (installable, works offline)
Highlights
- Type or say it in Darija. "عشرين ألف ريال", "جوج د المليون", "3chrin alf ryal", "75 dh w nss": Arabic script, Arabizi, French and digits all work. (#1)
- Moroccan conventions built in. A bare "مليون" means a million santim (10,000 DH), and "عشرين درهم و خمسين" means 20.50 DH.
- Every unit at once, plus the reverse direction. "Say it like a local" spells the amount the way a seller would, in Arabic and Arabizi, and can read it aloud. (#2)
- Regional presets. General, Oriental, North and custom. Doro values are marked unverified, and each one links to a report form. (#2)
- Voice input through the Web Speech API (
ar-MA). (#3) - PWA and share cards. The app works offline, links are shareable (
?q=), and price cards are 1080×1350 and go through the native share sheet. (#4) - Arabic (RTL), French and English, with light/dark/system themes.
Quality
- 64 tests, including a round trip where every spelled number must parse back to the same value, in both scripts.
- CI runs type-check, tests and build on every PR.
Data note
Core ratios (1 DH = 20 rial = 100 santim) are verified. Doro is not verified for any region. If you know the value in your city, please report it.
See CHANGELOG.md for the full list.
