NativePHP/superstack

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

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

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

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

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

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.

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.

MIT © Bifrost Technologies LLC. See LICENSE and CONTRIBUTING.