Sufra documentation

Run the Sufra restaurant template, set it up for your restaurant, and find a fix when something goes wrong.

Sufra is a complete online ordering system for a restaurant, in Arabic and English. One Next.js project contains three parts that share one database:

Part What it does Where
Ordering website Menu with search, dish options, cart, checkout for pickup, delivery or dine-in, live order tracking, table reservations /ar, /en
Staff dashboard Live kitchen board with a sound alert, menu and photo management, reservations, opening hours, prices, staff accounts /ar/dashboard, /en/dashboard
Backend API REST endpoints used by both, and by your own apps if you build any /api/...

What you get

  • Arabic first (right to left) with a full English version, switchable on every page.
  • Prices always computed on the server, from the menu in the database, in the currency's smallest unit (baisa for Omani rials).
  • Cash payments out of the box, card payments through Thawani Pay when you add your keys.
  • Opening hours with closing times after midnight, and a "pause online orders" switch for busy nights.
  • Owner and staff roles: staff run orders, reservations and sold-out dishes; only the owner changes prices, the menu, settings and accounts.
  • Optional AI that writes dish descriptions in both languages, with any OpenAI-compatible provider.
  • A sample Omani restaurant (6 categories, 22 dishes with photos and options) so the site looks complete from the first minute.

Quick start

npm install
cp .env.example .env
npm run setup
npm run dev

Open http://localhost:3301 for the website and http://localhost:3301/en/dashboard for the dashboard. The first owner account comes from OWNER_EMAIL and OWNER_PASSWORD in .env (see Installation).

Where things are

prisma/schema.prisma     database tables
prisma/seed.mjs          sample restaurant and the first owner account
messages/ar.json, en.json  every text on the site and the dashboard
src/app/[locale]/(site)  ordering website pages
src/app/[locale]/dashboard  staff dashboard pages
src/app/api              the API
src/lib                  pricing, order rules, payments, AI, sessions
src/components           shop and dashboard components
src/app/globals.css      colours, fonts and radius (your brand)
public/images/menu       dish photos
tests                    unit tests (npm test)

Next steps

  1. Install and sign in to the dashboard.
  2. Put in your restaurant's name, address, hours and prices in Dashboard > Settings.
  3. Replace the sample menu in Dashboard > Menu.
  4. Set your colours and logo (Branding).
  5. Decide on card payments (Payments) and deploy (Manual setup and deployment).