Nativephp Superstack

#Super Stack

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

#Stack

#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.

#License

MIT © Bifrost Technologies LLC. See LICENSE and CONTRIBUTING.