Skip to content

International shipping company website

Caravan Cargo

We built a bilingual site for an international shipping company: quote requests, a branch locator and one Laravel panel for Arabic and English content.

Year
2024
Role
Full-stack development
Category
International shipping company website
Caravan Cargo: Caravan Cargo: International shipping company website

The challenge

An international shipping company needed a site that carries the whole operation: services, branches and a real quote-request flow, with bilingual editing in one panel.

The approach

A Laravel CMS with paired Arabic and English fields, a Tailwind front end, a quote form that goes to the sales inbox with structured fields (origin, destination, weight, type) and a branch locator on OpenStreetMap.

The outcome

Bilingual content in one panel, and quote requests that reach sales without a spreadsheet in between.

Under the hood

Field
International shipping · Logistics
Type
Corporate site + quote pipeline + branch locator
Team
full-stack

01

The real problem

Shipping is a high-touch sales process — the quote-request form is the front door to the entire business. The previous site treated it as an afterthought (a contact form that dumped free text into a shared mailbox). Sales team had to read the message, ask for missing fields by email, then enter the lead into their system. The brief: a quote form that captures every field sales needs to price the job, in the language the customer is comfortable in.

02

Who did what

Laravel back end, Tailwind front, branch-locator map, quote-form pipeline. The client supplied content and branch data.

Full-stack engineer
Laravel + Blade + Alpine. Bilingual content model with Spatie/translatable.
Quote pipeline designer
Structured quote form (origin → destination → weight → service type) that routes into the sales inbox with parsed fields, not free text.
Map + locator engineer
Branch locator with OpenStreetMap tiles (no Google Maps bill), KSA-aware search.

03

Architecture

01 — Edge

Edge tier

  • Cloudflare

    CDN · DNS

    KSA + UAE edges

02 — App

Application tier

  • Laravel 11

    PHP 8.3 · Blade · Alpine

    CMS + quote pipeline + locator

  • Leaflet + OSM

    Client-side map

    Branch locator; cached geocoding via server-side proxy

03 — Data

Data tier

  • MySQL 8

    Bilingual JSON columns

    Branches, services, content blocks

  • Redis 7

    Cache + geocoding

    Nominatim response cache (24h TTL)

04

Challenges

  1. 01

    Quote form must capture 8+ structured fields without feeling like a tax return.

  2. 02

    Branch locator that loads fast on mobile without paying Google Maps API fees per visit.

  3. 03

    Bilingual editing flow that does not create two sets of branches to drift apart.

  4. 04

    Sales inbox routing that respects which branch is closest to the origin (KSA Eastern vs Western).

05

Hard problems

  • Quote form completion rate

    Progressive disclosure: 3 fields at first (origin, destination, weight), more revealed as user fills the previous.

  • OpenStreetMap over Google

    Leaflet + OSM tiles. Geocoding via Nominatim with a Redis cache to respect their rate limit.

06

Why these technologies

  • Laravel + Spatie/translatable

    • Single bilingual editing surface in Filament. Branches, services, pages — all share the same translation pattern.
    • Lead routing logic (closest branch by origin region) sits naturally in a service class, not in JavaScript on the form.
  • OpenStreetMap over Google Maps

    • No per-call pricing means no surprise bill if the locator becomes popular.
    • Tiles look honest, not over-polished — fits a shipping company that ships actual physical things.

07

What we learned

  1. 01

    Structured forms beat free-text contact forms by an order of magnitude in conversion-to-quote.

  2. 02

    OSM is the right default for any business map that does not need turn-by-turn navigation. Switch to Google when you need their data — not when you assume you need their data.

Stack

  • Laravel
  • Blade
  • Alpine.js
  • Tailwind CSS
  • OpenStreetMap

Questions about Caravan Cargo

Who built Caravan Cargo?

Caravan Cargo was built by Ali Yosef Software, a software company in Damascus. Our scope on the project: Full-stack development.

What is Caravan Cargo?

We built a bilingual site for an international shipping company: quote requests, a branch locator and one Laravel panel for Arabic and English content.

What technology does Caravan Cargo use?

Laravel, Blade, Alpine.js, Tailwind CSS, OpenStreetMap.

When was Caravan Cargo built?

It was built during 2024.

Can you build a system like Caravan Cargo for my business?

Yes. We build ERP systems, point-of-sale systems, mobile apps and websites for clients in Syria, the neighbouring countries and the Gulf. Contact: info@aliyosef.online.