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.