Nuzul is a complete booking system for a company that rents out holiday homes: chalets, villas, cabins, beach houses and desert camps. It speaks Arabic (right to left) and English. One Next.js project holds three parts that share one database:
| Part | What it does | Where |
|---|---|---|
| Stays website | Search by destination, dates and guests; stays list with filters; stay page with gallery, calendar of free nights and a price for the exact dates; booking with card payment or a request to book; booking code, "Find your booking", door code, cancel requests, reviews; destinations, saved stays, about, contact | /ar, /en |
| Booking dashboard | Overview (revenue, occupancy, arrivals, departures), calendar of every stay and night with blocked dates, bookings and their status flow, stays with photos, rates and seasons, inquiries, reviews, AI assistant, company settings, admins and roles | /ar/dashboard, /en/dashboard |
| Backend API | REST endpoints used by both, and by your own apps | /api/... |
What you get
- Real availability: one database row per taken night, so the same night can never be sold twice, even when two guests press "Book" at the same second.
- Prices worked out on the server for every night: base rate, Thursday and Friday rate, and seasonal prices, plus cleaning fee and tax. The browser never decides a price.
- Two ways to pay: by card through Thawani Pay, verified with Thawani on the server, or a request to book that the host confirms and the guest pays on arrival.
- "From booking to door code": the guest gets a booking code at once, and the door code appears in their booking the day before arrival.
- Three dashboard roles: owner, admin and host. Hosts see only the stays assigned to them.
- Optional AI that answers questions about bookings and writes stay descriptions in Arabic and English, with any OpenAI-compatible provider.
- A sample company: 6 destinations and 14 stays across Oman with generated photos, about 450 bookings from five months ago to two months ahead, reviews and inquiries.
Quick start
npm install
cp .env.example .env
npm run setup
npm run dev
Open http://localhost:3304 for the website and http://localhost:3304/en/dashboard for the dashboard. The 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 company, bookings and the owner account (content in seed-data.mjs)
messages/ar.json, en.json every text on the website and the dashboard
src/app/[locale]/(site) website pages
src/app/[locale]/dashboard dashboard pages
src/app/api the API
src/lib/booking-rules.ts nights, availability, prices, status flow (pure, unit-tested)
src/lib/roles.ts what each dashboard role may do
src/lib bookings, stays, payments, AI, sessions
src/components website and dashboard components
src/app/globals.css colours, fonts and radius (your brand)
public/images stay and destination photos
tests unit tests (npm test)
scripts/e2e_api.py end-to-end API test
Next steps
- Install and sign in to the dashboard.
- Enter your company's name, contact details, tax and booking rules in Dashboard > Company settings.
- Replace the sample destinations and stays in Dashboard > Stays.
- Set your colours and logo (Branding).
- Decide how guests pay (Payments) and deploy (Manual setup and deployment).