Repository navigation
Home
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.exas the public app shape). If you know Laravel, Laravex feels familiar from day one.
| 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 |
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 serveYour 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.
| Subsystem | Supported drivers |
|---|---|
| Database | SQLite (default) · MySQL/MariaDB · PostgreSQL |
| Cache | array · file · database · redis |
| Session | file · database · redis |
| Queue | sync · database · deferred · redis |
| 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.).
- Request-Lifecycle
- Routing
- Middleware
- CSRF-Protection
- Controllers
- Requests
- Responses
- Views
- Blade-Templates
- Asset-Bundling
- Session
- Validation
- Error-Handling
- Logging
- Artisan-Console
- Broadcasting
- Cache
- Collections
- Events
- File-Storage
- Helpers
- HTTP-Client
- Localization
- Notifications
- Pipeline
- Queues
- Rate-Limiting
- Strings
- Task-Scheduling
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.
Laravex — Laravel-faithful application skeleton & runtime for Elixir.
GitHub
·
Docs
·
Limitations
·
Laravel Docs
Not affiliated with Laravel LLC or the Elixir core team. Built to feel like Laravel on the BEAM.
- Home
- Installation
- Configuration
- Directory-Structure
- Request-Lifecycle
- Service-Container
- Service-Providers
- Deployment
- Routing
- Middleware
- CSRF-Protection
- Controllers
- Requests
- Responses
- Views
- Blade-Templates
- Asset-Bundling
- Session
- Validation
- Error-Handling
- Logging
- Artisan-Console
- Broadcasting
- Cache
- Collections
- Events
- File-Storage
- Helpers
- HTTP-Client
- Localization
- Notifications
- Pipeline
- Queues
- Rate-Limiting
- Strings
- Task-Scheduling