Skip to content

A modern, responsive web application for global ocean logistics and shipping solutions. Navigate global trade with trusted ocean logistics, professional shipping services, real-time tracking, and reliable worldwide delivery solutions.

License

Notifications You must be signed in to change notification settings

mohamed-samir-dev/uthao

Repository files navigation

Uthao - Global Ocean Logistics & Shipping Solutions

Next.js React TypeScript Tailwind CSS Vercel

A modern, responsive web application for global ocean logistics and shipping solutions. Navigate global trade with trusted ocean logistics, professional shipping services, real-time tracking,and reliable worldwide delivery solutions.

🌐 Live Demo

Production: https://uthao-7o3c.vercel.app/

πŸ“Έ Screenshots

✨ Key Features

🚒 Core Services

  • Ocean Contract Logistics - Comprehensive freight forwarding services
  • Real-time Shipment Tracking - Monitor cargo worldwide with live updates
  • Global Port Coverage - Extensive network across major shipping routes
  • Supply Chain Management - End-to-end logistics optimization
  • Container Shipping - Full and LCL container services

πŸ’» Technical Features

  • Responsive Design - Optimized for desktop, tablet, and mobile
  • Fast Performance - Built with Next.js 15 and Turbopack for optimal speed
  • SEO Optimized - Complete meta tags, structured data, and sitemap
  • Secure Authentication - Local authentication with email/password
  • Modern Animations - Smooth Framer Motion transitions
  • Progressive Web App - PWA capabilities with offline support

🎨 User Experience

  • Interactive Forms - Multi-step shipping quote calculator
  • Partner Showcase - Trusted global logistics partners
  • Success Stories - Client testimonials and case studies
  • FAQ Section - Comprehensive help and support
  • Contact Integration - Multiple communication channels

πŸ› οΈ Tech Stack

Frontend Framework

  • Next.js 15.5.4 - React framework with App Router
  • React 19.1.0 - Latest React with concurrent features
  • TypeScript 5.x - Type-safe development

Styling & UI

  • Tailwind CSS 4.x - Utility-first CSS framework
  • Framer Motion 12.x - Production-ready motion library
  • Lucide React - Beautiful & consistent icons
  • Custom Fonts - Geist Sans, Geist Mono, Playfair Display

Authentication & Security

  • Local Authentication - Email/password based authentication
  • Security Headers - XSS protection, content security

Development Tools

  • Turbopack - Ultra-fast bundler for development
  • ESLint 9 - Code linting and formatting
  • Jest - Unit testing framework
  • PostCSS - CSS processing and optimization

πŸš€ Getting Started

Prerequisites

Ensure you have the following installed:

  • Node.js 18+ (LTS recommended)
  • npm, yarn, pnpm, or bun
  • Git for version control

Installation

  1. Clone the repository
git clone https://github.com/mohamed-samir-dev/uthao.git
cd uthao
  1. Install dependencies
npm install
# or
yarn install
# or
pnpm install
# or
bun install
  1. Start development server
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev
  1. Open your browser Navigate to http://localhost:3000

πŸ“ Project Architecture

src/
β”‚   β”œβ”€β”€ login/             # Authentication pages
β”‚   β”œβ”€β”€ page/              # Additional pages
β”‚   β”‚   β”œβ”€β”€ services/      # Services showcase
β”‚   β”‚   β”œβ”€β”€ career/        # Career opportunities
β”‚   β”‚   β”œβ”€β”€ Steps/         # Process workflow
β”‚   β”‚   └── Stories/       # Success stories
β”‚   β”œβ”€β”€ globals.css        # Global styles
β”‚   β”œβ”€β”€ layout.tsx         # Root layout
β”‚   β”œβ”€β”€ page.tsx           # Homepage
β”‚   β”œβ”€β”€ robots.ts          # SEO robots.txt
β”‚   └── sitemap.ts         # XML sitemap
β”œβ”€β”€ components/            # Reusable components
β”‚   β”œβ”€β”€ Benefits/          # Benefits showcase
β”‚   β”œβ”€β”€ FAQ/               # Frequently asked questions
β”‚   β”œβ”€β”€ Footer/            # Footer components
β”‚   β”œβ”€β”€ forms/             # Form components
β”‚   β”œβ”€β”€ layout/            # Layout components
β”‚   β”œβ”€β”€ partners/          # Partner logos
β”‚   β”œβ”€β”€ providers/         # Context providers
β”‚   β”œβ”€β”€ seo/               # SEO components
β”‚   β”œβ”€β”€ services/          # Service sections
β”‚   β”œβ”€β”€ Steps/             # Process steps
β”‚   β”œβ”€β”€ Stories/           # Testimonials
β”‚   └── ui/                # UI components
β”œβ”€β”€ constants/             # Application constants
β”œβ”€β”€ data/                  # Static data
β”œβ”€β”€ hooks/                 # Custom React hooks
β”œβ”€β”€ lib/                   # Utility libraries
β”œβ”€β”€ types/                 # TypeScript definitions
└── utils/                 # Helper functions

πŸ”§ Available Scripts

Command Description
npm run dev Start development server with Turbopack
npm run build Build production application
npm run start Start production server
npm run lint Run ESLint code analysis
npm run test Execute Jest test suite
npm run test:watch Run tests in watch mode

🌐 Deployment

Vercel (Recommended)

  1. Connect to Vercel

    • Push code to GitHub
    • Import project in Vercel Dashboard
    • Configure environment variables
    • Deploy automatically
  2. Environment Variables

    # No external authentication variables needed
    # Local authentication uses localStorage
    

Alternative Platforms

  • Netlify: Use Next.js build adapter
  • AWS Amplify: Deploy with SSR support
  • Docker: Containerized deployment
  • Railway: Simple deployment platform

πŸ”’ Security Features

  • Content Security Policy - XSS protection
  • Security Headers - OWASP recommended headers
  • Authentication - Secure local authentication
  • Input Validation - Form data sanitization
  • HTTPS Enforcement - Secure data transmission

πŸ“Š Performance Optimizations

  • Image Optimization - Next.js automatic image optimization
  • Code Splitting - Automatic bundle splitting
  • Lazy Loading - Component-level lazy loading
  • Caching Strategy - Optimized caching headers
  • Turbopack - Ultra-fast development builds

🀝 Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository
  2. Create feature branch
    git checkout -b feature/amazing-feature
  3. Commit changes
    git commit -m 'Add amazing feature'
  4. Push to branch
    git push origin feature/amazing-feature
  5. Open Pull Request

Development Guidelines

  • Follow TypeScript best practices
  • Write meaningful commit messages
  • Add tests for new features
  • Update documentation as needed
  • Ensure responsive design compatibility

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ“ž Contact & Support

πŸ™ Acknowledgments

πŸ“ˆ Project Stats

  • Performance Score: 99 (Lighthouse)
  • Accessibility Score: 100 (Lighthouse)
  • Best Practices: 100 (Lighthouse)
  • SEO Score: 100 (Lighthouse)

πŸ“Š View Full Lighthouse Report


🌊 Navigate Global Trade with Confidence 🚒

Built with ❀️ by Mohammed Samier Mouawad

About

A modern, responsive web application for global ocean logistics and shipping solutions. Navigate global trade with trusted ocean logistics, professional shipping services, real-time tracking, and reliable worldwide delivery solutions.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •