Ready Super Stack for Packagist web-ui and first public polish.

Switch to nativephp/web-ui from Packagist, set LICENSE to Bifrost Technologies LLC, add CONTRIBUTING, wire NativeServiceProvider, and slim the mobile bundle with safe cleanup excludes.

Author: shanerbaner82

CONTRIBUTING.md

@@ -0,0 +1,39 @@
+# Contributing
+
+Thanks for helping with Super Stack.
+
+## Setup
+
+1. Clone the repo and `composer install`
+2. Copy `.env.example` to `.env`, run `php artisan key:generate`, then `php artisan migrate`
+3. Create an admin user via the [Filament docs](https://filamentphp.com/docs/panels/installation#creating-a-user)
+4. For native work, follow [NativePHP Mobile v4](https://nativephp.com/docs/mobile/4/getting-started/installation) (`php artisan native:install`, then `php artisan native:run`)
+
+Herd tip: the app should be available at `http://superstack.test`.
+
+## What belongs where
+
+| 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.
+
+## Pull requests
+
+- Keep changes focused; prefer one concern per PR
+- Run `php artisan test` before opening a PR
+- Match existing code style (`pint` if 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
+
+## Reporting issues
+
+Include PHP / Laravel / NativePHP Mobile versions, platform (iOS/Android/web), and steps to reproduce. A simulator screenshot or log excerpt helps.
+
+## License
+
+By contributing, you agree your contributions are licensed under the MIT License (Copyright Bifrost Technologies LLC).

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 NativePHP
+Copyright (c) 2026 Bifrost Technologies LLC
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -15,7 +15,7 @@ Open-source Laravel starter kit with **Filament**, **NativePHP SuperNative**, an
 | API auth | [`laravel/sanctum`](https://laravel.com/docs/sanctum) — wired, not demoed |
 | Mobile / SuperNative | [`nativephp/mobile`](https://nativephp.com/docs/mobile/4/getting-started/introduction) |
 | Native UI | [`nativephp/mobile-ui`](https://github.com/NativePHP/mobile-ui) |
-| Web UI (browser EDGE) | [`nativephp/mobile-web`](https://github.com/NativePHP/web-ui) (VCS: [NativePHP/web-ui](https://github.com/NativePHP/web-ui)) |
+| Web UI (browser EDGE) | [`nativephp/web-ui`](https://packagist.org/packages/nativephp/web-ui) |
 | MCP server | [`laravel/mcp`](https://laravel.com/docs/mcp) — no auth added |
 
 ## Requirements
@@ -75,4 +75,4 @@ See [Installation](https://nativephp.com/docs/mobile/4/getting-started/installat
 
 ## License
 
-MIT
+MIT © Bifrost Technologies LLC. See [LICENSE](LICENSE) and [CONTRIBUTING](CONTRIBUTING.md).

app/NativeComponents/Home.php

@@ -20,7 +20,7 @@ public function render(): View
                 'Laravel' => \Illuminate\Foundation\Application::VERSION,
                 'Filament' => \Composer\InstalledVersions::getPrettyVersion('filament/filament'),
                 'NativePHP Mobile' => \Composer\InstalledVersions::getPrettyVersion('nativephp/mobile'),
-                'Web UI' => \Composer\InstalledVersions::getPrettyVersion('nativephp/mobile-web'),
+                'Web UI' => \Composer\InstalledVersions::getPrettyVersion('nativephp/web-ui'),
                 'Laravel MCP' => \Composer\InstalledVersions::getPrettyVersion('laravel/mcp'),
             ],
         ]);

bootstrap/providers.php

@@ -1,6 +1,17 @@
 <?php
 
-return [
-    App\Providers\AppServiceProvider::class,
-    App\Providers\Filament\AdminPanelProvider::class,
+use App\Providers\AppServiceProvider;
+use App\Providers\Filament\AdminPanelProvider;
+use App\Providers\NativeServiceProvider;
+
+$providers = [
+    AppServiceProvider::class,
+    NativeServiceProvider::class,
 ];
+
+// Admin panel is web-only; the mobile bundle excludes app/Providers/Filament.
+if (! filter_var(env('NATIVEPHP_RUNNING', false), FILTER_VALIDATE_BOOLEAN)) {
+    $providers[] = AdminPanelProvider::class;
+}
+
+return $providers;

composer.json

@@ -12,12 +12,6 @@
         "starter-kit"
     ],
     "license": "MIT",
-    "repositories": [
-        {
-            "type": "vcs",
-            "url": "https://github.com/nativephp/web-ui"
-        }
-    ],
     "require": {
         "php": "^8.4",
         "filament/filament": "^5.0",
@@ -27,7 +21,7 @@
         "laravel/tinker": "^3.0",
         "nativephp/mobile": "^4.4",
         "nativephp/mobile-ui": "^0.4.0",
-        "nativephp/mobile-web": "@dev"
+        "nativephp/web-ui": "^0.0.1@alpha"
     },
     "require-dev": {
         "fakerphp/faker": "^1.23",
@@ -90,9 +84,7 @@
         ]
     },
     "extra": {
-        "laravel": {
-            "dont-discover": []
-        }
+        "laravel": []
     },
     "config": {
         "optimize-autoloader": true,

composer.lock

@@ -247,10 +247,34 @@
     */
 
     'cleanup_exclude_files' => [
+        // Runtime temp / logs (defaults)
         'storage/framework/sessions',
         'storage/framework/cache',
         'storage/framework/testing',
         'storage/logs/laravel.log',
+
+        // Repo / docs / CI — not needed on device
+        'docs',
+        '.github',
+        '.junie',
+        'tests',
+        'phpunit.xml',
+        'vite.config.js',
+        'package.json',
+        'package-lock.json',
+        'AGENTS.md',
+        'CLAUDE.md',
+
+        // Filament admin + MCP + Sanctum API surface (web-only for this kit)
+        'app/Providers/Filament',
+        'app/Mcp',
+        'routes/ai.php',
+        'routes/api.php',
+        'config/sanctum.php',
+        'public/css/filament',
+        'public/js/filament',
+        'public/fonts/filament',
+        'public/fonts-manifest.dev.json',
     ],
 
     /*