Skip to content
David Ciulla edited this page Nov 7, 2026 · 4 revisions

Laravex

Laravex

Laravex is an Elixir port of the Laravel 13 application skeleton and a thin Illuminate-shaped runtime called the Laravex framework. It lets you build web applications with the developer experience and directory conventions of Laravel — service providers, Eloquex models, Blade-inspired views, Artisan commands, middleware groups, queues, events, and more — while running on the Erlang VM (BEAM).

Elixir, not PHP. Laravel conventions, not Phoenix conventions. Laravex deliberately avoids the Phoenix directory layout (lib/my_app_web, contexts as the primary UX, router.ex as the public app shape). If you know Laravel, Laravex feels familiar from day one.


Why Laravex?

Concern Laravex answer
Familiar structure app/, bootstrap/, config/, routes/, tests/ — the Laravel 13 layout
OTP resilience Supervisors, GenServers, and the BEAM for free-fault tolerance
Eloquex ORM ActiveRecord-style models with relations, scopes, pagination, factories
Artisan CLI ./artisan wraps mix tasks; migrate, make:model, tinker, and more
Zero Phoenix deps No LiveView, no contexts-as-UX, no lib/my_app_web
Zero Hex runtime deps All drivers use OTP stdlib + optional host CLIs; no Hex packages in prod

Quick Start

git clone https://github.com/offskip-dave/laravex.git my-app
cd my-app
cp .env.example .env
mix deps.get
mix compile
./artisan key:generate
./artisan migrate
./artisan db:seed
./artisan serve

Your application will be available at http://localhost:8000.

Note: Laravex requires Elixir ~> 1.17 and a compatible Erlang/OTP release. See Installation for full prerequisites.


What's Included

Subsystem Supported drivers
Database SQLite (default) · MySQL/MariaDB · PostgreSQL
Cache array · file · database · redis
Session file · database · redis
Queue sync · database · deferred · redis
Mail log · array · smtp
File Storage local · s3 (S3-compatible, SigV4)
Broadcasting null · log · array · pubsub (in-process Registry)
Logging single · daily · monthly · stderr · errorlog · null
Notifications mail · database · log · broadcast
API Resources Resource · ResourceCollection (collects, paginator links/meta, make:resource --collection)

All drivers are zero-Hex-dependency — queries and connections use OTP stdlib, CLI tools, or :gen_tcp/:httpc directly.

Driver status and remaining limitations: See Limitations for the full matrix, including what is not yet implemented (SQL Server, Reverb, Horizon, Redis TLS, SMTP PLAIN auth, etc.).


Documentation

Getting Started

The Basics

Digging Deeper

Architecture

Security

Database

Eloquex ORM

Testing

Packages & Installables


Mirrors Laravel 13 Layout

Laravex tracks the Laravel 13 application skeleton. The lib/laravex/ tree is the framework runtime (the Illuminate analogue), while app/, bootstrap/, config/, routes/, and tests/ are your application code — identical in spirit to a fresh laravel new project.

Optional installables add extra routes, config files, and auth scaffolding on demand:

./artisan install:api           # adds routes/api.ex + config/sanctum.exs
./artisan install:broadcasting  # adds routes/channels.ex + config/broadcasting.exs
./artisan install:starter-kit   # full auth scaffolding (register/login/reset)

These are not committed to the default tree unless explicitly installed.

Clone this wiki locally