@nx/angular 0.0.0-pr-22179-271588f

package/src/generators/setup-ssr/lib/generate-server-ts-config.d.ts

@@ -0,0 +1,4 @@
+import { type Tree } from '@nx/devkit';
+import type { Schema } from '../schema';
+export declare function setServerTsConfigOptionsForApplicationBuilder(tree: Tree, options: Schema): void;
+export declare function generateTsConfigServerJsonForBrowserBuilder(tree: Tree, options: Schema): void;

package/src/generators/setup-ssr/lib/generate-server-ts-config.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTsConfigServerJsonForBrowserBuilder = exports.setServerTsConfigOptionsForApplicationBuilder = void 0;
+const devkit_1 = require("@nx/devkit");
+const path_1 = require("path");
+function setServerTsConfigOptionsForApplicationBuilder(tree, options) {
+    const { targets } = (0, devkit_1.readProjectConfiguration)(tree, options.project);
+    const tsConfigPath = targets.build.options.tsConfig;
+    (0, devkit_1.updateJson)(tree, tsConfigPath, (json) => {
+        const files = new Set(json.files ?? []);
+        files.add((0, devkit_1.joinPathFragments)('src', options.main));
+        files.add((0, devkit_1.joinPathFragments)(options.serverFileName));
+        json.files = Array.from(files);
+        json.compilerOptions ??= {};
+        const types = new Set(json.compilerOptions.types ?? []);
+        types.add('node');
+        json.compilerOptions.types = Array.from(types);
+        return json;
+    });
+}
+exports.setServerTsConfigOptionsForApplicationBuilder = setServerTsConfigOptionsForApplicationBuilder;
+function generateTsConfigServerJsonForBrowserBuilder(tree, options) {
+    const { root } = (0, devkit_1.readProjectConfiguration)(tree, options.project);
+    (0, devkit_1.generateFiles)(tree, (0, path_1.join)(__dirname, '..', 'files', 'root'), root, {
+        ...options,
+        tpl: '',
+    });
+}
+exports.generateTsConfigServerJsonForBrowserBuilder = generateTsConfigServerJsonForBrowserBuilder;

package/src/generators/setup-ssr/lib/index.d.ts

@@ -0,0 +1,10 @@
+export * from './add-dependencies';
+export * from './add-server-file';
+export * from './generate-files';
+export * from './generate-server-ts-config';
+export * from './normalize-options';
+export * from './update-app-module';
+export * from './update-project-config';
+export * from './validate-options';
+export * from './add-hydration';
+export * from './set-router-initial-navigation';

package/src/generators/setup-ssr/lib/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./add-dependencies"), exports);
+tslib_1.__exportStar(require("./add-server-file"), exports);
+tslib_1.__exportStar(require("./generate-files"), exports);
+tslib_1.__exportStar(require("./generate-server-ts-config"), exports);
+tslib_1.__exportStar(require("./normalize-options"), exports);
+tslib_1.__exportStar(require("./update-app-module"), exports);
+tslib_1.__exportStar(require("./update-project-config"), exports);
+tslib_1.__exportStar(require("./validate-options"), exports);
+tslib_1.__exportStar(require("./add-hydration"), exports);
+tslib_1.__exportStar(require("./set-router-initial-navigation"), exports);

package/src/generators/setup-ssr/lib/normalize-options.d.ts

@@ -0,0 +1,14 @@
+import type { Tree } from '@nx/devkit';
+import type { Schema } from '../schema';
+export declare function normalizeOptions(tree: Tree, options: Schema): {
+    project: string;
+    appId: string;
+    main: string;
+    serverFileName: string;
+    serverPort: number;
+    rootModuleFileName: string;
+    rootModuleClassName: string;
+    skipFormat: boolean;
+    standalone: boolean;
+    hydration: boolean;
+};

package/src/generators/setup-ssr/lib/normalize-options.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeOptions = void 0;
+const ast_utils_1 = require("../../../utils/nx-devkit/ast-utils");
+const version_utils_1 = require("../../utils/version-utils");
+function normalizeOptions(tree, options) {
+    const isStandaloneApp = (0, ast_utils_1.isNgStandaloneApp)(tree, options.project);
+    let hydration = options.hydration;
+    if (hydration === undefined) {
+        const { major: angularMajorVersion } = (0, version_utils_1.getInstalledAngularVersionInfo)(tree);
+        hydration = angularMajorVersion >= 17;
+    }
+    return {
+        project: options.project,
+        appId: options.appId ?? 'serverApp',
+        main: options.main ?? 'main.server.ts',
+        serverFileName: options.serverFileName ?? 'server.ts',
+        serverPort: options.serverPort ?? 4000,
+        rootModuleFileName: options.rootModuleFileName ?? 'app.server.module.ts',
+        rootModuleClassName: options.rootModuleClassName ?? 'AppServerModule',
+        skipFormat: options.skipFormat ?? false,
+        standalone: options.standalone ?? isStandaloneApp,
+        hydration,
+    };
+}
+exports.normalizeOptions = normalizeOptions;

package/src/generators/setup-ssr/lib/set-router-initial-navigation.d.ts

@@ -0,0 +1,3 @@
+import { type Tree } from '@nx/devkit';
+import type { Schema } from '../schema';
+export declare function setRouterInitialNavigation(tree: Tree, options: Schema): void;

package/src/generators/setup-ssr/lib/set-router-initial-navigation.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setRouterInitialNavigation = void 0;
+const devkit_1 = require("@nx/devkit");
+const js_1 = require("@nx/js");
+const tsquery_1 = require("@phenomnomnominal/tsquery");
+const typescript_1 = require("typescript");
+function setRouterInitialNavigation(tree, options) {
+    const printer = (0, typescript_1.createPrinter)();
+    const project = (0, devkit_1.readProjectConfiguration)(tree, options.project);
+    (0, devkit_1.visitNotIgnoredFiles)(tree, project.root, (filePath) => {
+        // we are only interested in .ts files
+        if (!filePath.endsWith('.ts')) {
+            return;
+        }
+        if (options.standalone) {
+            processFileWithStandaloneSetup(tree, filePath, printer);
+        }
+        else {
+            processFileWithNgModuleSetup(tree, filePath, printer);
+        }
+    });
+}
+exports.setRouterInitialNavigation = setRouterInitialNavigation;
+function processFileWithStandaloneSetup(tree, filePath, printer) {
+    let content = tree.read(filePath, 'utf-8');
+    let sourceFile = tsquery_1.tsquery.ast(content);
+    const provideRouterCallExpression = getProvideRouterCallExpression(sourceFile);
+    if (!provideRouterCallExpression) {
+        return;
+    }
+    if (provideRouterCallExpression.arguments.some((arg) => (0, typescript_1.isCallExpression)(arg) &&
+        (0, typescript_1.isIdentifier)(arg.expression) &&
+        arg.expression.text === 'withEnabledBlockingInitialNavigation')) {
+        return;
+    }
+    const updatedProvideRouterCallExpression = printer.printNode(typescript_1.EmitHint.Unspecified, updateProvideRouterCallExpression(provideRouterCallExpression), sourceFile);
+    content = `${content.slice(0, provideRouterCallExpression.getStart())}${updatedProvideRouterCallExpression}${content.slice(provideRouterCallExpression.getEnd())}`;
+    tree.write(filePath, content);
+    sourceFile = tsquery_1.tsquery.ast(content);
+    sourceFile = (0, js_1.insertImport)(tree, sourceFile, filePath, 'withEnabledBlockingInitialNavigation', '@angular/router');
+    const withDisabledInitialNavigationImportNode = (0, tsquery_1.tsquery)(sourceFile, 'ImportDeclaration ImportSpecifier:has(Identifier[name=withDisabledInitialNavigation])')[0];
+    if (!withDisabledInitialNavigationImportNode) {
+        return;
+    }
+    const hasTrailingComma = withDisabledInitialNavigationImportNode.parent.elements.hasTrailingComma;
+    content = tree.read(filePath, 'utf-8');
+    tree.write(filePath, `${content.slice(0, withDisabledInitialNavigationImportNode.getStart())}${content.slice(withDisabledInitialNavigationImportNode.getEnd() +
+        (hasTrailingComma ? 1 : 0))}`);
+}
+function updateProvideRouterCallExpression(node) {
+    const filteredArgs = node.arguments.filter((arg) => !((0, typescript_1.isCallExpression)(arg) &&
+        (0, typescript_1.isIdentifier)(arg.expression) &&
+        arg.expression.text === 'withDisabledInitialNavigation'));
+    const initialNavigationFeatureArg = typescript_1.factory.createCallExpression(typescript_1.factory.createIdentifier('withEnabledBlockingInitialNavigation'), [], []);
+    return typescript_1.factory.updateCallExpression(node, node.expression, node.typeArguments, [...filteredArgs, initialNavigationFeatureArg]);
+}
+function processFileWithNgModuleSetup(tree, filePath, printer) {
+    const content = tree.read(filePath, 'utf-8');
+    const sourceFile = tsquery_1.tsquery.ast(content);
+    const routerModuleForRootCallExpression = getRouterModuleForRootCallExpression(sourceFile);
+    if (!routerModuleForRootCallExpression) {
+        return;
+    }
+    const updatedRouterModuleForRootCallExpression = printer.printNode(typescript_1.EmitHint.Unspecified, updateRouterModuleForRootCallExpression(routerModuleForRootCallExpression), sourceFile);
+    tree.write(filePath, `${content.slice(0, routerModuleForRootCallExpression.getStart())}${updatedRouterModuleForRootCallExpression}${content.slice(routerModuleForRootCallExpression.getEnd())}`);
+}
+function updateRouterModuleForRootCallExpression(node) {
+    const existingOptions = node.arguments[1];
+    const existingProperties = existingOptions?.properties
+        ? typescript_1.factory.createNodeArray(existingOptions.properties.filter((exp) => !((0, typescript_1.isPropertyAssignment)(exp) &&
+            (0, typescript_1.isIdentifier)(exp.name) &&
+            exp.name.text === 'initialNavigation')))
+        : typescript_1.factory.createNodeArray();
+    const enabledLiteral = typescript_1.factory.createStringLiteral('enabledBlocking', true);
+    const initialNavigationProperty = typescript_1.factory.createPropertyAssignment('initialNavigation', enabledLiteral);
+    const routerOptions = existingOptions
+        ? typescript_1.factory.updateObjectLiteralExpression(existingOptions, typescript_1.factory.createNodeArray([
+            ...existingProperties,
+            initialNavigationProperty,
+        ]))
+        : typescript_1.factory.createObjectLiteralExpression(typescript_1.factory.createNodeArray([initialNavigationProperty]));
+    const args = [node.arguments[0], routerOptions];
+    return typescript_1.factory.createCallExpression(node.expression, node.typeArguments, args);
+}
+function getProvideRouterCallExpression(sourceFile) {
+    const routerModuleForRootCalls = (0, tsquery_1.tsquery)(sourceFile, 'PropertyAssignment:has(Identifier[name=providers]) > ArrayLiteralExpression CallExpression:has(Identifier[name=provideRouter])', { visitAllChildren: true });
+    return routerModuleForRootCalls.length ? routerModuleForRootCalls[0] : null;
+}
+function getRouterModuleForRootCallExpression(sourceFile) {
+    const routerModuleForRootCalls = (0, tsquery_1.tsquery)(sourceFile, 'Decorator > CallExpression:has(Identifier[name=NgModule]) PropertyAssignment:has(Identifier[name=imports]) > ArrayLiteralExpression CallExpression:has(Identifier[name=forRoot])', { visitAllChildren: true });
+    return routerModuleForRootCalls.length ? routerModuleForRootCalls[0] : null;
+}

package/src/generators/setup-ssr/lib/update-app-module.d.ts

@@ -0,0 +1,3 @@
+import type { Tree } from '@nx/devkit';
+import type { Schema } from '../schema';
+export declare function updateAppModule(tree: Tree, schema: Schema): void;

package/src/generators/setup-ssr/lib/update-app-module.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateAppModule = void 0;
+const devkit_1 = require("@nx/devkit");
+const ensure_typescript_1 = require("@nx/js/src/utils/typescript/ensure-typescript");
+const version_utils_1 = require("../../utils/version-utils");
+function updateAppModule(tree, schema) {
+    const angularMajorVersion = (0, version_utils_1.getInstalledAngularMajorVersion)(tree);
+    if (angularMajorVersion >= 16) {
+        return;
+    }
+    (0, ensure_typescript_1.ensureTypescript)();
+    const { tsquery } = require('@phenomnomnominal/tsquery');
+    // read the content of app module
+    const projectConfig = (0, devkit_1.readProjectConfiguration)(tree, schema.project);
+    const pathToAppModule = (0, devkit_1.joinPathFragments)(projectConfig.sourceRoot, 'app/app.module.ts');
+    const fileContents = tree.read(pathToAppModule, 'utf-8');
+    const ast = tsquery.ast(fileContents);
+    const browserModuleImportNodes = tsquery(ast, 'PropertyAssignment:has(Identifier[name=imports]) > ArrayLiteralExpression Identifier[name=BrowserModule]', { visitAllChildren: true });
+    if (browserModuleImportNodes.length === 0) {
+        throw new Error(`Could not find BrowserModule declaration in ${pathToAppModule}. Please ensure this is correct.`);
+    }
+    const browserModuleNode = browserModuleImportNodes[0];
+    const newFileContents = `${fileContents.slice(0, browserModuleNode.getEnd())}.withServerTransition({ appId: '${schema.appId}' })${fileContents.slice(browserModuleNode.getEnd(), fileContents.length)}`;
+    tree.write(pathToAppModule, newFileContents);
+}
+exports.updateAppModule = updateAppModule;

package/src/generators/setup-ssr/lib/update-project-config.d.ts

@@ -0,0 +1,4 @@
+import type { Tree } from '@nx/devkit';
+import type { Schema } from '../schema';
+export declare function updateProjectConfigForApplicationBuilder(tree: Tree, options: Schema): void;
+export declare function updateProjectConfigForBrowserBuilder(tree: Tree, schema: Schema): void;

package/src/generators/setup-ssr/lib/update-project-config.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateProjectConfigForBrowserBuilder = exports.updateProjectConfigForApplicationBuilder = void 0;
+const devkit_1 = require("@nx/devkit");
+const version_utils_1 = require("../../utils/version-utils");
+const constants_1 = require("./constants");
+function updateProjectConfigForApplicationBuilder(tree, options) {
+    const project = (0, devkit_1.readProjectConfiguration)(tree, options.project);
+    const buildTarget = project.targets.build;
+    let outputPath = buildTarget.options?.outputPath;
+    if (outputPath &&
+        typeof outputPath !== 'string' &&
+        outputPath.browser === '') {
+        const base = outputPath.base;
+        devkit_1.logger.warn(`The output location of the browser build has been updated from "${base}" to "${(0, devkit_1.joinPathFragments)(base, constants_1.DEFAULT_BROWSER_DIR)}".
+          You might need to adjust your deployment pipeline.`);
+        if ((outputPath.media && outputPath.media !== constants_1.DEFAULT_MEDIA_DIR) ||
+            (outputPath.server && outputPath.server !== constants_1.DEFAULT_SERVER_DIR)) {
+            delete outputPath.browser;
+        }
+        else {
+            outputPath = outputPath.base;
+        }
+    }
+    buildTarget.options ??= {};
+    buildTarget.options.outputPath = outputPath;
+    buildTarget.options.server = (0, devkit_1.joinPathFragments)(project.sourceRoot ?? (0, devkit_1.joinPathFragments)(project.root, 'src'), options.main);
+    buildTarget.options.prerender = true;
+    buildTarget.options.ssr = {
+        entry: (0, devkit_1.joinPathFragments)(project.root, options.serverFileName),
+    };
+    (0, devkit_1.updateProjectConfiguration)(tree, options.project, project);
+}
+exports.updateProjectConfigForApplicationBuilder = updateProjectConfigForApplicationBuilder;
+function updateProjectConfigForBrowserBuilder(tree, schema) {
+    const projectConfig = (0, devkit_1.readProjectConfiguration)(tree, schema.project);
+    const buildTarget = projectConfig.targets.build;
+    const baseOutputPath = buildTarget.options.outputPath;
+    buildTarget.options.outputPath = (0, devkit_1.joinPathFragments)(baseOutputPath, 'browser');
+    const buildConfigurations = projectConfig.targets.build.configurations;
+    const configurations = {};
+    if (buildConfigurations) {
+        for (const [key, options] of Object.entries(buildConfigurations)) {
+            configurations[key] = getServerOptions(options);
+        }
+    }
+    projectConfig.targets.server = {
+        dependsOn: ['build'],
+        executor: buildTarget.executor.startsWith('@angular-devkit/build-angular:')
+            ? '@angular-devkit/build-angular:server'
+            : '@nx/angular:webpack-server',
+        options: {
+            outputPath: (0, devkit_1.joinPathFragments)(baseOutputPath, 'server'),
+            main: (0, devkit_1.joinPathFragments)(projectConfig.root, schema.serverFileName),
+            tsConfig: (0, devkit_1.joinPathFragments)(projectConfig.root, 'tsconfig.server.json'),
+            ...(buildTarget.options ? getServerOptions(buildTarget.options) : {}),
+        },
+        configurations,
+        defaultConfiguration: 'production',
+    };
+    const { major: angularMajorVersion } = (0, version_utils_1.getInstalledAngularVersionInfo)(tree);
+    projectConfig.targets['serve-ssr'] = {
+        executor: angularMajorVersion >= 17
+            ? '@angular-devkit/build-angular:ssr-dev-server'
+            : '@nguniversal/builders:ssr-dev-server',
+        configurations: {
+            development: {
+                browserTarget: `${schema.project}:build:development`,
+                serverTarget: `${schema.project}:server:development`,
+            },
+            production: {
+                browserTarget: `${schema.project}:build:production`,
+                serverTarget: `${schema.project}:server:production`,
+            },
+        },
+        defaultConfiguration: 'development',
+    };
+    projectConfig.targets.prerender = {
+        executor: angularMajorVersion >= 17
+            ? '@angular-devkit/build-angular:prerender'
+            : '@nguniversal/builders:prerender',
+        options: {
+            routes: ['/'],
+        },
+        configurations: {
+            development: {
+                browserTarget: `${schema.project}:build:development`,
+                serverTarget: `${schema.project}:server:development`,
+            },
+            production: {
+                browserTarget: `${schema.project}:build:production`,
+                serverTarget: `${schema.project}:server:production`,
+            },
+        },
+        defaultConfiguration: 'production',
+    };
+    (0, devkit_1.updateProjectConfiguration)(tree, schema.project, projectConfig);
+    const nxJson = (0, devkit_1.readNxJson)(tree);
+    if (nxJson.tasksRunnerOptions?.default?.options?.cacheableOperations &&
+        !nxJson.tasksRunnerOptions.default.options.cacheableOperations.includes('server')) {
+        nxJson.tasksRunnerOptions.default.options.cacheableOperations.push('server');
+    }
+    nxJson.targetDefaults ??= {};
+    nxJson.targetDefaults.server ??= {};
+    nxJson.targetDefaults.server.cache ??= true;
+    (0, devkit_1.updateNxJson)(tree, nxJson);
+}
+exports.updateProjectConfigForBrowserBuilder = updateProjectConfigForBrowserBuilder;
+function getServerOptions(options = {}) {
+    return {
+        buildOptimizer: options?.buildOptimizer,
+        outputHashing: options?.outputHashing === 'all'
+            ? 'media'
+            : options?.outputHashing,
+        fileReplacements: options?.fileReplacements,
+        optimization: options?.optimization === undefined ? undefined : !!options?.optimization,
+        sourceMap: options?.sourceMap,
+        stylePreprocessorOptions: options?.stylePreprocessorOptions,
+        resourcesOutputPath: options?.resourcesOutputPath,
+        deployUrl: options?.deployUrl,
+        i18nMissingTranslation: options?.i18nMissingTranslation,
+        preserveSymlinks: options?.preserveSymlinks,
+        extractLicenses: options?.extractLicenses,
+        inlineStyleLanguage: options?.inlineStyleLanguage,
+        vendorChunk: options?.vendorChunk,
+    };
+}

package/src/generators/setup-ssr/lib/validate-options.d.ts

@@ -0,0 +1,3 @@
+import type { Tree } from '@nx/devkit';
+import type { Schema } from '../schema';
+export declare function validateOptions(tree: Tree, options: Schema): void;

package/src/generators/setup-ssr/lib/validate-options.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateOptions = void 0;
+const devkit_1 = require("@nx/devkit");
+const validations_1 = require("../../utils/validations");
+const version_utils_1 = require("../../utils/version-utils");
+const semver_1 = require("semver");
+function validateOptions(tree, options) {
+    validateProject(tree, options.project);
+    validateBuildTarget(tree, options.project);
+    validateHydrationOption(tree, options.hydration);
+}
+exports.validateOptions = validateOptions;
+function validateProject(tree, project) {
+    (0, validations_1.validateProject)(tree, project);
+    const { projectType } = (0, devkit_1.readProjectConfiguration)(tree, project);
+    if (projectType !== 'application') {
+        throw new Error(`The "${project}" project is not an application. Only application projects are supported by the "setup-ssr" generator.`);
+    }
+}
+function validateBuildTarget(tree, project) {
+    const { targets } = (0, devkit_1.readProjectConfiguration)(tree, project);
+    if (!targets?.build) {
+        throw new Error(`The "${project}" project does not have a "build" target. Please add a "build" target.`);
+    }
+}
+function validateHydrationOption(tree, hydration) {
+    if (!hydration) {
+        return;
+    }
+    const installedAngularVersion = (0, version_utils_1.getInstalledAngularVersionInfo)(tree).version;
+    if ((0, semver_1.lt)(installedAngularVersion, '16.0.0')) {
+        throw new Error((0, devkit_1.stripIndents) `The "hydration" option is only supported in Angular >= 16.0.0. You are currently using "${installedAngularVersion}".
+    You can resolve this error by removing the "hydration" option or by migrating to Angular 16.0.0.`);
+    }
+}

package/src/generators/setup-ssr/schema.d.ts

@@ -0,0 +1,12 @@
+export interface Schema {
+  project: string;
+  appId?: string;
+  main?: string;
+  serverFileName?: string;
+  serverPort?: number;
+  rootModuleFileName?: string;
+  rootModuleClassName?: string;
+  standalone?: boolean;
+  hydration?: boolean;
+  skipFormat?: boolean;
+}

package/src/generators/setup-ssr/schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "GeneratorAngularUniversalSetup",
+  "cli": "nx",
+  "title": "Generate Angular Universal (SSR) setup for an Angular App",
+  "description": "Create the additional configuration required to enable SSR via Angular Universal for an Angular application.",
+  "type": "object",
+  "properties": {
+    "project": {
+      "type": "string",
+      "description": "The name of the application to generate the Angular Universal configuration for.",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What app would you like to generate an Angular Universal configuration for?",
+      "x-dropdown": "projects"
+    },
+    "appId": {
+      "type": "string",
+      "format": "html-selector",
+      "description": "The `appId` to use with `withServerTransition`. _Note: This is only used in Angular versions <16.0.0. It's deprecated since Angular 16 and not supported since Angular 17._",
+      "default": "serverApp"
+    },
+    "main": {
+      "type": "string",
+      "format": "path",
+      "description": "The name of the main entry-point file.",
+      "default": "main.server.ts"
+    },
+    "serverFileName": {
+      "type": "string",
+      "default": "server.ts",
+      "description": "The name of the Express server file."
+    },
+    "serverPort": {
+      "type": "number",
+      "default": 4000,
+      "description": "The port for the Express server."
+    },
+    "rootModuleFileName": {
+      "type": "string",
+      "format": "path",
+      "description": "The name of the root module file",
+      "default": "app.server.module.ts"
+    },
+    "rootModuleClassName": {
+      "type": "string",
+      "description": "The name of the root module class.",
+      "default": "AppServerModule"
+    },
+    "standalone": {
+      "type": "boolean",
+      "description": "Use Standalone Components to bootstrap SSR."
+    },
+    "hydration": {
+      "type": "boolean",
+      "description": "Set up Hydration for the SSR application. It defaults to `true` for Angular versions >= 17.0.0. Otherwise, it defaults to `false`. _Note: This is only supported in Angular versions >= 16.0.0_."
+    },
+    "skipFormat": {
+      "type": "boolean",
+      "description": "Skip formatting the workspace after the generator completes.",
+      "x-priority": "internal"
+    }
+  },
+  "required": ["project"],
+  "additionalProperties": false
+}

package/src/generators/setup-ssr/setup-ssr.d.ts

@@ -0,0 +1,4 @@
+import type { Tree } from '@nx/devkit';
+import type { Schema } from './schema';
+export declare function setupSsr(tree: Tree, schema: Schema): Promise<() => void>;
+export default setupSsr;

package/src/generators/setup-ssr/setup-ssr.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupSsr = void 0;
+const devkit_1 = require("@nx/devkit");
+const version_utils_1 = require("../utils/version-utils");
+const lib_1 = require("./lib");
+async function setupSsr(tree, schema) {
+    (0, lib_1.validateOptions)(tree, schema);
+    const options = (0, lib_1.normalizeOptions)(tree, schema);
+    const { targets } = (0, devkit_1.readProjectConfiguration)(tree, options.project);
+    const isUsingApplicationBuilder = targets.build.executor === '@angular-devkit/build-angular:application' ||
+        targets.build.executor === '@nx/angular:application';
+    (0, lib_1.addDependencies)(tree, isUsingApplicationBuilder);
+    (0, lib_1.generateSSRFiles)(tree, options, isUsingApplicationBuilder);
+    if (!options.standalone) {
+        (0, lib_1.updateAppModule)(tree, options);
+    }
+    if (options.hydration) {
+        (0, lib_1.addHydration)(tree, options);
+    }
+    const { major: angularMajorVersion } = (0, version_utils_1.getInstalledAngularVersionInfo)(tree);
+    if (angularMajorVersion < 17 || !options.hydration) {
+        (0, lib_1.setRouterInitialNavigation)(tree, options);
+    }
+    if (isUsingApplicationBuilder) {
+        (0, lib_1.updateProjectConfigForApplicationBuilder)(tree, options);
+        (0, lib_1.setServerTsConfigOptionsForApplicationBuilder)(tree, options);
+    }
+    else {
+        (0, lib_1.updateProjectConfigForBrowserBuilder)(tree, options);
+        (0, lib_1.generateTsConfigServerJsonForBrowserBuilder)(tree, options);
+    }
+    (0, lib_1.addServerFile)(tree, options, isUsingApplicationBuilder);
+    if (!options.skipFormat) {
+        await (0, devkit_1.formatFiles)(tree);
+    }
+    return () => {
+        (0, devkit_1.installPackagesTask)(tree);
+    };
+}
+exports.setupSsr = setupSsr;
+exports.default = setupSsr;

package/src/generators/setup-tailwind/files/v2/tailwind.config.js__tmpl__

@@ -0,0 +1,18 @@
+const { createGlobPatternsForDependencies } = require('@nx/angular/tailwind');
+const { join } = require('path');
+
+module.exports = {
+  mode: 'jit',
+  purge: [
+    join(__dirname, '<%= relativeSourceRoot %>/**/!(*.stories|*.spec).{ts,html}'),
+    ...createGlobPatternsForDependencies(__dirname),
+  ],
+  darkMode: false, // or 'media' or 'class'
+  theme: {
+    extend: {},
+  },
+  variants: {
+    extend: {},
+  },
+  plugins: [],
+};

package/src/generators/setup-tailwind/files/v3/tailwind.config.js__tmpl__

@@ -0,0 +1,14 @@
+const { createGlobPatternsForDependencies } = require('@nx/angular/tailwind');
+const { join } = require('path');
+
+/** @type {import('tailwindcss').Config} */
+module.exports = {
+  content: [
+    join(__dirname, '<%= relativeSourceRoot %>/**/!(*.stories|*.spec).{ts,html}'),
+    ...createGlobPatternsForDependencies(__dirname),
+  ],
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+};

package/src/generators/setup-tailwind/lib/add-tailwind-config-path-to-project.d.ts

@@ -0,0 +1,3 @@
+import { ProjectConfiguration, Tree } from '@nx/devkit';
+import { NormalizedGeneratorOptions } from '../schema';
+export declare function addTailwindConfigPathToProject(tree: Tree, options: NormalizedGeneratorOptions, project: ProjectConfiguration): void;

package/src/generators/setup-tailwind/lib/add-tailwind-config-path-to-project.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addTailwindConfigPathToProject = void 0;
+const devkit_1 = require("@nx/devkit");
+function addTailwindConfigPathToProject(tree, options, project) {
+    const buildTarget = project.targets?.[options.buildTarget];
+    if (!buildTarget) {
+        throw new Error((0, devkit_1.stripIndents) `The target "${options.buildTarget}" was not found for project "${options.project}".
+      If you are using a different build target, please provide it using the "--buildTarget" option.
+      If the project is not a buildable or publishable library, you don't need to setup TailwindCSS for it.`);
+    }
+    const supportedLibraryExecutors = [
+        '@nx/angular:ng-packagr-lite',
+        '@nx/angular:package',
+        '@nrwl/angular:ng-packagr-lite',
+        '@nrwl/angular:package',
+    ];
+    if (!supportedLibraryExecutors.includes(buildTarget.executor)) {
+        throw new Error((0, devkit_1.stripIndents) `The build target for project "${options.project}" is using an unsupported executor "${buildTarget.executor}".
+      Supported executors are ${supportedLibraryExecutors
+            .map((e) => `"${e}"`)
+            .join(', ')}.`);
+    }
+    if (buildTarget.options?.tailwindConfig &&
+        tree.exists(buildTarget.options.tailwindConfig)) {
+        throw new Error((0, devkit_1.stripIndents) `The "${buildTarget.options.tailwindConfig}" file is already configured for the project "${options.project}". Are you sure this is the right project to set up Tailwind?
+      If you are sure, you can remove the configuration and re-run the generator.`);
+    }
+    buildTarget.options = {
+        ...buildTarget.options,
+        tailwindConfig: (0, devkit_1.joinPathFragments)(project.root, 'tailwind.config.js'),
+    };
+    (0, devkit_1.updateProjectConfiguration)(tree, options.project, project);
+}
+exports.addTailwindConfigPathToProject = addTailwindConfigPathToProject;

package/src/generators/setup-tailwind/lib/add-tailwind-config.d.ts

@@ -0,0 +1,3 @@
+import { ProjectConfiguration, Tree } from '@nx/devkit';
+import { GeneratorOptions } from '../schema';
+export declare function addTailwindConfig(tree: Tree, options: GeneratorOptions, project: ProjectConfiguration, tailwindVersion: '2' | '3'): void;

package/src/generators/setup-tailwind/lib/add-tailwind-config.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addTailwindConfig = void 0;
+const devkit_1 = require("@nx/devkit");
+const path_1 = require("path");
+function addTailwindConfig(tree, options, project, tailwindVersion) {
+    if (tree.exists((0, devkit_1.joinPathFragments)(project.root, 'tailwind.config.js'))) {
+        throw new Error((0, devkit_1.stripIndents) `The "tailwind.config.js" file already exists in the project "${options.project}". Are you sure this is the right project to set up Tailwind?
+      If you are sure, you can remove the existing file and re-run the generator.`);
+    }
+    const filesDir = tailwindVersion === '3' ? 'files/v3' : 'files/v2';
+    (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, '..', filesDir), project.root, {
+        relativeSourceRoot: (0, path_1.relative)(project.root, project.sourceRoot),
+        tmpl: '',
+    });
+}
+exports.addTailwindConfig = addTailwindConfig;

package/src/generators/setup-tailwind/lib/add-tailwind-required-packages.d.ts

@@ -0,0 +1,2 @@
+import { GeneratorCallback, Tree } from '@nx/devkit';
+export declare function addTailwindRequiredPackages(tree: Tree): GeneratorCallback;