veryfront 0.1.84 → 0.1.86

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.84",
+    "version": "0.1.86",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "exclude": [

package/esm/src/platform/adapters/fs/veryfront/adapter.d.ts

@@ -12,6 +12,9 @@ export declare class VeryfrontFSAdapter implements FSAdapter {
     private initialized;
     /** Resolves when file list initialization is complete (for coordinating reads) */
     private fileListReadyResolve;
+    /** Single-flight background rewarm when the file list cache disappears */
+    private fileListWarmupPromise;
+    private fileListWarmupKey;
     private projectData?;
     private apiBaseUrl;
     private apiToken;
@@ -29,6 +32,7 @@ export declare class VeryfrontFSAdapter implements FSAdapter {
     constructor(config: FSAdapterConfig);
     initialize(): Promise<void>;
     private isPersistentCacheInvalidated;
+    private scheduleFileListWarmup;
     getPokeMetrics(): {
         received: number;
         invalidationsTriggered: number;

package/esm/src/platform/adapters/fs/veryfront/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/adapter.ts"],"names":[],"mappings":"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"}

package/esm/src/platform/adapters/fs/veryfront/adapter.js

@@ -27,6 +27,9 @@ export class VeryfrontFSAdapter {
     initialized = false;
     /** Resolves when file list initialization is complete (for coordinating reads) */
     fileListReadyResolve = null;
+    /** Single-flight background rewarm when the file list cache disappears */
+    fileListWarmupPromise = null;
+    fileListWarmupKey = null;
     projectData;
     apiBaseUrl;
     apiToken;
@@ -94,6 +97,9 @@ export class VeryfrontFSAdapter {
                     hasResult: !!result,
                     resultSize: result?.length ?? 0,
                 });
+                if (!result?.length) {
+                    this.scheduleFileListWarmup("getFileList miss", cacheKey);
+                }
                 return result;
             },
             hasCachedFileList: async () => {
@@ -109,6 +115,9 @@ export class VeryfrontFSAdapter {
                     hasResult,
                     resultSize: result?.length ?? 0,
                 });
+                if (!hasResult) {
+                    this.scheduleFileListWarmup("hasCachedFileList miss", cacheKey);
+                }
                 return hasResult;
             },
             isPersistentCacheInvalidated: (prefix) => this.isPersistentCacheInvalidated(prefix),
@@ -132,6 +141,9 @@ export class VeryfrontFSAdapter {
                 resultSize: result?.length ?? 0,
                 hasContent: result?.filter((f) => f.content)?.length ?? 0,
             });
+            if (!result?.length) {
+                this.scheduleFileListWarmup("getFileListCache miss", cacheKey);
+            }
             return result;
         });
         this.dirOps = new DirectoryOperations(this.client, this.cache, this.normalizer, contentContextGetter);
@@ -280,6 +292,65 @@ export class VeryfrontFSAdapter {
     isPersistentCacheInvalidated(prefix) {
         return isPrefixBeingInvalidated(prefix);
     }
+    scheduleFileListWarmup(reason, cacheKey) {
+        if (!this.initialized || !this.contentContext)
+            return;
+        const effectiveCacheKey = cacheKey ?? buildFileListCacheKey(this.contentContext);
+        if (this.fileListWarmupPromise && this.fileListWarmupKey === effectiveCacheKey) {
+            logger.debug("File list warmup already in progress", {
+                reason,
+                cacheKey: effectiveCacheKey,
+            });
+            return;
+        }
+        const warmupContext = this.contentContext;
+        let warmupPromise = null;
+        warmupPromise = (async () => {
+            try {
+                const existing = await this.cache.getAsync(effectiveCacheKey);
+                if (existing?.length) {
+                    logger.debug("Skipping file list warmup because cache is already populated", {
+                        reason,
+                        cacheKey: effectiveCacheKey,
+                        fileCount: existing.length,
+                    });
+                    return;
+                }
+                logger.debug("Starting file list warmup", {
+                    reason,
+                    cacheKey: effectiveCacheKey,
+                    sourceType: warmupContext.sourceType,
+                    branch: warmupContext.branch,
+                    environmentName: warmupContext.environmentName,
+                    releaseId: warmupContext.releaseId,
+                });
+                const files = await fetchFileListForContext(this.client, warmupContext);
+                await this.cache.setAsync(effectiveCacheKey, files);
+                logger.debug("File list warmup complete", {
+                    reason,
+                    cacheKey: effectiveCacheKey,
+                    totalFiles: files.length,
+                    filesWithContent: files.filter((file) => file.content).length,
+                });
+            }
+            catch (error) {
+                logger.warn("File list warmup failed", {
+                    reason,
+                    cacheKey: effectiveCacheKey,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+            finally {
+                if (warmupPromise && this.fileListWarmupPromise === warmupPromise) {
+                    this.fileListWarmupPromise = null;
+                    this.fileListWarmupKey = null;
+                }
+            }
+        })();
+        this.fileListWarmupPromise = warmupPromise;
+        this.fileListWarmupKey = effectiveCacheKey;
+        this.readOps.setFileListReadyPromise(warmupPromise);
+    }
     getPokeMetrics() {
         return this.wsManager.getPokeMetrics();
     }
@@ -317,6 +388,8 @@ export class VeryfrontFSAdapter {
         this.statOps.clearIndex();
         this.dirOps.clearTree();
         this.initialized = false;
+        this.fileListWarmupPromise = null;
+        this.fileListWarmupKey = null;
         logger.debug("Disposed");
     }
     getCacheStats() {
@@ -342,6 +415,7 @@ export class VeryfrontFSAdapter {
                 hasFiles: !!files,
                 fileCount: files?.length ?? 0,
             });
+            this.scheduleFileListWarmup("getAllSourceFiles miss", cacheKey);
             return [];
         }
         const fileSummary = summarizeFileList(files);
@@ -429,6 +503,8 @@ export class VeryfrontFSAdapter {
         if (contextChanged) {
             this.statOps.clearIndex();
             this.dirOps.clearTree();
+            this.fileListWarmupPromise = null;
+            this.fileListWarmupKey = null;
             logger.debug("Cleared index and dirTree due to context change", {
                 oldContext,
                 newContext: context,

package/esm/src/rendering/orchestrator/css-candidate-manifest.d.ts

@@ -11,10 +11,21 @@ interface RouteCandidateOptions {
     files: SourceFileLike[];
     developmentMode: boolean;
 }
+interface ProjectCandidateOptions {
+    projectScope: string;
+    projectVersion: string;
+    projectDir: string;
+    files: SourceFileLike[];
+    developmentMode: boolean;
+}
 /**
  * Resolve route-scoped Tailwind candidates from a precomputed per-project manifest.
  */
 export declare function getRouteCandidates(options: RouteCandidateOptions): Set<string>;
+/**
+ * Resolve full-project Tailwind candidates from a precomputed per-project manifest.
+ */
+export declare function getProjectCandidates(options: ProjectCandidateOptions): Set<string>;
 /**
  * Invalidate cached candidate manifests for one project scope (or all scopes).
  */

package/esm/src/rendering/orchestrator/css-candidate-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"css-candidate-manifest.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/orchestrator/css-candidate-manifest.ts"],"names":[],"mappings":"AAIA,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAQD,UAAU,qBAAqB;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAmFD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,qBAAqB,GAAG,GAAG,CAAC,MAAM,CAAC,CA+C9E;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAc/E"}
+{"version":3,"file":"css-candidate-manifest.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/orchestrator/css-candidate-manifest.ts"],"names":[],"mappings":"AAIA,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAQD,UAAU,qBAAqB;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,UAAU,uBAAuB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B;AA0GD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,qBAAqB,GAAG,GAAG,CAAC,MAAM,CAAC,CAkC9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,GAAG,CAAC,MAAM,CAAC,CAGlF;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAc/E"}

package/esm/src/rendering/orchestrator/css-candidate-manifest.js

@@ -58,6 +58,21 @@ function buildCandidateManifest(files, projectDir) {
     }
     return { fileCandidates, allCandidates, builtAt: Date.now() };
 }
+function getOrBuildManifest(options) {
+    const manifestKey = buildManifestCacheKey(options.projectScope, options.projectVersion);
+    const existingManifest = manifestCache.get(manifestKey);
+    const manifest = shouldRebuildManifest(existingManifest, options.developmentMode)
+        ? buildCandidateManifest(options.files, options.projectDir)
+        : existingManifest;
+    if (manifest !== existingManifest) {
+        manifestCache.set(manifestKey, manifest);
+        for (const key of routeCandidateCache.keys()) {
+            if (key.startsWith(`${manifestKey}:`))
+                routeCandidateCache.delete(key);
+        }
+    }
+    return manifest;
+}
 function addCandidatesForPath(target, manifest, path, projectDir) {
     const absolutePath = normalizePath(path);
     const relativePath = toRelativeProjectPath(path, projectDir);
@@ -73,18 +88,7 @@ function addCandidatesForPath(target, manifest, path, projectDir) {
  */
 export function getRouteCandidates(options) {
     const manifestKey = buildManifestCacheKey(options.projectScope, options.projectVersion);
-    const existingManifest = manifestCache.get(manifestKey);
-    const manifest = shouldRebuildManifest(existingManifest, options.developmentMode)
-        ? buildCandidateManifest(options.files, options.projectDir)
-        : existingManifest;
-    if (manifest !== existingManifest) {
-        manifestCache.set(manifestKey, manifest);
-        // Clear route subsets when project-level file manifest is rebuilt.
-        for (const key of routeCandidateCache.keys()) {
-            if (key.startsWith(`${manifestKey}:`))
-                routeCandidateCache.delete(key);
-        }
-    }
+    const manifest = getOrBuildManifest(options);
     const routeCacheKey = `${manifestKey}:${options.routeKey}`;
     const cachedRoute = routeCandidateCache.get(routeCacheKey);
     if (cachedRoute)
@@ -112,6 +116,13 @@ export function getRouteCandidates(options) {
     });
     return new Set(routeCandidates);
 }
+/**
+ * Resolve full-project Tailwind candidates from a precomputed per-project manifest.
+ */
+export function getProjectCandidates(options) {
+    const manifest = getOrBuildManifest(options);
+    return new Set(manifest.allCandidates);
+}
 /**
  * Invalidate cached candidate manifests for one project scope (or all scopes).
  */

package/esm/src/server/handlers/dev/styles-candidate-scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles-candidate-scanner.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/dev/styles-candidate-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAWlD;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAqCxF"}
+{"version":3,"file":"styles-candidate-scanner.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/dev/styles-candidate-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA8BlD;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CA0CxF"}

package/esm/src/server/handlers/dev/styles-candidate-scanner.js

@@ -11,12 +11,26 @@ import { extractCandidates } from "../../../html/styles-builder/tailwind-compile
 import { serverLogger } from "../../../utils/index.js";
 import { createFileSystem } from "../../../platform/compat/fs.js";
 import { join } from "../../../platform/compat/path/index.js";
+import { getProjectCandidates } from "../../../rendering/orchestrator/css-candidate-manifest.js";
 import { FRAMEWORK_CANDIDATES } from "./framework-candidates.generated.js";
 const logger = serverLogger.component("styles-candidate-scanner");
 const SOURCE_EXTENSIONS = [".tsx", ".jsx", ".mdx", ".ts", ".js"];
 const SKIP_DIRS = new Set(["node_modules", ".cache", ".git", "dist", "build", ".vscode"]);
 /** De-duplicated set of framework candidates, computed once at import time. */
 const frameworkCandidates = new Set(FRAMEWORK_CANDIDATES);
+function resolveProjectVersion(ctx, contentContext) {
+    if (contentContext?.releaseId)
+        return `release:${contentContext.releaseId}`;
+    if (contentContext?.branch)
+        return `branch:${contentContext.branch}`;
+    if (contentContext?.environmentName)
+        return `environment:${contentContext.environmentName}`;
+    if (ctx.releaseId)
+        return `release:${ctx.releaseId}`;
+    if (ctx.parsedDomain?.branch)
+        return `branch:${ctx.parsedDomain.branch}`;
+    return "live";
+}
 /**
  * Extract Tailwind CSS candidate class names from all project source files.
  *
@@ -38,14 +52,17 @@ export async function extractProjectCandidates(ctx) {
     }
     const candidates = new Set(frameworkCandidates);
     const files = await fsAdapter.getAllSourceFiles();
-    for (const file of files) {
-        if (!file.content)
-            continue;
-        if (!SOURCE_EXTENSIONS.some((ext) => file.path.endsWith(ext)))
-            continue;
-        for (const cls of extractCandidates(file.content)) {
-            candidates.add(cls);
-        }
+    const contentContext = typeof fsAdapter.getContentContext === "function"
+        ? fsAdapter.getContentContext()
+        : null;
+    for (const cls of getProjectCandidates({
+        projectScope: ctx.projectSlug ?? contentContext?.projectSlug ?? ctx.projectDir,
+        projectVersion: resolveProjectVersion(ctx, contentContext),
+        projectDir: ctx.projectDir,
+        files,
+        developmentMode: contentContext?.sourceType === "branch",
+    })) {
+        candidates.add(cls);
     }
     return candidates;
 }

package/esm/src/server/handlers/dev/styles-css.handler.d.ts

@@ -11,5 +11,6 @@ export declare class StylesCSSHandler extends BaseHandler {
     metadata: HandlerMetadata;
     handle(req: dntShim.Request, ctx: HandlerContext): Promise<HandlerResult>;
     private loadStylesheet;
+    private generateStylesheet;
 }
 //# sourceMappingURL=styles-css.handler.d.ts.map

package/esm/src/server/handlers/dev/styles-css.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles-css.handler.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/dev/styles-css.handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,OAAO,MAAM,2BAA2B,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AAanG,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,QAAQ,EAAE,eAAe,CAKvB;IAEI,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;YAkGjE,cAAc;CAiB7B"}
+{"version":3,"file":"styles-css.handler.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/dev/styles-css.handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,OAAO,MAAM,2BAA2B,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AAkBnG,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,QAAQ,EAAE,eAAe,CAKvB;IAEI,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;YAkGjE,cAAc;IAkB5B,OAAO,CAAC,kBAAkB;CAe3B"}

package/esm/src/server/handlers/dev/styles-css.handler.js

@@ -1,7 +1,7 @@
 import { BaseHandler } from "../response/base.js";
 import { HTTP_OK, PRIORITY_HIGH_DEV } from "../../../utils/constants/index.js";
 import { joinPath } from "../../../utils/path-utils.js";
-import { formatCSSError, generateTailwindCSS, } from "../../../html/styles-builder/tailwind-compiler.js";
+import { formatCSSError, generateTailwindCSS, getProjectCSS, } from "../../../html/styles-builder/tailwind-compiler.js";
 import { DEFAULT_STYLESHEET } from "../../../html/styles-builder/css-hash-cache.js";
 import { serverLogger } from "../../../utils/index.js";
 import { extractProjectCandidates } from "./styles-candidate-scanner.js";
@@ -39,10 +39,8 @@ export class StylesCSSHandler extends BaseHandler {
                     });
                     candidates = new Set();
                 }
-                const result = await generateTailwindCSS(rawCss, candidates, {
-                    projectSlug: ctx.projectSlug,
-                });
-                if (result.error) {
+                const result = await this.generateStylesheet(ctx, rawCss, candidates);
+                if ("error" in result && result.error) {
                     const formatted = formatCSSError(result.error);
                     logger.error("Tailwind error", {
                         error: formatted.message,
@@ -82,6 +80,8 @@ body::before {
                 logger.debug("CSS generated", {
                     candidates: candidates.size,
                     cssLength: result.css.length,
+                    fromCache: "fromCache" in result ? result.fromCache : false,
+                    cssHash: "hash" in result ? result.hash : undefined,
                 });
                 return this.respond(responseBuilder.withContentType("text/css; charset=utf-8", result.css, HTTP_OK));
             });
@@ -114,4 +114,14 @@ body::before {
             return DEFAULT_STYLESHEET;
         }
     }
+    generateStylesheet(ctx, rawCss, candidates) {
+        if (!ctx.projectSlug) {
+            return generateTailwindCSS(rawCss, candidates);
+        }
+        return getProjectCSS(ctx.projectSlug, rawCss, candidates, {
+            minify: true,
+            environment: "preview",
+            buildMode: "production",
+        });
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.84",
+  "version": "0.1.86",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.84",
+  "version": "0.1.86",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "exclude": [

package/src/src/platform/adapters/fs/veryfront/adapter.ts

@@ -49,6 +49,9 @@ export class VeryfrontFSAdapter implements FSAdapter {
 
   /** Resolves when file list initialization is complete (for coordinating reads) */
   private fileListReadyResolve: (() => void) | null = null;
+  /** Single-flight background rewarm when the file list cache disappears */
+  private fileListWarmupPromise: Promise<void> | null = null;
+  private fileListWarmupKey: string | null = null;
 
   private projectData?: Project;
   private apiBaseUrl: string;
@@ -140,6 +143,10 @@ export class VeryfrontFSAdapter implements FSAdapter {
           resultSize: result?.length ?? 0,
         });
 
+        if (!result?.length) {
+          this.scheduleFileListWarmup("getFileList miss", cacheKey);
+        }
+
         return result;
       },
       hasCachedFileList: async () => {
@@ -158,6 +165,10 @@ export class VeryfrontFSAdapter implements FSAdapter {
           resultSize: result?.length ?? 0,
         });
 
+        if (!hasResult) {
+          this.scheduleFileListWarmup("hasCachedFileList miss", cacheKey);
+        }
+
         return hasResult;
       },
       isPersistentCacheInvalidated: (prefix: string) => this.isPersistentCacheInvalidated(prefix),
@@ -202,6 +213,10 @@ export class VeryfrontFSAdapter implements FSAdapter {
           hasContent: result?.filter((f) => f.content)?.length ?? 0,
         });
 
+        if (!result?.length) {
+          this.scheduleFileListWarmup("getFileListCache miss", cacheKey);
+        }
+
         return result;
       },
     );
@@ -389,6 +404,73 @@ export class VeryfrontFSAdapter implements FSAdapter {
     return isPrefixBeingInvalidated(prefix);
   }
 
+  private scheduleFileListWarmup(reason: string, cacheKey?: string): void {
+    if (!this.initialized || !this.contentContext) return;
+
+    const effectiveCacheKey = cacheKey ?? buildFileListCacheKey(this.contentContext);
+
+    if (this.fileListWarmupPromise && this.fileListWarmupKey === effectiveCacheKey) {
+      logger.debug("File list warmup already in progress", {
+        reason,
+        cacheKey: effectiveCacheKey,
+      });
+      return;
+    }
+
+    const warmupContext = this.contentContext;
+    let warmupPromise: Promise<void> | null = null;
+    warmupPromise = (async () => {
+      try {
+        const existing = await this.cache.getAsync<Array<{ path: string; content?: string }>>(
+          effectiveCacheKey,
+        );
+
+        if (existing?.length) {
+          logger.debug("Skipping file list warmup because cache is already populated", {
+            reason,
+            cacheKey: effectiveCacheKey,
+            fileCount: existing.length,
+          });
+          return;
+        }
+
+        logger.debug("Starting file list warmup", {
+          reason,
+          cacheKey: effectiveCacheKey,
+          sourceType: warmupContext.sourceType,
+          branch: warmupContext.branch,
+          environmentName: warmupContext.environmentName,
+          releaseId: warmupContext.releaseId,
+        });
+
+        const files = await fetchFileListForContext(this.client, warmupContext);
+        await this.cache.setAsync(effectiveCacheKey, files);
+
+        logger.debug("File list warmup complete", {
+          reason,
+          cacheKey: effectiveCacheKey,
+          totalFiles: files.length,
+          filesWithContent: files.filter((file) => file.content).length,
+        });
+      } catch (error) {
+        logger.warn("File list warmup failed", {
+          reason,
+          cacheKey: effectiveCacheKey,
+          error: error instanceof Error ? error.message : String(error),
+        });
+      } finally {
+        if (warmupPromise && this.fileListWarmupPromise === warmupPromise) {
+          this.fileListWarmupPromise = null;
+          this.fileListWarmupKey = null;
+        }
+      }
+    })();
+
+    this.fileListWarmupPromise = warmupPromise;
+    this.fileListWarmupKey = effectiveCacheKey;
+    this.readOps.setFileListReadyPromise(warmupPromise);
+  }
+
   getPokeMetrics(): {
     received: number;
     invalidationsTriggered: number;
@@ -442,6 +524,8 @@ export class VeryfrontFSAdapter implements FSAdapter {
     this.statOps.clearIndex();
     this.dirOps.clearTree();
     this.initialized = false;
+    this.fileListWarmupPromise = null;
+    this.fileListWarmupKey = null;
 
     logger.debug("Disposed");
   }
@@ -473,6 +557,7 @@ export class VeryfrontFSAdapter implements FSAdapter {
         hasFiles: !!files,
         fileCount: files?.length ?? 0,
       });
+      this.scheduleFileListWarmup("getAllSourceFiles miss", cacheKey);
       return [];
     }
 
@@ -584,6 +669,8 @@ export class VeryfrontFSAdapter implements FSAdapter {
     if (contextChanged) {
       this.statOps.clearIndex();
       this.dirOps.clearTree();
+      this.fileListWarmupPromise = null;
+      this.fileListWarmupKey = null;
       logger.debug("Cleared index and dirTree due to context change", {
         oldContext,
         newContext: context,

package/src/src/rendering/orchestrator/css-candidate-manifest.ts

@@ -23,6 +23,14 @@ interface RouteCandidateOptions {
   developmentMode: boolean;
 }
 
+interface ProjectCandidateOptions {
+  projectScope: string;
+  projectVersion: string;
+  projectDir: string;
+  files: SourceFileLike[];
+  developmentMode: boolean;
+}
+
 const logger = rendererLogger.component("css-candidate-manifest");
 const SOURCE_EXTENSIONS = [".tsx", ".jsx", ".mdx", ".ts", ".js"];
 const DEV_MANIFEST_TTL_MS = 2_000;
@@ -90,6 +98,29 @@ function buildCandidateManifest(files: SourceFileLike[], projectDir: string): Ca
   return { fileCandidates, allCandidates, builtAt: Date.now() };
 }
 
+function getOrBuildManifest(
+  options: Pick<
+    ProjectCandidateOptions,
+    "projectScope" | "projectVersion" | "projectDir" | "files" | "developmentMode"
+  >,
+): CandidateManifest {
+  const manifestKey = buildManifestCacheKey(options.projectScope, options.projectVersion);
+  const existingManifest = manifestCache.get(manifestKey);
+  const manifest = shouldRebuildManifest(existingManifest, options.developmentMode)
+    ? buildCandidateManifest(options.files, options.projectDir)
+    : existingManifest!;
+
+  if (manifest !== existingManifest) {
+    manifestCache.set(manifestKey, manifest);
+
+    for (const key of routeCandidateCache.keys()) {
+      if (key.startsWith(`${manifestKey}:`)) routeCandidateCache.delete(key);
+    }
+  }
+
+  return manifest;
+}
+
 function addCandidatesForPath(
   target: Set<string>,
   manifest: CandidateManifest,
@@ -109,20 +140,7 @@ function addCandidatesForPath(
  */
 export function getRouteCandidates(options: RouteCandidateOptions): Set<string> {
   const manifestKey = buildManifestCacheKey(options.projectScope, options.projectVersion);
-  const existingManifest = manifestCache.get(manifestKey);
-  const manifest = shouldRebuildManifest(existingManifest, options.developmentMode)
-    ? buildCandidateManifest(options.files, options.projectDir)
-    : existingManifest!;
-
-  if (manifest !== existingManifest) {
-    manifestCache.set(manifestKey, manifest);
-
-    // Clear route subsets when project-level file manifest is rebuilt.
-    for (const key of routeCandidateCache.keys()) {
-      if (key.startsWith(`${manifestKey}:`)) routeCandidateCache.delete(key);
-    }
-  }
-
+  const manifest = getOrBuildManifest(options);
   const routeCacheKey = `${manifestKey}:${options.routeKey}`;
   const cachedRoute = routeCandidateCache.get(routeCacheKey);
   if (cachedRoute) return new Set(cachedRoute);
@@ -156,6 +174,14 @@ export function getRouteCandidates(options: RouteCandidateOptions): Set<string>
   return new Set(routeCandidates);
 }
 
+/**
+ * Resolve full-project Tailwind candidates from a precomputed per-project manifest.
+ */
+export function getProjectCandidates(options: ProjectCandidateOptions): Set<string> {
+  const manifest = getOrBuildManifest(options);
+  return new Set(manifest.allCandidates);
+}
+
 /**
  * Invalidate cached candidate manifests for one project scope (or all scopes).
  */

package/src/src/server/handlers/dev/styles-candidate-scanner.ts

@@ -12,6 +12,8 @@ import { extractCandidates } from "../../../html/styles-builder/tailwind-compile
 import { serverLogger } from "../../../utils/index.js";
 import { createFileSystem } from "../../../platform/compat/fs.js";
 import { join } from "../../../platform/compat/path/index.js";
+import { getProjectCandidates } from "../../../rendering/orchestrator/css-candidate-manifest.js";
+import type { ResolvedContentContext } from "../../../platform/adapters/fs/veryfront/types.js";
 import type { HandlerContext } from "../types.js";
 import { FRAMEWORK_CANDIDATES } from "./framework-candidates.generated.js";
 
@@ -23,6 +25,25 @@ const SKIP_DIRS = new Set(["node_modules", ".cache", ".git", "dist", "build", ".
 /** De-duplicated set of framework candidates, computed once at import time. */
 const frameworkCandidates = new Set<string>(FRAMEWORK_CANDIDATES);
 
+interface SourceFileProvider {
+  getAllSourceFiles?: () =>
+    | Array<{ path: string; content?: string }>
+    | Promise<Array<{ path: string; content?: string }>>;
+  getContentContext?: () => ResolvedContentContext | null;
+}
+
+function resolveProjectVersion(
+  ctx: HandlerContext,
+  contentContext: ResolvedContentContext | null,
+): string {
+  if (contentContext?.releaseId) return `release:${contentContext.releaseId}`;
+  if (contentContext?.branch) return `branch:${contentContext.branch}`;
+  if (contentContext?.environmentName) return `environment:${contentContext.environmentName}`;
+  if (ctx.releaseId) return `release:${ctx.releaseId}`;
+  if (ctx.parsedDomain?.branch) return `branch:${ctx.parsedDomain.branch}`;
+  return "live";
+}
+
 /**
  * Extract Tailwind CSS candidate class names from all project source files.
  *
@@ -42,9 +63,8 @@ export async function extractProjectCandidates(ctx: HandlerContext): Promise<Set
 
   // Call method directly on wrappedFs to preserve 'this' context
   const fsAdapter = wrappedFs.getUnderlyingAdapter() as {
-    getAllSourceFiles?: () =>
-      | Array<{ path: string; content?: string }>
-      | Promise<Array<{ path: string; content?: string }>>;
+    getAllSourceFiles?: SourceFileProvider["getAllSourceFiles"];
+    getContentContext?: SourceFileProvider["getContentContext"];
   };
 
   if (typeof fsAdapter.getAllSourceFiles !== "function") {
@@ -56,14 +76,20 @@ export async function extractProjectCandidates(ctx: HandlerContext): Promise<Set
 
   const candidates = new Set<string>(frameworkCandidates);
   const files = await fsAdapter.getAllSourceFiles();
-
-  for (const file of files) {
-    if (!file.content) continue;
-    if (!SOURCE_EXTENSIONS.some((ext) => file.path.endsWith(ext))) continue;
-
-    for (const cls of extractCandidates(file.content)) {
-      candidates.add(cls);
-    }
+  const contentContext = typeof fsAdapter.getContentContext === "function"
+    ? fsAdapter.getContentContext()
+    : null;
+
+  for (
+    const cls of getProjectCandidates({
+      projectScope: ctx.projectSlug ?? contentContext?.projectSlug ?? ctx.projectDir,
+      projectVersion: resolveProjectVersion(ctx, contentContext),
+      projectDir: ctx.projectDir,
+      files,
+      developmentMode: contentContext?.sourceType === "branch",
+    })
+  ) {
+    candidates.add(cls);
   }
 
   return candidates;

package/src/src/server/handlers/dev/styles-css.handler.ts

@@ -14,6 +14,7 @@ import { joinPath } from "../../../utils/path-utils.js";
 import {
   formatCSSError,
   generateTailwindCSS,
+  getProjectCSS,
 } from "../../../html/styles-builder/tailwind-compiler.js";
 import { DEFAULT_STYLESHEET } from "../../../html/styles-builder/css-hash-cache.js";
 import { serverLogger } from "../../../utils/index.js";
@@ -21,6 +22,10 @@ import { extractProjectCandidates } from "./styles-candidate-scanner.js";
 
 const logger = serverLogger.component("styles-css-handler");
 
+type GeneratedStylesResult =
+  | Awaited<ReturnType<typeof generateTailwindCSS>>
+  | Awaited<ReturnType<typeof getProjectCSS>>;
+
 export class StylesCSSHandler extends BaseHandler {
   metadata: HandlerMetadata = {
     name: "StylesCSSHandler",
@@ -54,11 +59,9 @@ export class StylesCSSHandler extends BaseHandler {
           });
           candidates = new Set<string>();
         }
-        const result = await generateTailwindCSS(rawCss, candidates, {
-          projectSlug: ctx.projectSlug,
-        });
+        const result = await this.generateStylesheet(ctx, rawCss, candidates);
 
-        if (result.error) {
+        if ("error" in result && result.error) {
           const formatted = formatCSSError(result.error);
           logger.error("Tailwind error", {
             error: formatted.message,
@@ -104,6 +107,8 @@ body::before {
         logger.debug("CSS generated", {
           candidates: candidates.size,
           cssLength: result.css.length,
+          fromCache: "fromCache" in result ? result.fromCache : false,
+          cssHash: "hash" in result ? result.hash : undefined,
         });
 
         return this.respond(
@@ -144,4 +149,20 @@ body::before {
       return DEFAULT_STYLESHEET;
     }
   }
+
+  private generateStylesheet(
+    ctx: HandlerContext,
+    rawCss: string,
+    candidates: Set<string>,
+  ): Promise<GeneratedStylesResult> {
+    if (!ctx.projectSlug) {
+      return generateTailwindCSS(rawCss, candidates);
+    }
+
+    return getProjectCSS(ctx.projectSlug, rawCss, candidates, {
+      minify: true,
+      environment: "preview",
+      buildMode: "production",
+    });
+  }
 }