@gxp-dev/tools 2.0.61 → 2.0.63

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gxp-dev/tools",
-  "version": "2.0.61",
+  "version": "2.0.63",
   "description": "Dev tools to create platform plugins",
   "type": "commonjs",
   "publishConfig": {

package/runtime/vite.config.js

@@ -140,17 +140,40 @@ export default defineConfig(({ mode }) => {
 		name: "runtime-files",
 		configureServer(server) {
 			server.middlewares.use((req, res, next) => {
-				// Serve runtime index.html for root requests (unless local index.html is opted in)
+				// Serve runtime index.html for root requests and SPA navigation requests
+				// (unless local index.html is opted in). SPA fallback is required so
+				// client-side routers (e.g. vue-router createWebHistory) can handle
+				// deep links when no physical index.html exists at the project root.
+				const rawUrl = req.url || "";
+				const urlPath = rawUrl.split("?")[0];
+				const accept = req.headers.accept || "";
+				const isGetOrHead = req.method === "GET" || req.method === "HEAD";
+				const isInternalPath =
+					urlPath.startsWith("/@") ||
+					urlPath.startsWith("/__") ||
+					urlPath.startsWith("/node_modules/") ||
+					urlPath.startsWith("/src/") ||
+					urlPath.startsWith("/dev-assets/") ||
+					urlPath.startsWith("/api-proxy/");
+				const hasExtension = path.extname(urlPath) !== "";
+				const isSpaNavigation =
+					isGetOrHead &&
+					!isInternalPath &&
+					!hasExtension &&
+					accept.includes("text/html");
+
 				if (
 					!useLocalIndex &&
-					(req.url === "/" || req.url === "/index.html")
+					(urlPath === "/" ||
+						urlPath === "/index.html" ||
+						isSpaNavigation)
 				) {
 					const runtimeIndexPath = path.join(runtimeDir, "index.html");
 					if (fs.existsSync(runtimeIndexPath)) {
 						// Read and transform the runtime index.html
 						server
 							.transformIndexHtml(
-								req.url,
+								rawUrl,
 								fs.readFileSync(runtimeIndexPath, "utf-8")
 							)
 							.then((html) => {

package/template/vite.config.js

@@ -208,44 +208,44 @@ export default defineConfig(({ mode }) => {
 				name: "spa-fallback",
 				configureServer(server) {
 					return () => {
-					server.middlewares.use((req, res, next) => {
-						// Only handle GET requests for non-file routes
-						if (req.method !== "GET") {
-						next();
-						return;
-						}
+						server.middlewares.use((req, res, next) => {
+							// Only handle GET requests for non-file routes
+							if (req.method !== "GET") {
+								next();
+								return;
+							}
 
-						// Skip API routes, health checks, and known file extensions
-						if (
-						req.url.startsWith("/@") ||
-						req.url.startsWith("/api") ||
-						req.url === "/__health" ||
-						/\.[a-z0-9]+$/i.test(req.url) // Has file extension
-						) {
-						next();
-						return;
-						}
+							// Skip API routes, health checks, known file extensions, and vite internals
+							if (
+								req.url.startsWith("/@") ||
+								req.url.startsWith("/api") ||
+								req.url === "/__health" ||
+								/\.[a-z0-9]+$/i.test(req.url) // Has file extension
+							) {
+								next();
+								return;
+							}
 
-						// Serve index.html for all other routes (SPA fallback)
-						const indexPath = path.join(process.cwd(), "index.html");
-						if (fs.existsSync(indexPath)) {
-						server
-							.transformIndexHtml(
-							req.url,
-							fs.readFileSync(indexPath, "utf-8")
-							)
-							.then((html) => {
-							res.setHeader("Content-Type", "text/html");
-							res.end(html);
-							})
-							.catch((err) => {
-							console.error("Error serving SPA fallback:", err);
-							next(err);
-							});
-						} else {
-						next();
-						}
-					});
+							// Check if local index.html exists, otherwise use toolkit version
+							const localIndexPath = path.join(process.cwd(), "index.html");
+							const toolkitIndexPath = path.join(runtimeDir, "index.html");
+							const indexPath = fs.existsSync(localIndexPath) ? localIndexPath : toolkitIndexPath;
+
+							if (fs.existsSync(indexPath)) {
+								server
+									.transformIndexHtml(req.url, fs.readFileSync(indexPath, "utf-8"))
+									.then((html) => {
+										res.setHeader("Content-Type", "text/html");
+										res.end(html);
+									})
+									.catch((err) => {
+										console.error("Error serving SPA fallback:", err);
+										next(err);
+									});
+							} else {
+								next();
+							}
+						});
 					};
 				},
 			},