Thanks for helping with Super Stack.
Prefer a fresh app from the kit:
laravel new my-app --using=nativephp/superstackOr in Laravel Herd’s site wizard, pick a community / custom starter kit and enter nativephp/superstack.
For contributors working on this repo itself: clone, composer install, copy .env.example, php artisan key:generate, then php artisan migrate.
- Create an admin user via the Filament docs
- For native work, follow NativePHP Mobile v4 (
php artisan native:install, thenphp artisan native:run)
Herd tip: the site is http://my-app.test (or your project name).
| Surface | Path | Ships on device? |
|---|---|---|
| SuperNative screens | app/NativeComponents, resources/views/native, routes/web.php |
Yes |
| Filament admin | app/Providers/Filament, /admin |
No (excluded in config/nativephp.php) |
| MCP | app/Mcp, routes/ai.php |
No |
| Sanctum API | routes/api.php, config/sanctum.php |
No (wired, not demoed) |
Mobile bundle exclusions live in nativephp.cleanup_exclude_files. Do not exclude vendor/* packages from that list — stripping Composer packages after install breaks the on-device build.
- Keep changes focused; prefer one concern per PR
- Run
php artisan testbefore opening a PR - Match existing code style (
pintif you touch PHP) - Update the README when behavior or setup steps change
- New NativePHP UI should use theme tokens (
text-theme-on-surface, etc.) so light/dark both work
Include PHP / Laravel / NativePHP Mobile versions, platform (iOS/Android/web), and steps to reproduce. A simulator screenshot or log excerpt helps.
By contributing, you agree your contributions are licensed under the MIT License (Copyright Bifrost Technologies LLC).