README

Open-source Laravel starter kit with Filament, NativePHP SuperNative, and Laravel MCP.

Stack

Piece	Package
Laravel	`laravel/framework`
Admin	`filament/filament` (panel at `/admin`)
API auth	`laravel/sanctum` — wired, not demoed
Mobile / SuperNative	`nativephp/mobile`
Native UI	`nativephp/mobile-ui`
Web UI (browser EDGE)	`nativephp/web-ui`
MCP server	`laravel/mcp` — no auth added

Requirements

PHP 8.4+ (Herd recommended)
Composer
Node (optional, for Vite)
Xcode / Android Studio for native runs (NativePHP Mobile v4 environment)

Quick start

Laravel installer

laravel new my-app --using=nativephp/superstack

Laravel Herd

In Herd’s site creation wizard, choose a community / custom starter kit and enter nativephp/superstack.

After create

cd my-app
php artisan migrate
# NativePHP (re-run after upgrades)
php artisan native:install both --no-interaction

Create a Filament admin user with the Filament installation docs (php artisan make:filament-user).

With Laravel Herd, the site is available at http://my-app.test (or whatever you named the project).

Home (SuperNative via Web UI): http://superstack.test
Admin panel: http://superstack.test/admin
API: Sanctum is installed (routes/api.php) — wired for token auth, not demoed with sample endpoints beyond /api/user

MCP

Routes live in routes/ai.php. No authentication is configured on the MCP server — fine for local exploration, not production-ready as-is.

Web: POST /mcp/superstack
Local: php artisan mcp:start superstack

Starter tool: app-info (App\Mcp\Tools\AppInfoTool) — returns app + package versions.

php artisan mcp:inspector mcp/superstack

See the Laravel MCP docs for servers, tools, and auth options.

Native / SuperNative

Home is a SuperNative screen (Route::native). On a phone, NativePHP Mobile v4 renders it natively; in the browser, Web UI renders the same Blade as HTML.

php artisan native:run

See Installation and SuperNative.

NATIVEPHP_APP_ID defaults to com.superstack.app in .env. The nativephp/ directory is gitignored — regenerate with php artisan native:install.

nativephp / superstack

Package info

Security

Statistics