Volāre Documentation
Comprehensive technical documentation for the Volāre travel platform - the byvolare.com Web storefront and the Arkana back office.
One Platform, Two Products
Section titled “One Platform, Two Products”- Web — byvolare.com, Volāre’s online travel agency: the customer-facing storefront where travellers browse destinations and buy their trips. Lives in
frontend/(Frontend Overview). - Arkana — arkana.byvolare.com, the brain of Volāre: the FilamentPHP back office where the team configures everything — products, offers, pricing, suppliers, bookings, and CMS content — and where the REST API that feeds the Web lives. Lives in
backend/(Backend Overview).
Where to go
Section titled “Where to go”Start HereYour first-week reading path: what to read, in which order, and what you will be able to do after each day.
Arkana (back office)The business, menu by menu: suppliers, products, offers, bookings, markets, CMS.
BackendLaravel 13 services, APIs, data model and integrations behind Arkana.
The Web (frontend)byvolare.com: Astro 7 with React 19 islands and Tailwind CSS v4.
ArchitectureHow the pieces fit together: apps, database, queues, external services.
InfrastructureAWS environments, servers, the infra-volare repository, deploys and alerts.
GlossaryOffer, PBM, allotment, stop sale, L2B, pax… every internal word explained.
Artisan CommandsEvery operational command, what it does and whether it is safe to run.
Technology Stack
Section titled “Technology Stack”| Component | Technology | Version |
|---|---|---|
| Backend (Arkana) | Laravel on PHP 8.5 | 13.x |
| Admin panel (Arkana) | FilamentPHP | 5.x |
| Frontend (Web) | Astro + React islands | 7.x / 19.x |
| Styling | Tailwind CSS | 4.x |
| Database | PostgreSQL (Amazon RDS in production) | 18 |
| Cache, sessions, queues | Database drivers (PostgreSQL) | - |
| Tests | Pest | 5.x |
| Payments | Stripe (Laravel Cashier 16) and Redsys | - |
| AI | Laravel AI SDK (laravel/ai) |
1.x |
| Hosting | AWS EC2 Auto Scaling (us-east-2), defined in infra-volare |
- |
| Observability | Nightwatch, Sentry, Grafana Cloud, Telescope (local) | - |