Skip to content

ramyatrouny/online-lebanon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

9 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Digital Lebanon ๐Ÿ‡ฑ๐Ÿ‡ง | ู„ุจู†ุงู† ุงู„ุฑู‚ู…ูŠ

โš ๏ธ DISCLAIMER: This is a demo project for learning, testing, and simulation purposes only. This is NOT a real or official government portal. All content, services, and functionality are completely fictional and for educational/demonstration purposes.

A futuristic government services portal that reimagines Lebanon's public sector as a fully digital, user-centric experience. This project showcases how digital transformation could eliminate paperwork, long queues, and inefficiency in Lebanese government services.

๐ŸŽ“ Purpose

This project is designed for:

  • Learning modern web development techniques
  • Testing UI/UX concepts for government portals
  • Demonstrating digital transformation possibilities
  • Educational purposes and portfolio showcasing

This is NOT affiliated with any real Lebanese government entity or official institution.

๐ŸŒŸ Features

๐Ÿ›๏ธ Government Services

  • Civil Registry: National ID renewal, birth certificates, marriage certificates
  • Ministry of Finance: Tax returns, tax clearance certificates
  • Electricitรฉ du Liban (EDL): Electricity bill payments
  • NSSF: Social security registration, medical reimbursements
  • Transportation: Vehicle registration, driving license renewal

๐ŸŽจ Modern UI/UX

  • Clean, intuitive interface designed for Lebanese citizens
  • Responsive design that works on all devices
  • Lebanon flag-inspired color scheme and branding
  • Modern animations and smooth transitions

๐ŸŒ Multilingual Support

  • Full Arabic and English support
  • Right-to-left (RTL) layout for Arabic
  • Culturally appropriate fonts (Tajawal for Arabic, Inter for English)
  • Context-aware language switching

๐Ÿ” Authentication & Security

  • Secure login system with form validation
  • Demo mode for easy testing
  • User profile management
  • Session persistence

๐Ÿ“Š Comprehensive Dashboard

  • Real-time application tracking
  • Progress indicators for multi-step processes
  • Notification system
  • Quick actions for popular services
  • Statistics and analytics

๐Ÿ—๏ธ Modular Architecture

  • Service-based architecture for easy ministry addition
  • Reusable UI components
  • TypeScript for type safety
  • Zustand for state management

๐Ÿ˜… Realistic Pain Points

  • Simulated service outages ("temporarily unavailable")
  • Maintenance mode for certain services
  • Document requirement notifications
  • Processing delays to feel authentic

๐Ÿš€ Quick Start

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation

  1. Clone the repository

    git clone https://github.com/ramyatrouny/online-lebanon.git
    cd online-lebanon
  2. Install dependencies

    npm install
  3. Run the development server

    npm run dev
  4. Open your browser Navigate to http://localhost:3000

๐ŸŽฏ Demo Credentials

For quick testing, you can use:

  • Email: Any valid email address
  • Password: Any password with 6+ characters
  • Quick Demo: Click "Quick Demo Login" for instant access

๐Ÿ“ฑ Screenshots

Homepage

  • Modern landing page with Lebanon flag colors
  • Service overview and ministry listings
  • Multilingual navigation

Dashboard

  • Personalized welcome with Arabic/English names
  • Application tracking with progress bars
  • Quick actions for popular services
  • Recent notifications panel

Services

  • Comprehensive service catalog
  • Status indicators (Online, Maintenance, Limited, Offline)
  • Ministry categorization
  • Fee and processing time information

๐Ÿ›๏ธ Government Entities

The portal simulates these Lebanese institutions:

  1. Ministry of Interior and Municipalities ๐Ÿ›๏ธ

    • Civil Registry services
    • Municipal permits
  2. Ministry of Finance ๐Ÿ’ฐ

    • Tax collection and returns
    • Financial clearances
  3. Electricitรฉ du Liban (EDL) โšก

    • Electricity bill payments
    • Service connections
  4. National Social Security Fund (NSSF) ๐Ÿ›ก๏ธ

    • Health insurance
    • Social benefits
  5. Ministry of Public Works and Transport ๐Ÿš—

    • Vehicle registration
    • Driving licenses

๐Ÿ› ๏ธ Technical Stack

Frontend

  • Next.js 14 - React framework with App Router
  • TypeScript - Type safety
  • Tailwind CSS - Styling and responsive design
  • Heroicons - Icon system
  • React Hot Toast - Notifications

State Management

  • Zustand - Lightweight state management
  • Local Storage - Session persistence

UI/UX

  • Custom components - Reusable UI elements
  • Animation - Smooth transitions
  • Accessibility - WCAG compliant
  • Mobile-first - Responsive design

๐Ÿ“‚ Project Structure

src/
โ”œโ”€โ”€ app/                    # Next.js 13+ App Router
โ”‚   โ”œโ”€โ”€ auth/              # Authentication pages
โ”‚   โ”œโ”€โ”€ dashboard/         # User dashboard
โ”‚   โ”œโ”€โ”€ services/          # Service pages
โ”‚   โ”œโ”€โ”€ globals.css        # Global styles
โ”‚   โ”œโ”€โ”€ layout.tsx         # Root layout
โ”‚   โ””โ”€โ”€ page.tsx           # Homepage
โ”œโ”€โ”€ components/            # Reusable UI components
โ”‚   โ””โ”€โ”€ ui/               # Base UI components
โ”œโ”€โ”€ data/                 # Mock data and APIs
โ”œโ”€โ”€ lib/                  # Utilities and helpers
โ”‚   โ”œโ”€โ”€ store.ts          # Zustand store
โ”‚   โ””โ”€โ”€ utils.ts          # Helper functions
โ””โ”€โ”€ types/                # TypeScript type definitions

๐ŸŽจ Design System

Colors

  • Lebanon Red: #E4002B (Lebanese flag)
  • Lebanon Green: #009A17 (Lebanese flag)
  • Cedar Brown: #8B4513 (Cedar tree reference)
  • Primary Blue: #3b82f6 (Modern accent)

Typography

  • Arabic: Tajawal (Google Fonts)
  • English: Inter (Google Fonts)

๐ŸŒ Internationalization

The application supports:

  • English (LTR layout)
  • Arabic (RTL layout)
  • Automatic direction switching
  • Localized date/time formatting
  • Currency formatting (USD/LBP)

๐Ÿ”ง Environment Setup

Development

npm run dev      # Start development server
npm run build    # Build for production
npm run start    # Start production server
npm run lint     # Run ESLint

Customization

The modular architecture allows easy addition of:

  • New government services
  • Additional ministries
  • Custom workflows
  • Integration with real APIs

๐Ÿค Contributing

This project demonstrates the potential for digital government transformation in Lebanon. Contributions that enhance the realistic simulation are welcome.

โš ๏ธ Important Notice

This is a fictional demonstration project created for learning and testing purposes only:

  • โŒ NOT a real government portal
  • โŒ NOT officially endorsed by any Lebanese institution
  • โŒ NO real government services provided
  • โŒ NO real data collection or processing
  • โœ… Educational and demonstration purposes only
  • โœ… Learning modern web development
  • โœ… Testing UI/UX concepts
  • โœ… Portfolio showcase project

๐Ÿ“„ License

This project is for demonstration, learning, and testing purposes only, showcasing modern web development techniques applied to government service digitalization simulation.

๐Ÿ™ Acknowledgments

  • Lebanese citizens who deserve better digital services
  • The vision of a more efficient, transparent government
  • Modern web development practices and tooling

Digital Lebanon - Towards a better digital future for government services in Lebanon ู„ุจู†ุงู† ุงู„ุฑู‚ู…ูŠ - ู†ุญูˆ ู…ุณุชู‚ุจู„ ุฑู‚ู…ูŠ ุฃูุถู„ ู„ู„ุฎุฏู…ุงุช ุงู„ุญูƒูˆู…ูŠุฉ ููŠ ู„ุจู†ุงู†

About

๐Ÿ‡ฑ๐Ÿ‡ง Lebanese government services simulation - Demo project for learning modern web development (NOT real/official)

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages