International shipping company website
Caravan Cargo
Bilingual corporate site for an international shipping company: quote request flow, branch locator and a Laravel CMS that handles Arabic and English editing in one panel.
- Year
- 2024
- Role
- Full-stack development
- Category
- 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
- 01
Quote form must capture 8+ structured fields without feeling like a tax return.
- 02
Branch locator that loads fast on mobile without paying Google Maps API fees per visit.
- 03
Bilingual editing flow that does not create two sets of branches to drift apart.
- 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 I learned
- 01
Structured forms beat free-text contact forms by an order of magnitude in conversion-to-quote.
- 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 delivered by Ali Haitham Yosef, founder of a software company in Damascus that carries his name. His role on the project: Full-stack development.
What is Caravan Cargo?
Bilingual corporate site for an international shipping company: quote request flow, branch locator and a Laravel CMS that handles Arabic and English editing in one panel.
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. The company builds ERP systems, point-of-sale systems, mobile apps and websites for clients in Syria, Lebanon, Jordan, Iraq, Turkey and the Gulf states, working remotely. Contact: info@aliyosef.online.














