Dar is built for an agency that sells and lets villas, apartments, townhouses, land and offices. The sample agency works in Muscat (Qurum, Al Mouj, Madinat Sultan Qaboos, Bausher, Seeb, Muscat Hills), Sohar and Salalah, with prices in Omani rials and rents per month. Everything is configurable.
What is inside
| Part | What it does |
|---|---|
| Public website | Search for sale or rent, listing pages with gallery and "picture life here", viewing requests, inquiries, saved homes, comparison of up to 3 homes, agency and contact pages. Arabic (default, right to left) and English. |
| Agency dashboard | Overview, listings with photos and statuses, inquiries pipeline, viewings calendar, AI staging studio, AI assistant, areas, team, roles, settings. Three roles: owner, admin, agent. |
| Backend API | 42 JSON endpoints (31 routes) used by the website and the dashboard, with role checks, validation and rate limits. Usable by a mobile app. |
| Seed data | 8 areas, 24 listings with 3 to 4 photos each, 4 staff members, 15 inquiries and 9 viewings. |
Packages
The documentation sidebar can be filtered by package:
- Full Stack: everything below.
- Public Website: the visitor-facing pages in
src/app/[locale]/(site). - Agency Dashboard:
src/app/[locale]/dashboardandsrc/components/dash. - Backend API:
src/app/apiandsrc/lib.
Technology
Next.js 16 (App Router), React 19, TypeScript, Tailwind CSS 4, next-intl 4 for the two languages, Prisma 6 with SQLite (PostgreSQL with one line changed), zod for validation, jose for the staff session. No third-party maps, trackers or fonts outside Google Fonts.
Folder map
docs/ this documentation (ar + en)
messages/ interface texts: ar.json, en.json
prisma/ schema.prisma, seed.mjs, sample-data.mjs
public/images/ generated sample photos (properties, interiors, areas)
scripts/ e2e_api.py (end-to-end API test), gen_images.py
src/app/[locale]/ pages: (site) public website, dashboard, docs
src/app/api/ the REST API
src/components/ site/ and dash/ components
src/lib/ business rules, database access, AI, SEO
tests/ unit tests for the pure rules (npm test)
Where to start
- Installation: running locally in five minutes.
- Environment variables: every setting.
- Branding: your name, colours, logo and photos.
- Deployment: your own server with HTTPS.