An open API service indexing awesome lists of open source software.

https://github.com/mazenessam99/zoom-task

A modern Next.js 15 app featuring authentication, role-based routing, internationalization (i18n), and a responsive Figma-based landing page with clean architecture and scalable structure
https://github.com/mazenessam99/zoom-task

animation cookies jwt nextjs react-hook-form react-hot-toast redux-toolkit responsive-design tailwindcss tanstack-query typescript zod-validation

Last synced: 8 days ago
JSON representation

A modern Next.js 15 app featuring authentication, role-based routing, internationalization (i18n), and a responsive Figma-based landing page with clean architecture and scalable structure

Awesome Lists containing this project

README

          

# πŸš€ Zoom Cleaning Task

A production-ready **Next.js 15 application** showcasing authentication, role-based routing, internationalization, and a fully responsive landing page built from a Figma design.

This project demonstrates clean architecture, scalable structure, and modern frontend best practices.

---

## 🌐 Live Demo

- πŸ”— Live URL: (https://zoom-task.vercel.app/en/admin)
- πŸ”— GitHub Repository: https://github.com/mazenessam99/zoom-task

---

## πŸ“Œ Overview

This application was built as a **Frontend Technical Assessment** with a strong focus on:

- Scalable architecture
- Clean and maintainable code
- Role-based access control
- Pixel-perfect UI implementation
- Responsive design across all devices
- Internationalization (i18n)

---

## ✨ Key Features

### πŸ” Authentication System
- Secure login functionality
- JWT-based authentication
- Persistent user session
- Form validation using Zod
- Loading & error states handling
- Logout functionality

---

### 🧭 Role-Based Routing

The system supports two user roles:

#### πŸ‘‘ SUPER_ADMIN
Redirected to:

Dashboard includes:
- Full Name
- Email Address
- Phone Number
- User Type

---

#### πŸ“’ MARKETER
Redirected to:

Access to a fully responsive landing page.

---

## 🌍 Internationalization (i18n)

Built using `next-intl`

Supported languages:
- πŸ‡ΊπŸ‡Έ English
- πŸ‡ͺπŸ‡¬ Arabic

Features:
- RTL / LTR support
- Dynamic language switching
- Fully localized UI content

---

## 🎨 Landing Page (Figma Implementation)

A pixel-perfect implementation based on the provided Figma design.

### Sections:
- Hero Section
- Services / Features Section
- Statistics Section

### Highlights:
- Fully responsive layout
- Reusable UI components
- Clean spacing & typography
- Modern design system approach

---

## πŸ”’ Route Protection & Middleware

- Protected routes using authentication guards
- Role-based access control
- Middleware-level protection
- Automatic redirection for unauthorized users

---

## πŸ“ Project Architecture

A clean and scalable folder structure:
src/
app/
[locale]/
admin/
login/

components/
ui/
shared/
admin/
landing/

hooks/
useRedux/

lib/
schemas/
helpers/

i18n/
messages/
ar.json
en.json
request.ts
routing.ts

store/

middleware/

types/

---

## πŸ§ͺ Form Handling & Validation

- React Hook Form for form state management
- Zod for schema validation
- Strong TypeScript integration

---

## πŸ”” Notifications

- React Hot Toast for user feedback
- Success / error handling UX improvements

---

## 🧠 State Management

- Redux Toolkit for global state
- RTK Query for API handling (if applicable)
- Centralized and scalable store structure

---

## 🎯 Technical Highlights

- ⚑ Next.js 15 App Router
- 🟦 TypeScript for type safety
- 🎨 Tailwind CSS for styling
- 🧩 Reusable components architecture
- πŸ” Secure authentication flow
- 🌍 Multi-language support
- πŸ“± Fully responsive UI
- 🧼 Clean code principles
- πŸ—οΈ Scalable folder structure

---

### πŸ”‘ Login Page
![Login](public/readme/login.png)

---

### 🏠 Landing Page
![Landing](public/readme/landing.png)

---

### πŸ“Š Admin Dashboard
![Admin](public/readme/admin.png)

---

## πŸ›  Tech Stack

### Frontend
- Next.js 15
- React 19
- TypeScript

### Styling
- Tailwind CSS
- Lucide Icons

### State Management
- Redux Toolkit
- RTK Query

### Forms & Validation
- React Hook Form
- Zod

### Internationalization
- next-intl

### Notifications
- React Hot Toast

### Authentication
- JWT
- Middleware Protection
- Role-Based Access Control

### Tools
- ESLint
- Prettier
- Git & GitHub

### Deployment
- Vercel

---

## πŸ‘¨β€πŸ’» Author

**Mazen Essam**

- GitHub: https://github.com/mazenessam99
- LinkedIn: www.linkedin.com/in/mazen-essam-8b5448224

---

## ⭐ Project Goals

This project was built to demonstrate:

- Real-world frontend architecture
- Scalable Next.js structure
- Clean and maintainable code
- Professional UI implementation
- Best practices in React ecosystem