Reef Damascus Website
Fri Aug 01 2025
Next JSShadcn UITurborepoAPITypeScriptTailwindCSSZodnext safe actionNextAuthReact Hot ToastReact Hook Form
π Reef Damascus β Official Website for Rural Damascus Governorate
A modern, accessible, and government-compliant web platform developed for Reef Damascus, the administrative body overseeing rural areas surrounding Damascus under the Ministry of Local Administration and Environment. ποΈπ±
ππ Live Site: https://www.reefdamascus.com
π Project Overview:
I led the full development of this responsive website to improve public access to municipal services and regional information. The platform showcases key areas such as Douma, Yabroud, Zabadani, and Al-Tall, using an interactive Syrian map UI and structured content layout.
A core feature is the citizen complaint submission system π, enabling residents to report local issues (e.g., infrastructure damage, service gaps), with an internal admin dashboard for employees to manage, track, and resolve requests efficiently.
Designed with mobile-first principles π±, the site ensures usability across devices and serves a diverse Arabic-speaking audience with clean navigation and accessibility in mind.
βοΈ Technical Stack & Architecture:
Built with a scalable Turborepo monorepo architecture, this project demonstrates advanced full-stack and frontend engineering practices:
π Monorepo Management:
Used Turborepo to organize shared logic, enforce consistent tooling (ESLint π οΈ, Prettier β¨, TypeScript π€), and enable high-performance development via turbo dev and turbo build. β‘
βοΈ Frontend Framework:
Powered by Next.js 15 with Turbopack (--turbopack) for ultra-fast local development and optimized production builds. π
π§© Shared Codebase:
Created a reusable @workspace/shared package containing:
UI components (Radix UI primitives, custom tables, dialogs) π§±
Utility functions, Zod validation schemas π, React hooks π£
Tailwind CSS configurations and global styles π¨
π¨ Modern UI Toolkit:
Radix UI for accessible, headless components (Dialogs, Dropdowns, Accordions) β
Tailwind CSS + tw-animate-css for utility-first styling and smooth animations π
Lucide React icons πΌοΈ, Sonner for notifications π, Vaul for mobile-friendly drawers π¦
π Form & Validation:
Integrated React Hook Form with Zod resolvers for type-safe, performant forms β used in complaint submissions and admin workflows. βοΈ
π Authentication & Security:
Implemented secure user sessions using Next-Auth v5 (beta) and next-safe-action for safe server actions. π‘οΈ
π» Developer Experience:
Centralized configs via @workspace/eslint-config and @workspace/typescript-config π§°
Automated linting, formatting, and type checking across all workspaces π
Custom generators (e.g., turbo gen react-component) for rapid component scaffolding π¨
πΌ Skills Demonstrated:
This project reflects my expertise in:
π Scalable Monorepo Architecture (Turborepo, PNPM workspaces)
βοΈ Enterprise-Grade Next.js Development (App Router, Server Components, Actions)
π― UI/UX for Public Services (Accessibility, RTL support, responsive design)
π¦ State Management & Form Handling (React Hook Form, Zod, Server Actions)
π§± Component Reusability & Design Systems (Shared libraries, Radix UI)
β‘ Performance & DX Optimization (Turbopack, Fast Refresh, Code Splitting)
π Conclusion:
The Reef Damascus website is more than a digital presence β itβs a step toward transparent, efficient governance through technology π€. By combining modern tooling like Turborepo π§ and Next.js 15 π with real-world civic needs, I demonstrated how clean code πΌ, thoughtful design π¨, and scalable architecture ποΈ can empower public institutions. ποΈ





