Skip to content
offskip-davePublic

About

An Elixir port of Laravel 13

Resources

Stars

4 stars

Watchers

0 watching

Forks

Repository files navigation

Laravex Logo

CI Documentation Elixir Status

About Laravex

Laravex is a web application skeleton and thin Illuminate-shaped runtime for Elixir. It brings Laravel’s expressive, enjoyable developer experience to the BEAM — same layout, familiar APIs, OTP underneath.

Laravex eases common tasks used in many web projects, such as:

Elixir, not PHP. Laravel conventions, not Phoenix conventions.
No lib/my_app_web, no contexts-as-primary UX, no LiveView as the default shape. If you know Laravel, Laravex feels familiar from day one.

Drivers default to zero-Hex CLIs/TCP; set DB_CLIENT=native / REDIS_CLIENT=native (and similar) for pooled Hex clients. See docs/DEPLOY.md.

Learning Laravex

The project wiki is the documentation home — installation, the request lifecycle, Eloquex, Blade, Artisan, and more. Agent/contributor notes live in AGENTS.md. Deployment notes are in docs/DEPLOY.md.

If you already know Laravel, start with Directory Structure and Limitations so expectations stay honest.

Quick start

cp .env.example .env
mix compile
./artisan key:generate
./artisan migrate
./artisan db:seed
./artisan serve
mix test

Your application will be available at http://localhost:8000. Use a reverse proxy + Bandit (or another Elixir HTTP server) in production; keep ./artisan serve for local development.

Artisan

./artisan list
./artisan make:model Post -m
./artisan make:resource UserCollection --collection
./artisan route:list
./artisan queue:work --once
./artisan schedule:run
./artisan install:api
./artisan install:broadcasting
./artisan install:starter-kit
./artisan tinker

Layout

Mirrors laravel/laravel 13.x: app/, bootstrap/, config/, database/, public/, resources/, routes/, storage/, tests/, artisan. Runtime lives under lib/laravex/.

FAQ

What’s wrong with PHP?
Nothing. Laravel on PHP is excellent. Laravex isn’t a rejection of PHP — it’s for teams that want Laravel’s application shape and DX on the BEAM (OTP, concurrency, supervision, long-lived processes).

Why not just use Phoenix?
Phoenix is the right default for most Elixir web apps. Laravex exists for a different bet: keep the Laravel mental model (app/, routes/, artisan, Eloquent-shaped models, Blade, middleware groups) instead of adopting Phoenix contexts, *_web, and LiveView as the primary UX. If you want idiomatic Elixir/Phoenix, use Phoenix.

What’s the intention of Laravex?
Port the Laravel 13 application skeleton plus a thin Illuminate-shaped runtime to Elixir — faithful layout and APIs, not a line-by-line clone of every package. Prefer extending lib/laravex/ for framework behavior and app/ for application code. Stay zero-Hex where possible (CLI DB adapters, RESP Redis, SMTP, S3 via :httpc).

Is it a drop-in Laravel replacement?
No. APIs aim to feel familiar so Laravel muscle memory transfers, but this is Elixir: immutability, pattern matching, and OTP replace PHP’s request lifecycle and some Illuminate internals. Expect gaps; see the Limitations wiki page and AGENTS.md.

Who is this for?
Laravel developers curious about Elixir who don’t want to relearn an entire web stack on day one, and Elixir developers who prefer Laravel’s request/controller/resource style over Phoenix’s conventions.

Contributing

Issues and pull requests are welcome. Prefer Laravel-faithful APIs and layout; do not introduce Phoenix directory conventions. See AGENTS.md for conventions and out-of-scope items.

License

Laravex is open-source software. Not affiliated with Laravel LLC or the Elixir core team — built to feel like Laravel on the BEAM.

About

An Elixir port of Laravel 13

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages