fix: patch up broken inertia integration

Author: mychidarko

src/ViewInstallCommand.php

@@ -169,6 +169,8 @@ protected function installReact()
             'recursive' => true,
         ]);
 
+        $this->setupLiteFrontend($directory);
+
         $package = json_decode(file_get_contents("$directory/package.json"), true);
         $package['type'] = 'module';
         $package['scripts']['dev'] = 'vite';
@@ -233,6 +235,8 @@ protected function installSvelte()
             'recursive' => true,
         ]);
 
+        $this->setupLiteFrontend($directory);
+
         $package = json_decode(file_get_contents("$directory/package.json"), true);
         $package['type'] = 'module';
         $package['scripts']['dev'] = 'vite';
@@ -407,10 +411,12 @@ protected function installVue()
             return 1;
         }
 
-        \Leaf\FS\Directory::copy(__DIR__ . '/themes/tailwind', $directory, [
+        \Leaf\FS\Directory::copy(__DIR__ . '/themes/vue', $directory, [
             'recursive' => true,
         ]);
 
+        $this->setupLiteFrontend($directory);
+
         $package = json_decode(file_get_contents("$directory/package.json"), true);
         $package['type'] = 'module';
         $package['scripts']['dev'] = 'vite';
@@ -451,6 +457,57 @@ protected function installVue()
     }
 
     // ------------------------ utils ------------------------ //
+
+    /**
+     * Wire up index.php for a lite (non-MVC) frontend install: point the
+     * view engine at the copied views/ directory, cache compiled views in
+     * storage/cache, and load the demo routes file the theme ships with.
+     * Idempotent — safe to run on repeated installs.
+     */
+    protected function setupLiteFrontend(string $directory)
+    {
+        $indexFile = "$directory/index.php";
+
+        $viewConfig = <<<'PHP'
+app()->config([
+    'views.path' => 'views',
+    'views.cache' => __DIR__ . '/storage/cache',
+]);
+PHP;
+
+        $routesRequire = "require __DIR__ . '/routes/_frontend.php';";
+
+        if (!file_exists($indexFile)) {
+            file_put_contents(
+                $indexFile,
+                "<?php\n\nrequire __DIR__ . '/vendor/autoload.php';\n\n$viewConfig\n\n$routesRequire\n\napp()->run();\n"
+            );
+
+            return;
+        }
+
+        \Leaf\FS\File::write($indexFile, function ($content) use ($viewConfig, $routesRequire) {
+            $additions = '';
+
+            if (strpos($content, "'views.path'") === false && strpos($content, '"views.path"') === false) {
+                $additions .= "$viewConfig\n\n";
+            }
+
+            if (strpos($content, 'routes/_frontend.php') === false) {
+                $additions .= "$routesRequire\n\n";
+            }
+
+            if ($additions === '') {
+                return $content;
+            }
+
+            if (strpos($content, 'app()->run();') !== false) {
+                return str_replace('app()->run();', "$additions" . 'app()->run();', $content);
+            }
+
+            return rtrim($content) . "\n\n" . rtrim($additions) . "\n";
+        });
+    }
     protected function isMVCApp()
     {
         $directory = getcwd();

src/themes/leaf3/AGENTS.md

@@ -3,9 +3,10 @@
 Before performing any task:
 
 1. Read `.leaf/CONTEXT.md` for project goals and architectural decisions.
-2. Use Leaf documentation:
+2. Use Leaf documentation. Fetch these RAW (curl or a non-summarizing fetch) — summarized docs have invented APIs that don't exist:
 
 - https://leafphp.dev/ai/SKILL.md
+- https://leafphp.dev/ai/references/lite.md — this is a lite app: modules that MVC auto-configures need manual wiring here, and this file is the complete contract (db, views, Vite, schema). Read it before writing any setup code.
 - https://leafphp.dev/llms.txt
 
 3. Inspect the codebase and use `leaf context` when you need a concise map of the application's structure. `context` lives in the global `leaf` CLI (no `php` prefix) — `php leaf context` will fail.

src/themes/react/vite.config.js

@@ -6,7 +6,7 @@ export default defineConfig({
     plugins: [
         leaf({
             hotFile: 'hot',
-            input: ['app/views/js/app.jsx'],
+            input: ['views/js/app.jsx'],
             refresh: true,
         }),
         react(),

src/themes/svelte/vite.config.js

@@ -5,7 +5,7 @@ import { svelte } from '@sveltejs/vite-plugin-svelte';
 export default defineConfig({
 	plugins: [
 		leaf({
-			input: ['app/views/js/app.js', 'app/views/css/app.css'],
+			input: ['views/js/app.js'],
 			refresh: true,
 		}),
 		svelte(),

src/themes/tailwind/view/css/app.css src/themes/tailwind/views/css/app.csssrc/themes/tailwind/view/css/app.css renamed to src/themes/tailwind/views/css/app.css

@@ -6,7 +6,7 @@ export default defineConfig({
     plugins: [
         tailwindcss(),
         leaf({
-            input: ["js/app.js", "css/app.css"],
+            input: ["views/css/app.css"],
             refresh: true,
         }),
     ],

src/themes/tailwind/vite.config.js

@@ -5,7 +5,7 @@ import vue from "@vitejs/plugin-vue";
 export default defineConfig({
 	plugins: [
 		leaf({
-			input: ["app/views/js/app.jsx"],
+			input: ["views/js/app.js"],
 			refresh: true,
 		}),
 		vue({

src/themes/vue/vite.config.js

@@ -127,6 +127,25 @@
     }
 });
 
+test('lite theme vite inputs point at files the theme ships', function () {
+    // view:install copies each theme into the project root, so every
+    // entry in the theme's vite.config.js input must resolve relative
+    // to the theme dir itself — an app/views/* path builds nothing
+    foreach (['react', 'svelte', 'vue'] as $theme) {
+        $themeDir = dirname(__DIR__) . "/src/themes/$theme";
+        $config = file_get_contents("$themeDir/vite.config.js");
+
+        preg_match('/input:\s*\[([^\]]*)\]/', $config, $inputList);
+        preg_match_all('/[\'"]([^\'"]+)[\'"]/', $inputList[1] ?? '', $inputs);
+
+        expect($inputs[1])->not->toBeEmpty();
+
+        foreach ($inputs[1] as $input) {
+            expect(file_exists("$themeDir/$input"))->toBeTrue("$theme vite input '$input' does not exist in the copied theme");
+        }
+    }
+});
+
 test('lite apps are born AI-ready', function () {
     leaf('create my-app --lite');