@lowdefy/server-dev 0.0.0-experimental-20260608135213 → 0.0.0-experimental-20260610101734

package/{pages/_app.js → client/App.jsx}

@@ -14,14 +14,7 @@
   limitations under the License.
 */
 
-// CSS layer order — MUST be the first CSS import. Turbopack treats this as critical
-// CSS that loads before hydration, locking the cascade priority (antd > base/preflight)
-// before antd's StyleProvider injects @layer antd {} at runtime.
-import '../build/layer-order.css';
-
 import React, { Suspense, useCallback, useEffect, useRef, useState } from 'react';
-import dynamic from 'next/dynamic';
-import { useRouter } from 'next/router';
 import useSWR from 'swr';
 
 import { ErrorBoundary } from '@lowdefy/block-utils';
@@ -33,13 +26,10 @@ import { XProvider } from '@ant-design/x';
 import antdLocaleLoaders from '../build/i18n/antdLocales.js';
 import antdXLocaleLoaders from '../build/i18n/antdXLocales.js';
 import dayjsLocaleMap from '../build/i18n/dayjsLocales.js';
-import Auth from '../lib/client/auth/Auth.js';
-import ErrorBar from '../lib/client/ErrorBar.js';
+import Auth from '../lib/client/auth/Auth.jsx';
+import ErrorBar from '../lib/client/ErrorBar.jsx';
 import request from '../lib/client/utils/request.js';
-
-// Full Tailwind CSS — also loaded via <link href="tailwind-jit.css"> in _document.js
-// for hot-reloading. The Turbopack chunk provides layer ordering guarantee on initial load.
-import '../build/globals.css';
+import Routing from './Routing.jsx';
 
 function ThemeTokenResolver({ lowdefyRef, children }) {
   const { token } = antdTheme.useToken();
@@ -50,12 +40,11 @@ function ThemeTokenResolver({ lowdefyRef, children }) {
   return children;
 }
 
-function App({ Component }) {
-  const router = useRouter();
+function App({ config, router }) {
   const lowdefyRef = useRef({});
   const [runtimeErrors, setRuntimeErrors] = useState([]);
-  // Subscribe to rootConfig SWR cache — deduplicates with inner App.js fetch.
-  // Without suspense so _app.js doesn't suspend — just re-renders when data arrives.
+  // Subscribe to rootConfig SWR cache — deduplicates with Routing's fetch.
+  // Without suspense so App doesn't suspend — just re-renders when data arrives.
   const { data: rootConfig } = useSWR(`${router.basePath}/api/root`, (url) => request({ url }));
   if (rootConfig?.theme) {
     lowdefyRef.current.theme = rootConfig.theme;
@@ -99,12 +88,10 @@ function App({ Component }) {
     ]);
   }, []);
 
-  // Clear runtime errors on route change
+  // Clear runtime errors on navigation
   useEffect(() => {
-    const clearErrors = () => setRuntimeErrors([]);
-    router.events.on('routeChangeStart', clearErrors);
-    return () => router.events.off('routeChangeStart', clearErrors);
-  }, [router.events]);
+    return router.subscribe(() => setRuntimeErrors([]));
+  }, [router]);
 
   const handleError = useCallback((error) => {
     if (lowdefyRef.current?._internal?.handleError) {
@@ -115,10 +102,11 @@ function App({ Component }) {
   }, []);
 
   // XProvider extends antd's ConfigProvider; merging antd + antd-X locale packs
-  // gives X components their built-in strings alongside antd's.
-  const mergedLocale = antdLocale || antdXLocale
-    ? { ...(antdLocale ?? {}), ...(antdXLocale ?? {}) }
-    : undefined;
+  // gives X components (Bubble, Sender, Conversations, ...) their built-in strings
+  // alongside antd's. antd X ships only en_US + zh_CN; other locales fall back
+  // to en_US for X-native strings.
+  const mergedLocale =
+    antdLocale || antdXLocale ? { ...(antdLocale ?? {}), ...(antdXLocale ?? {}) } : undefined;
 
   return (
     <StyleProvider layer>
@@ -153,7 +141,7 @@ function App({ Component }) {
               >
                 <Auth>
                   {(auth) => {
-                    return <Component auth={auth} lowdefy={lowdefyRef.current} />;
+                    return <Routing auth={auth} lowdefy={lowdefyRef.current} router={router} />;
                   }}
                 </Auth>
               </Suspense>
@@ -166,8 +154,4 @@ function App({ Component }) {
   );
 }
 
-const DynamicApp = dynamic(() => Promise.resolve(App), {
-  ssr: false,
-});
-
-export default DynamicApp;
+export default App;

package/{lib/client/Page.js → client/Page.jsx}

@@ -18,10 +18,10 @@ import React, { useEffect, useRef } from 'react';
 import { GenIcon } from 'react-icons/lib';
 import Client from '@lowdefy/client';
 
-import BuildErrorPage from './BuildErrorPage.js';
-import InstallingPluginsPage from './InstallingPluginsPage.js';
-import RestartingPage from './RestartingPage.js';
-import usePageConfig from './utils/usePageConfig.js';
+import BuildErrorPage from '../lib/client/BuildErrorPage.jsx';
+import InstallingPluginsPage from '../lib/client/InstallingPluginsPage.jsx';
+import RestartingPage from '../lib/client/RestartingPage.jsx';
+import usePageConfig from '../lib/client/utils/usePageConfig.js';
 
 const Page = ({
   auth,
@@ -48,7 +48,7 @@ const Page = ({
   }, [pageConfig?._warnings, lowdefy]);
 
   if (!pageConfig) {
-    router.replace(`/404`);
+    router.replace({ pathname: '/404' });
     return '';
   }
   if (pageConfig.buildError) {

package/{lib/client/Reload.js → client/Reload.jsx}

@@ -16,9 +16,12 @@
 
 import React, { useEffect, useState } from 'react';
 
-import useMutateCache from './utils/useMutateCache.js';
-import waitForRestartedServer from './utils/waitForRestartedServer.js';
+import useMutateCache from '../lib/client/utils/useMutateCache.js';
+import waitForRestartedServer from '../lib/client/utils/waitForRestartedServer.js';
 
+// SSE listener — config rebuilds notify via /api/reload. Tailwind CSS updates
+// arrive through Vite HMR now (globals.css is in the dev module graph), so
+// the old tailwind-jit.css link cache-bust is gone.
 const Reload = ({ children, basePath, lowdefy }) => {
   const [reset, setReset] = useState(false);
   const [restarting, setRestarting] = useState(false);
@@ -34,11 +37,6 @@ const Reload = ({ children, basePath, lowdefy }) => {
         if (lowdefy._internal?.initialised) {
           lowdefy._internal.initialised = false;
         }
-        // Refresh JIT CSS link to pick up newly compiled Tailwind classes
-        const cssLink = document.getElementById('tailwind-jit-css');
-        if (cssLink) {
-          cssLink.href = `${basePath}/tailwind-jit.css?v=${Date.now()}`;
-        }
         setReset(true);
         console.log('Reloaded config.');
       }, 600);

package/{lib/client/App.js → client/Routing.jsx}

@@ -14,40 +14,51 @@
   limitations under the License.
 */
 
-import React, { Suspense } from 'react';
+import React, { Suspense, useEffect, useState } from 'react';
 
-import { useRouter } from 'next/router';
+import Head from '@lowdefy/client/adapters/Head.js';
+import createLinkComponent from '@lowdefy/client/adapters/Link.js';
 
-import Head from 'next/head';
-import Link from 'next/link';
+import BuildingPage from '../lib/client/BuildingPage.jsx';
+import Reload from './Reload.jsx';
+import Page from './Page.jsx';
+import setPageId from '../lib/client/setPageId.js';
+import { getReloadVersion } from '../lib/client/utils/useMutateCache.js';
+import useRootConfig from '../lib/client/utils/useRootConfig.js';
 
-import BuildingPage from './BuildingPage.js';
-import Reload from './Reload.js';
-import Page from './Page.js';
-import setPageId from './setPageId.js';
-import { getReloadVersion } from './utils/useMutateCache.js';
-import useRootConfig from './utils/useRootConfig.js';
+import actions from '../build/plugins/actions.js';
+import blockMetas from '../build/plugins/blockMetas.json';
+import blocks from '../build/plugins/blocks.js';
+import icons from '../build/plugins/icons.js';
+import operators from '../build/plugins/operators/client.js';
+import staticJsMap from '../build/plugins/operators/clientJsMap.js';
 
-import actions from '../../build/plugins/actions.js';
-import blockMetas from '../../build/plugins/blockMetas.json';
-import blocks from '../../build/plugins/blocks.js';
-import icons from '../../build/plugins/icons.js';
-import operators from '../../build/plugins/operators/client.js';
-import staticJsMap from '../../build/plugins/operators/clientJsMap.js';
-
-const App = ({ auth, lowdefy }) => {
-  const router = useRouter();
+// Replaces lib/client/App.js — page resolution driven by the custom router
+// instead of next/router, everything else preserved.
+function Routing({ auth, lowdefy, router }) {
   const { data: rootConfig } = useRootConfig(router.basePath);
+  const [location, setLocation] = useState(() => router.getLocation());
+
+  useEffect(() => {
+    return router.subscribe(setLocation);
+  }, [router]);
+
+  const [Link] = useState(() => createLinkComponent({ router }));
 
   if (rootConfig?.theme) {
     lowdefy.theme = rootConfig.theme;
   }
 
-  const { redirect, pageId } = setPageId(router, rootConfig);
+  const { redirect, pageId } = setPageId(location, rootConfig);
+  useEffect(() => {
+    if (redirect) {
+      router.replace({ pathname: `/${pageId}` });
+    }
+  }, [redirect, pageId, router]);
   if (redirect) {
-    router.push(`/${pageId}`);
     return '';
   }
+
   return (
     <Reload basePath={router.basePath} lowdefy={lowdefy}>
       {(resetContext) => (
@@ -75,6 +86,6 @@ const App = ({ auth, lowdefy }) => {
       )}
     </Reload>
   );
-};
+}
 
-export default App;
+export default Routing;

package/client/main.jsx

@@ -0,0 +1,42 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+// CSS layer order — MUST be the first CSS import. This locks the cascade
+// priority (antd > base/preflight) before antd's StyleProvider injects
+// @layer antd {} at runtime. Vite's PostCSS pipeline compiles globals.css
+// (Tailwind) on the fly and hot-replaces it — the old tailwind-jit.css
+// side-channel is gone.
+import '../build/layer-order.css';
+
+import React from 'react';
+import { createRoot } from 'react-dom/client';
+import createRouter from '@lowdefy/client/adapters/createRouter.js';
+
+import App from './App.jsx';
+
+import '../build/globals.css';
+
+const config = JSON.parse(document.getElementById('__LOWDEFY_CONFIG__').textContent);
+const router = createRouter({ basePath: config.basePath ?? '', window });
+const container = document.getElementById('root');
+
+// Keep one React root across Vite HMR updates.
+const root = import.meta.hot?.data.root ?? createRoot(container);
+if (import.meta.hot) {
+  import.meta.hot.data.root = root;
+}
+
+root.render(<App config={config} router={router} />);

package/lib/build/app.js

@@ -13,7 +13,14 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */
+
+// Build artifacts are read from disk because the Hono server runs as
+// unbundled Node.js ESM — JSON imports would need import attributes, and
+// client code imports the build JSON directly through Vite instead.
+import fs from 'node:fs';
+import path from 'node:path';
 import { serializer } from '@lowdefy/helpers';
-import raw from '../../build/app.json';
+
+const raw = JSON.parse(fs.readFileSync(path.join(process.cwd(), 'build/app.json'), 'utf8'));
 
 export default serializer.deserialize(raw);

package/lib/build/appMeta.js

@@ -13,7 +13,14 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */
+
+// Build artifacts are read from disk because the Hono server runs as
+// unbundled Node.js ESM — JSON imports would need import attributes, and
+// client code imports the build JSON directly through Vite instead.
+import fs from 'node:fs';
+import path from 'node:path';
 import { serializer } from '@lowdefy/helpers';
-import raw from '../../build/appMeta.json';
+
+const raw = JSON.parse(fs.readFileSync(path.join(process.cwd(), 'build/appMeta.json'), 'utf8'));
 
 export default serializer.deserialize(raw);

package/lib/build/auth.js

@@ -13,7 +13,14 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */
+
+// Build artifacts are read from disk because the Hono server runs as
+// unbundled Node.js ESM — JSON imports would need import attributes, and
+// client code imports the build JSON directly through Vite instead.
+import fs from 'node:fs';
+import path from 'node:path';
 import { serializer } from '@lowdefy/helpers';
-import raw from '../../build/auth.json';
+
+const raw = JSON.parse(fs.readFileSync(path.join(process.cwd(), 'build/auth.json'), 'utf8'));
 
 export default serializer.deserialize(raw);

package/lib/build/config.js

@@ -13,7 +13,14 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */
+
+// Build artifacts are read from disk because the Hono server runs as
+// unbundled Node.js ESM — JSON imports would need import attributes, and
+// client code imports the build JSON directly through Vite instead.
+import fs from 'node:fs';
+import path from 'node:path';
 import { serializer } from '@lowdefy/helpers';
-import raw from '../../build/config.json';
+
+const raw = JSON.parse(fs.readFileSync(path.join(process.cwd(), 'build/config.json'), 'utf8'));
 
 export default serializer.deserialize(raw);

package/lib/build/i18n.js

@@ -13,7 +13,14 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */
+
+// Build artifacts are read from disk because the Hono server runs as
+// unbundled Node.js ESM — JSON imports would need import attributes, and
+// client code imports the build JSON directly through Vite instead.
+import fs from 'node:fs';
+import path from 'node:path';
 import { serializer } from '@lowdefy/helpers';
-import raw from '../../build/i18n.json';
+
+const raw = JSON.parse(fs.readFileSync(path.join(process.cwd(), 'build/i18n.json'), 'utf8'));
 
 export default serializer.deserialize(raw);

package/lib/build/logger.js

@@ -13,7 +13,14 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */
+
+// Build artifacts are read from disk because the Hono server runs as
+// unbundled Node.js ESM — JSON imports would need import attributes, and
+// client code imports the build JSON directly through Vite instead.
+import fs from 'node:fs';
+import path from 'node:path';
 import { serializer } from '@lowdefy/helpers';
-import raw from '../../build/logger.json';
+
+const raw = JSON.parse(fs.readFileSync(path.join(process.cwd(), 'build/logger.json'), 'utf8'));
 
 export default serializer.deserialize(raw);

package/lib/build/theme.js

@@ -13,7 +13,14 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */
+
+// Build artifacts are read from disk because the Hono server runs as
+// unbundled Node.js ESM — JSON imports would need import attributes, and
+// client code imports the build JSON directly through Vite instead.
+import fs from 'node:fs';
+import path from 'node:path';
 import { serializer } from '@lowdefy/helpers';
-import raw from '../../build/theme.json';
+
+const raw = JSON.parse(fs.readFileSync(path.join(process.cwd(), 'build/theme.json'), 'utf8'));
 
 export default serializer.deserialize(raw);

package/lib/client/auth/{Auth.js → Auth.jsx}

@@ -13,13 +13,22 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */
+
 /* eslint-disable react/jsx-props-no-spreading */
 
 import React from 'react';
-import AuthConfigured from './AuthConfigured.js';
+import AuthConfigured from './AuthConfigured.jsx';
 import AuthNotConfigured from './AuthNotConfigured.js';
 
-import authConfig from '../../build/auth.js';
+import { serializer } from '@lowdefy/helpers';
+
+// Client code imports the build JSON directly — Vite handles JSON imports;
+// the lib/build/*.js wrappers are server-only (they read from disk).
+// Deserialize to restore arrays from their ~arr build markers (providers
+// must be a real array for single-provider inference in createAuthMethods).
+import rawAuthConfig from '../../../build/auth.json';
+
+const authConfig = serializer.deserialize(rawAuthConfig);
 
 function Auth({ children, session }) {
   if (authConfig.configured === true) {

package/lib/client/auth/{AuthConfigured.js → AuthConfigured.jsx}

@@ -13,12 +13,30 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */
+
 /* eslint-disable react/jsx-props-no-spreading */
 
 import React, { useEffect, useRef } from 'react';
-import { getSession, SessionProvider, signIn, signOut, useSession } from 'next-auth/react';
+import {
+  authConfigManager,
+  getSession,
+  SessionProvider,
+  signIn,
+  signOut,
+  useSession,
+} from '@hono/auth-js/react';
+
+import { serializer } from '@lowdefy/helpers';
+
+import rawLowdefyConfig from '../../../build/config.json';
 
-import lowdefyConfig from '../../build/config.js';
+const lowdefyConfig = serializer.deserialize(rawLowdefyConfig);
+
+// @hono/auth-js/react configures its fetch paths through a module-level
+// manager instead of SessionProvider props.
+if (lowdefyConfig.basePath) {
+  authConfigManager.setConfig({ basePath: `${lowdefyConfig.basePath}/api/auth` });
+}
 
 function Session({ children }) {
   const wasAuthenticated = useRef(false);
@@ -31,9 +49,8 @@ function Session({ children }) {
     }
   }, [status]);
 
-  // If session is passed to SessionProvider from getServerSideProps
-  // we won't have a loading state here.
-  // But 404 uses getStaticProps so we have this for 404.
+  // If session is passed to SessionProvider from the server-rendered config
+  // we won't have a loading state here, but unauthenticated first loads do.
   if (status === 'loading') {
     return '';
   }
@@ -42,12 +59,8 @@ function Session({ children }) {
 
 function AuthConfigured({ authConfig, children, serverSession }) {
   const auth = { authConfig, getSession, signIn, signOut };
-  let basePath = lowdefyConfig.basePath;
-  if (basePath) {
-    basePath = `${basePath}/api/auth`;
-  }
   return (
-    <SessionProvider session={serverSession} basePath={basePath}>
+    <SessionProvider session={serverSession}>
       <Session>
         {(session) => {
           auth.session = session;

package/lib/client/setPageId.js

@@ -14,18 +14,19 @@
   limitations under the License.
 */
 
-function setPageId(router, rootConfig) {
-  if (router.pathname === `/404`) {
+// location comes from the custom router (@lowdefy/client/adapters):
+// { pageId, pathname, search }. pageId is null at the root path.
+function setPageId(location, rootConfig) {
+  if (location.pageId === '404') {
     return { redirect: false, pageId: '404' };
   }
-  const segments = router.query.pageId;
-  if (!segments || segments.length === 0) {
+  if (!location.pageId) {
     if (rootConfig.home.configured === false) {
       return { redirect: true, pageId: rootConfig.home.pageId };
     }
     return { redirect: false, pageId: rootConfig.home.pageId };
   }
-  return { redirect: false, pageId: segments.join('/') };
+  return { redirect: false, pageId: location.pageId };
 }
 
 export default setPageId;

package/lib/client/utils/usePageConfig.js

@@ -71,11 +71,6 @@ async function fetchPageConfig(url) {
   data._jsEntries = jsEntries;
   data._dynamicIcons = dynamicIcons;
 
-  // Bust CSS cache so the browser picks up newly compiled Tailwind classes
-  const cssLink = document.getElementById('tailwind-jit-css');
-  if (cssLink) {
-    cssLink.href = `${basePath}/tailwind-jit.css?v=${Date.now()}`;
-  }
 
   return data;
 }

package/lib/server/auth/{getAuthOptions.js → getAuthConfig.js}

@@ -14,17 +14,19 @@
   limitations under the License.
 */
 
-import { getNextAuthConfig } from '@lowdefy/api';
+import { getAuthConfig as getApiAuthConfig } from '@lowdefy/api';
 import { getSecretsFromEnv } from '@lowdefy/node-utils';
 
 import adapters from '../../../build/plugins/auth/adapters.js';
+import appMeta from '../../build/appMeta.js';
 import authJson from '../../build/auth.js';
 import callbacks from '../../../build/plugins/auth/callbacks.js';
 import events from '../../../build/plugins/auth/events.js';
 import providers from '../../../build/plugins/auth/providers.js';
 
-function getAuthOptions({ logger }) {
-  return getNextAuthConfig({
+function getAuthConfig({ logger }) {
+  return getApiAuthConfig({
+    appMeta,
     authJson,
     logger,
     plugins: { adapters, callbacks, events, providers },
@@ -32,4 +34,4 @@ function getAuthOptions({ logger }) {
   });
 }
 
-export default getAuthOptions;
+export default getAuthConfig;

package/lib/server/auth/{getServerSession.js → session.js}

@@ -14,22 +14,23 @@
   limitations under the License.
 */
 
-import { getServerSession as getNextAuthServerSession } from 'next-auth/next';
+import { getAuthUser } from '@hono/auth-js';
 
 import authJson from '../../build/auth.js';
 import getMockSession from './getMockSession.js';
 
-async function getServerSession({ authOptions, req, res }) {
-  // Check for mock user first (dev server only)
+// Replaces getServerSession.js — mock user first (dev only), then the
+// session from the Hono context populated by initAuthConfig.
+async function getSession(c) {
   const mockSession = await getMockSession();
   if (mockSession) {
     return mockSession;
   }
-
-  if (authJson.configured === true) {
-    return getNextAuthServerSession(req, res, authOptions);
+  if (authJson.configured !== true) {
+    return undefined;
   }
-  return undefined;
+  const authUser = await getAuthUser(c);
+  return authUser?.session ?? undefined;
 }
 
-export default getServerSession;
+export default getSession;

package/lib/server/jitPageBuilder.js

@@ -19,9 +19,9 @@ import path from 'path';
 import { serializer } from '@lowdefy/helpers';
 import { buildPageJit, createContext, makeId } from '@lowdefy/build/dev';
 
-import compileCss from './compileCss.js';
 import createLogger from './log/createLogger.js';
 import PageCache from './pageCache.mjs';
+import readBuildApiArtifacts from './readBuildApiArtifacts.mjs';
 
 const jitLogger = createLogger({ name: 'jit-build' });
 
@@ -35,10 +35,10 @@ let cachedRegistry = null;
 let cachedBuildContext = null;
 let lastInvalidationMtime = null;
 
-// Frozen snapshot of icon imports from the initial build (what's actually in the Next.js bundle).
+// Frozen snapshot of icon imports from the initial build (what's actually in the client bundle).
 // Module-level so it persists across context resets (skeleton rebuilds update iconImports.json
-// with newly discovered icons, but those aren't in the bundle until the next nextBuild).
-// Only resets when the server process restarts (which happens after every nextBuild).
+// with newly discovered icons, but those aren't in the bundle until a server restart).
+// Only resets when the server process restarts.
 let bundledIconImports = null;
 
 function readJsonFile(filePath) {
@@ -128,10 +128,15 @@ function getBuildContext(buildDirectory, configDirectory) {
     Object.assign(cachedBuildContext.modules, modules);
   }
 
+  // Restore api endpoint configs so JIT CallAPI validation (validateCallApiRefs in
+  // buildPageJit) can resolve endpointIds. Without this the dev context has no
+  // components.api and every CallAPI action is flagged as a non-existent endpoint.
+  cachedBuildContext.components = { api: readBuildApiArtifacts(buildDirectory) };
+
   // Use the frozen icon imports from the initial build for JIT detection.
-  // This represents what's actually in the Next.js bundle — not what shallowBuild
+  // This represents what's actually in the client bundle — not what shallowBuild
   // discovers on subsequent rebuilds (those icons aren't bundled yet).
-  // bundledIconImports is module-level and only resets on server restart (after nextBuild).
+  // bundledIconImports is module-level and only resets on server restart.
   if (!bundledIconImports) {
     bundledIconImports = readJsonFile(path.join(buildDirectory, 'iconImports.json')) ?? [];
   }
@@ -184,7 +189,12 @@ async function buildPageIfNeeded({ pageId, buildDirectory, configDirectory }) {
       return result;
     }
     pageCache.markCompiled(pageId);
-    await compileCss(buildDirectory);
+    // Touch the candidates file so Vite's CSS pipeline re-runs Tailwind for
+    // classes the JIT build discovered — globals.css imports it.
+    fs.writeFileSync(
+      path.join(buildDirectory, 'tailwind-candidates.css'),
+      `/* Generated by Lowdefy build — rewritten on page changes to trigger CSS recompilation */\n/* ${Date.now()} */\n`
+    );
     jitLogger.info(
       { spin: 'succeed', color: 'white' },
       `Built page "${pageId}" in ${formatDuration(Date.now() - startTime)}.`