README

Build desktop and mobile apps with Laravel + Livewire. No Electron. No React Native. Just PHP.

What is NativeBlade

NativeBlade lets Laravel developers build desktop and mobile apps using only PHP and Blade. Your entire Laravel + Livewire application runs inside a PHP WebAssembly runtime, wrapped in a Tauri 2 shell. No JavaScript frameworks, no API layers, just the Laravel you already know.

One codebase ships to Windows, macOS, Linux, Android, and iOS.

Pure Laravel: routes, Livewire components, Blade, Eloquent on SQLite.
Native shell: top bar, bottom nav, drawer, modal, tray, all outside the WebView.
Native APIs: dialogs, notifications, camera, geolocation, biometric, NFC, push, and more.
Offline first: SQLite persisted to IndexedDB, works without a server.
Tiny bundle: a full Laravel + Livewire app compresses to about 6 MB gzipped.

Documentation

Everything lives at docs.nativeblade.dev: architecture, every plugin, configuration, publishing, and the CLI.

Quick start

# 1. Create a Laravel project
composer create-project "laravel/laravel:^13.0" my-app
cd my-app

# 2. Install NativeBlade
composer require nativeblade/nativeblade
php artisan nativeblade:install

# 3. Build the frontend and launch the desktop app
npm run build
php artisan nativeblade:dev

Add mobile with php artisan nativeblade:add android (or ios). The first run compiles the Rust binary and takes a few minutes; later runs are fast.

Requirements: PHP 8.3+, Laravel 12+, Livewire 4, Node 20+, and Rust. Full setup is in the docs.

Build in the cloud

Build your app for the stores without Android Studio or Xcode, using nativeblade.dev. Link your GitHub repository and build for dev, test, and production. The free plan includes 8 builds per month. See Publish.

NativeBlade Portal

A companion app that loads any NativeBlade dev bundle by URL or QR scan, so you can preview your app on a real device with no build step. Run php artisan nativeblade:dev --platform=portal --host=<your-ip>, then scan the QR shown in your terminal.

See Portal.

NativeBlade Studio

Build NativeBlade apps with a clean, high-level syntax over MCP, using your own AI. Studio follows MCP standards, so any MCP-capable assistant can drive it.

Repository: github.com/NativeBlade/studio. See Studio.

Contributing

See CONTRIBUTING.md.

Sponsor

NativeBlade is free and 100% open source, with no paid tier and no closed core. If it saves your team time, sponsoring keeps it that way. For teams running in production, Business Support offers a private channel with a guaranteed response time.

License

MIT

Built with Laravel, Livewire, Tauri, and PHP WebAssembly.
Jefferson T.S

nativeblade / nativeblade

Maintainers

Package info

Fund package maintenance!

Statistics

Security