Requirements

What you need to run and to work on Nuzul.

Minimum Notes
Node.js 22.18 the unit tests and the seed run TypeScript directly with Node's type stripping; Node 24 is recommended
npm 10 comes with Node.js
Database SQLite (built in) a file, nothing to install. PostgreSQL 14+ for bigger setups (how)
Memory 1 GB RAM npm run build uses the most
Disk 700 MB including node_modules and the sample photos
Python 3 optional only for scripts/e2e_api.py and scripts/gen_images.py

Built with

Package Version Used for
Next.js 16 pages, API routes, the proxy that guards the dashboard
React 19 interface
next-intl 4 Arabic and English, right-to-left layout
Tailwind CSS 4 styling, brand tokens in src/app/globals.css
Prisma 6 database access and schema
jose 6 signed dashboard session cookie
zod 4 checking every request body
marked 15 this documentation
lucide-react 1 icons

Optional services

Service For Without it
Thawani Pay account card payments in Omani rials guests send requests to book and pay on arrival
An OpenAI-compatible API (OpenAI, OpenRouter, a local Ollama, ...) AI assistant and "Write with AI" for stays the dashboard explains how to turn it on

Browsers

The website and the dashboard work in current Chrome, Edge, Safari and Firefox, on phones and desktops. Saved stays use the browser's local storage; without it the heart button still works for the current page.