Colours
All colours are tokens at the top of src/app/globals.css. Every component uses them, so changing one value restyles the store, the dashboard and the docs.
| Token | Default | Used for |
|---|---|---|
--color-paper |
#f1f3ef |
Page background, a cool gypsum white |
--color-surface |
#ffffff |
Cards and inputs |
--color-ink |
#14211d |
Text, primary buttons, the footer and the dashboard sidebar |
--color-palm |
#1f5a4d |
Brand green: links, active states, focus rings |
--color-saffron |
#e3a33a |
The one warm accent: badges, the bag counter, highlights (never body text) |
--color-clay |
#a8392a |
Sale prices, sale links and errors |
--color-muted |
#56635e |
Secondary text |
--color-line, --color-mist |
Borders and quiet surfaces | |
--color-chart-1, --color-chart-2 |
#00876c, #b97a12 |
The two chart series on the overview, checked for colour-blind separation |
If you change the chart colours, keep them clearly different in lightness as well as hue, and keep at least 3:1 contrast against white.
Fonts
Fonts are loaded in src/app/[locale]/layout.tsx with next/font (served from your own domain, no external requests):
- Readex Pro for body text, in Arabic and Latin.
- Reem Kufi for Arabic headings and Bricolage Grotesque for Latin headings. The
--font-displaytoken lists both: Latin letters take the first font, Arabic letters fall through to Reem Kufi.
To change a font, import another one from next/font/google, give it a CSS variable, and point --font-sans or --font-display at it in globals.css.
Logo
The mark is an arched doorway drawn in src/components/store/Logo.tsx (LogoMark). Replace the SVG with your own, or render an <img>. The browser tab icon is public/icon.svg. The store name next to the logo comes from Settings, in each language.
The arch
Souq's signature shape is the Omani doorway arch, used on product photos, category tiles and the hero. It is two CSS classes in globals.css:
.archfor tall images (round top, small bottom corners),.arch-softfor small thumbnails.
For square cards everywhere, change both classes to border-radius: var(--radius-card).
Home page
src/app/[locale]/(store)/page.tsx builds the home page from your data:
- Hero:
public/images/site/hero.webpand the textshome.title,home.bodyinmessages/*.json. Two featured products appear under the buttons. - Curated edits: collections that have products (first four).
- New in: the four newest products in stock.
- Shop by department: all active categories with their cover image.
- On sale: products with a "was" price, biggest saving first.
- Best sellers: by units sold in orders that were not cancelled.
- Our makers:
public/images/site/about.webpand thehome.story*texts.
Remove a section by deleting its block; reorder by moving blocks.
Photos
The sample photos in public/images were generated for this template with our own image service; their prompts are in assets/image-prompts.json, and you may use them in your store (see the licence). For a real store, upload your own photos from Dashboard > Products: product photos look best at 3:4 (portrait) and at least 900 × 1200 pixels.
Texts
Every label, button and page text is in messages/ar.json and messages/en.json. The about, FAQ, privacy and terms pages are there too (under pages): edit them like any other text. The privacy and terms texts are samples; have them checked for your business.