غير أي موية

اضغط أو مرّر للتخطي

تخطَّ إلى المحتوى
توصيل مجاني لكل الطلبات

v0.1 • beta

نظام تصميم أكويا

مصدر واحد للرموز لموقع Next.js وتطبيقات React Native. خصائص منطقية لدعم RTL، ومساحات لمس ٤٤ بكسل، وحركة هادفة، وتحليلات مدمجة في المكوّنات.

Principles

Clarity, like the water

Generous whitespace, one primary action per view, prices and delivery time always visible. Nothing between the customer and the order.

Cinematic, never in the way

Depth (abyss surfaces, light shafts, the geodesic mark) sells purity on discovery pages. In flows — cart, checkout — motion only confirms actions.

Arabic-first, truly bilingual

Logical properties everywhere (ms/me/ps/pe/start/end). Directional icons mirror automatically. Numerals follow the locale; inputs for phones/OTP stay LTR.

Thumb-first

44 px minimum targets, bottom tab bar, bottom sheets on phones, sticky buy bar. Keyboard-aware: the tab bar hides when the keyboard opens.

Trust built in

Certifications, pH/TDS, delivery codes, ZATCA invoices and secure-payment cues are components — not afterthoughts.

One source, two platforms

Every token is defined once in tokens.json and generated into CSS variables (web) and a typed TS object (React Native).

Customer journey coverage

Proposal FN-AKW-2026-001 • End-to-End Customer Journey. Every stage maps to screens in this beta and to the analytics events those screens send (event param journey_stage).

1 • Discover & shop

Home hero (slides) • offers • best sellers • order builder (one-time / subscription / mosque) • shop search • favourites • cart

view_item_list • select_item • view_promotion • select_promotion • add_to_cart • view_cart • search • order_mode_select • subscription_configure • min_order_reached

2 • Sign in & onboard

Checkout §1 OTP sign-in → account type → profile → B2B VAT/CR • §2 address → in delivery area? → notify when available

login • sign_up • coverage_check • notify_me

3 • Checkout

Checkout §3 delivery slot (real shifts) • §4 payment • coupon / redeem points • §5 review (VAT-inclusive total)

begin_checkout • add_shipping_info • delivery_slot_select • add_payment_info

4 • Pay & confirm

Place order → processing → result? declined → retry / change method • confirmed → push / SMS / WhatsApp

purchase • payment_failed

5 • Delivery

Track: confirm or postpone (14-day picker) • driver dispatched • live GPS • OTP code at door • cash or card on delivery • delivered

postpone_delivery

6 • Engage & retain

Rate delivery → points • loyalty tiers & rewards • helpdesk tickets with SLA • reorder & win-back nudges

rate_delivery • reorder_click

7 • Invoicing

ZATCA e-invoice with QR on delivered orders (ERP export is server-side)

—

Color

Brand #0075BC is the exact blue of the Akoya logo (geodesic mark and WATER): the sphere, focus rings and brand accents use it; brand.300 is its step for dark surfaces. Action blue #0051BE comes from the buttons on the current site and stays the primary (7.2:1 on white). Gold marks rewards and decisions, as in the customer-journey map.

blue

50

100

200

300

400

500

600

700

800

900

950

brand

100

200

300

500

700

aqua

100

200

300

400

500

600

700

abyss

900

950

pearl

0

50

100

200

300

400

500

600

700

800

900

gold

100

300

500

700

success

100

500

700

warning

100

500

700

800

danger

100

500

700

Semantic • light

bg

surface

surface-2

ink

ink-muted

ink-subtle

line

line-strong

primary

primary-hover

on-primary

accent

reward

reward-soft

focus

brand

status-info

status-info-soft

status-warning

status-warning-soft

status-aqua

status-aqua-soft

status-success

status-success-soft

status-danger

status-danger-soft

status-neutral

status-neutral-soft

Semantic • abyss

bg

surface

surface-2

ink

ink-muted

ink-subtle

line

line-strong

primary

primary-hover

on-primary

accent

reward

reward-soft

focus

brand

status-info

status-info-soft

status-warning

status-warning-soft

status-aqua

status-aqua-soft

status-success

status-success-soft

status-danger

status-danger-soft

status-neutral

status-neutral-soft

Typography

The eight Clear Depth styles (tokens v2): one class sets size, line height and weight, e.g. text-title-1. Never below 12 px; text under 18 px uses ink-muted. Arabic gets about 10 % more line height. Typefaces move to Plus Jakarta Sans in step 1.3.

display-xl · 64/1.02/700Pure water
display · 44/1.08/700Pure water
title-1 · 28/1.15/700Pure water
title-2 · 22/1.25/700Pure water
title-3 · 18/1.35/650Pure water
body · 16/1.5/400Pure water
body-sm · 14/1.5/400Pure water
caption · 12/1.4/500Pure water

نقاءٌ تتذوّقه.

يصلك غدًا.

مستخرجة من آبار عميقة في منطقة مكة المكرمة، مُنقّاة عبر أكثر من ٥ مراحل.

Arabic preview renders in the active locale's body face; switch to /ar to see Noto Kufi.

Space, radius & elevation

Space (8-pt rhythm; 4 and 12 inside components)

4
8
12
16
24
32
48
64

Radius

xs

sm

md

lg

xl

2xl

pill

Elevation

sm
md
lg
glow

Motion

Three curves. Tide for entrances & layout, ripple for loops, drop for playful confirmations. Everything collapses under prefers-reduced-motion.

tide
ripple
drop

Components

Button • 7 variants • sm 36 · md 44 · lg 52 • loading keeps the label

English

Variants

Sizes

States

العربية

الأنواع

الأحجام

الحالات

Badge • Chip • IconButton

PrimaryBestsellerDeliveredFew leftDeclined

Sheet • focus moves in, Tab stays inside, page behind inert, Esc closes, focus returns

Segmented (one tab stop, arrow keys) • QtyStepper (announces the new number) • Rating

Field • 48 high, floating label always visible, error linked • PhoneField +966, always LTR

English

Default: tab in to see focus

+966

5X XXX XXXX

That code isn't valid

Read-only

A CR number has 10 digits. You've entered 8.

DigitsField: Arabic digits become 0–9; letters are dropped

العربية

افتراضي: انتقل إليه لرؤية التركيز

+966

5X XXX XXXX

هذا الرمز غير صالح

للقراءة فقط

رقم السجل التجاري ١٠ أرقام، وأدخلت ٨.

حقل أرقام: تتحول الأرقام العربية إلى 0–9 وتُحذف الحروف

StatusChip • 26 high, icon + word • order and delivery vocabulary (icons proposed until 1.6)

English

Order confirmedOn hold — awaiting verificationAwaiting approvalPreparingDriver dispatchedOn the wayAt your doorDeliveredPartially deliveredPostponedNot deliveredCancelled
Order confirmedAwaiting approvalDriver dispatchedAt your doorDeliveredPartially deliveredPostponedNot deliveredCancelled

العربية

تم تأكيد الطلبمعلّق — بانتظار التحققبانتظار الموافقةقيد التجهيزانطلق السائقفي الطريقعند بابكتم التوصيلتم التوصيل جزئيًامؤجَّللم يتم التوصيلملغى
تم تأكيد الطلببانتظار الموافقةانطلق السائقعند بابكتم التوصيلتم التوصيل جزئيًامؤجَّللم يتم التوصيلملغى

Banner • info · success · warning · danger • actions, optional dismiss

English

We're checking your documents

You can keep ordering. Deliveries wait until verification is complete.

We couldn't verify your documents

The CR copy is not readable.

Verified business

You'll receive a tax invoice for Al Maa Est.
You're offline · showing saved data from 10:42

العربية

نراجع مستنداتك

يمكنك متابعة الطلب، وسيتم التوصيل بعد اكتمال التحقق.

تعذّر التحقق من مستنداتك

صورة السجل التجاري غير واضحة.

منشأة موثّقة

ستصلك فاتورة ضريبية باسم مؤسسة الماء.
أنت غير متصل · تُعرض بيانات محفوظة من ١٠:٤٢

Timeline • done · problem · current · upcoming • actor and time

English

  1. Done: Order confirmed

    · You

  2. Done: Preparing

    · Akoya

  3. Problem: Not delivered

    · Driver Ahmed

    No one at the door. We'll call you to choose a new time.
  4. Now: Postponed to tomorrow

  5. Next: Delivered

العربية

  1. تم: تم تأكيد الطلب

    · أنت

  2. تم: قيد التجهيز

    · Akoya

  3. مشكلة: لم يتم التوصيل

    · السائق أحمد

    لم يكن أحد عند الباب. سنتصل بك لاختيار وقت جديد.
  4. الآن: مؤجَّل إلى الغد

  5. التالي: تم التوصيل

Toast • 4 tones, Undo closes it, timer pauses on hover and focus

OTP • 46 × 56, 50 × 64 from sm • paste fills every box • always LTR • error

That code doesn't match. Check the SMS and try again.

Steps • numbered progress

AccordionStep • done steps collapse to one line with Change • upcoming not open yet

English

The step's form goes here.

العربية

هنا نموذج الخطوة.

EmptyState • icon, one sentence, one action • page and compact

English

No orders yet

Your orders will show here once you place one.

No matching invoices

Try another date range or clear the filters.

العربية

لا توجد طلبات بعد

ستظهر طلباتك هنا بعد أول طلب.

لا توجد فواتير مطابقة

جرّب فترة أخرى أو امسح عوامل التصفية.

Skeleton • in the shape of the content, one announcement for screen readers

Loading orders

Pagination • numbers when there is room (container query), 'Page n of N' when narrow • links or buttons • arrows mirror

English

العربية

Upload • drag and drop or choose (desktop) · camera or files (phone) • type and size check • progress, retry, replace, remove

Shows the failed state; turn it off and press Retry.

English

VAT certificate

PDF, JPG or PNG · up to 5 MB

National address certificate

PDF, JPG or PNG · up to 5 MB

national-address-2025.pdf

793 KBUploaded

This certificate has expired. Upload the current one.

national-address-2025.pdf: Uploaded

العربية

شهادة ضريبة القيمة المضافة

PDF أو JPG أو PNG · حتى ٥ ميغابايت

شهادة العنوان الوطني

PDF أو JPG أو PNG · حتى ٥ ميغابايت

national-address-2025.pdf

793 KBتم الرفع

انتهت صلاحية هذه الشهادة. ارفع الشهادة الحالية.

national-address-2025.pdf: تم الرفع

Checkbox • Radio • Switch • native inputs, 44 px rows, error and disabled

English

Payment method
Bottle size

Choose a size.

Driver on the way and delivery code
You need 500 points

العربية

طريقة الدفع
حجم العبوة

اختر الحجم.

السائق في الطريق ورمز التوصيل
تحتاج إلى ٥٠٠ نقطة

Tabs • one tab stop, arrow keys follow the reading direction, Home / End • scrolls on phones

English

Your three latest orders.

العربية

آخر ثلاثة طلبات.

ProductTile • + becomes stepper, fly-to-cart, select_item / add_to_cart

أكويا ٣٣٠ مل
×٤٠
الأكثر مبيعًا
4.9

أكويا ٣٣٠ مل

كرتون • ٤٠ عبوة

١٩ ر.س

٠٫٤٨ ر.س للعبوة

OfferCard • size/quantity picker, paid + free = total, countdown, view/select_promotion

وفّر ١٧٪

أكويا ٣٣٠ مل

اشترِ ١٠ واحصل على ٢ مجانًا

كلما زادت الكمية زادت الكراتين المجانية.

كم كرتونًا تريد؟

١٠

تدفع ثمنها

٢

مجانًا

١٢

كرتون

١٩٠ر.س٢٢٨

توفّر ٣٨ ر.س • ١٥٫٨٣ ر.س للكرتون

Countdown • offers.end_at

--ي--س--د--ث--ي--س--د--ث

GeoSphere • the signature mark, live

Hero slides

Hero slides stay fully managed from the Akoya dashboard. V2 keeps every existing sliders column and adds six: background type and value, water effect, a phone banner, banner fit and a start / end schedule. Developer reference: docs/slides.md.

Background types

Akoya.

preset "navy"

Brand gradient + water

Akoya.

color "#0b5a3e"

Mixed into abyss for depth

Akoya.

color "#e7f1fc"

Light → auto-dimmed for text

Akoya.

image (focal 65% 50%)

Scrim on the text side

Akoya.

video (muted loop)

≤ 8 s, ≤ 4 MB, no audio

navyAkoya navy
offerOffer blue
greenSaudi green
sandDesert sand
ramadanRamadan night

Finished banners (artwork mode)

Desktop 1920×800 (12:5) • Akoya's live banner on its matching background colour.
Phone without a mobile banner: whole banner, never cropped

Phone banner 1080×1350 (4:5)
Safe zone: Keep text and logos inside the central 70% width and 80% height.

Same safe zone applies to the desktop banner

Rendering rules

Two slide types

Designed slides get type, buttons and the countdown from the site, so they are bilingual and accessible. Finished banners are shown exactly as uploaded — never with text on top.

Mobile artwork is optional

With slide_image_mobile, phones get the 4:5 banner. Without it, phones show the whole desktop banner (contain) — baked-in text is never cropped.

Letterbox is the background

Space around a contained banner shows the slide background as chosen (no blur, no dimming). Pick a colour that matches the banner edge; transparent PNGs sit directly on it.

Readability is automatic

Photo and video backgrounds get a directional scrim (start side, bottom on phones). Light custom colours are dimmed in designed slides so white type keeps AA contrast.

Scheduling

starts_at / ends_at are checked on the client clock every minute. Before hydration, scheduled slides stay hidden so nothing flashes.

Countdown only for offers

A countdown is shown only when both offer_id and ends_at are set — a schedule alone never invents urgency.

Dashboard field map

Existing sliders columns keep their meaning. Rows marked new are the columns V2 adds.

sliders columnSlide field (content.ts)Behaviour
id • slide_name • status • o id • slideName • status • orderOrder ascending. status = 0 hides the slide everywhere.
show_text_content mode1 → "text" (site draws the copy) • 0 → "artwork" (finished banner, nothing drawn on top).
show_cta_buttons showCtaHides both buttons. In artwork mode the whole slide stays clickable when cta is set.
title (+ highlighted-text span) • subtitle/desc title • highlight • subtitle • eyebrowBilingual { en, ar }. Text mode only.
cta_text/cta_link • cta_text2/cta_link2 cta • cta2Internal links resolve per locale (/ar, /en).
offer_id offerIdEnables one-tap add-offer and, with endsAt, the live countdown.
media slide_image media (text) • artwork.desktop (artwork)media.fit: product = cut-out over the geodesic mark, cover = photo card.
background_type + background_value newbackgroundpreset | color | image | video (see below).
water_effect newwaterAnimated light rays + bubbles over the background.
media slide_image_mobile newartwork.mobileOptional 4:5 phone banner.
artwork_fit newartwork.fitcontain (default, never crops) | cover (fills, crops edges).
starts_at • ends_at newstartsAt • endsAtISO date-time, Riyadh (+03:00). Slide appears / disappears automatically.

Sample slides in this beta

    Try it

    The slide studio is the dashboard form in miniature: every field above, live preview, uploads for photos, video and banners. A slide you add is shown first in the home hero, in your browser only.

    // Slide (src/domain/content.ts) as mapped from a sliders row — a finished banner with a phone version, scheduled for National Day
    {
      id: 52, slideName: "National Day 95", status: true, order: 1,
      mode: "artwork", showCta: false,
      background: { type: "color", color: "#0b5a3e" },   // matches the banner edge
      water: false,
      cta: { label: { en: "Get the offer", ar: "احصل على العرض" }, href: "/offers" },  // whole slide is the link
      artwork: { desktop: "/storage/…/nd95-1920x800.jpg", mobile: "/storage/…/nd95-1080x1350.jpg", fit: "contain",
                 alt: { en: "National Day: SAR 95 off", ar: "اليوم الوطني: خصم ٩٥ ريال" } },
      startsAt: "2026-09-20T00:00:00+03:00", endsAt: "2026-09-25T00:00:00+03:00",
    }

    RTL with logical properties

    Same markup, one stylesheet. The card below is rendered twice with only the dir attribute changed.

    dir="ltr"

    Arrives tomorrow

    dir="rtl"

    تصلك غدًا
    /* ✗ dual stylesheets */  .card { padding-left: 16px }  [dir=rtl] .card { padding-right: 16px }
    /* ✓ logical props    */  .card { padding-inline-start: 16px }   →  Tailwind: ps-4 • ms-auto • start-0 • text-start

    One system, two platforms

    packages/tokens: tokens.json → build.mjs → tokens.css (web) + index.ts (React Native).

    ComponentNext.js (web)React Native (Expo)Shared
    Button<button> + ripple, Tailwind tokensPressable + Reanimated ripple7 variants, 36 · 44 · 52, loading keeps the label
    SheetDialog, side panel ≥640 px / bottom sheet@gorhom/bottom-sheetspring 380/40, focus trap
    Segmentedradiogroup + layoutId pillPressable row + ReanimatedAPI: value/onChange/options
    OtpInput6 inputs, one-time-code autofill, paste fills allTextInput, textContentType=oneTimeCodelength, onComplete, error; 46 × 56 / 50 × 64
    GeoSphereCanvas 2Dreact-native-skiageometry + rotation math
    PriceIntl ar-SA / en-SAIntl (Hermes)format.ts
    // React Native
    import { tokens, color } from "@akoya/tokens";
    const styles = StyleSheet.create({
      cta: { backgroundColor: color("light", "primary"), borderRadius: tokens.radius.pill, minHeight: tokens.layout.tapTarget },
    });

    Viewing in AR. The showcase body is pinned LTR for legibility; the storefront is fully RTL in /ar.