nx/docs/shared/guides/angular-rspack/api/nx-angular-rspack/create-server.md

title	description
createServer - @nx/angular-rspack/ssr	API Reference for createServer from @nx/angular-rspack/ssr

createServer

import { createServer } from '@nx/angular-rspack/ssr';

The createServer function is used to setup Angular's CommonEngine using an express server. It takes the bootstrap function as an argument, which is the function that bootstraps the Angular server application. This is usually main.server.ts. It returns RsbuildAngularServer which contains the server instance to allow further modifications as well as the listen method to start the server.

function createServer(
  bootstrap: any,
  opts?: RspackAngularServerOptions
): RspackAngularServer;

---

Examples

{% tabs %} {% tab label="Standard Express Server Usage" %} The following example shows how to create a standard express server:

import { createServer } from '@nx/angular-rspack/ssr';
import bootstrap from './main.server';

const server = createServer(bootstrap);

/** Add your custom server logic here
 *
 * For example, you can add a custom static file server:
 *
 * server.app.use('/static', express.static(staticFolder));
 *
 * Or add additional api routes:
 *
 * server.app.get('/api/hello', (req, res) => {
 *   res.send('Hello World!');
 * });
 *
 * Or add additional middleware:
 *
 * server.app.use((req, res, next) => {
 *   res.send('Hello World!');
 * });
 */

server.listen();

{% /tab %} {% /tabs %}

---

RspackAngularServer

export interface RspackAngularServer {
  app: express.Express;
  listen: (port?: number) => void;
}

---

app

express.Express The express application instance.

listen

(port?: number) => void Starts the express application on the specified port. If no port is provided, the default port (4000) is used.

---

RspackAngularServerOptions

export interface RspackAngularServerOptions {
  serverDistFolder?: string;
  browserDistFolder?: string;
  indexHtml?: string;
}

---

serverDistFolder

string The folder where the server bundle is located. Defaults to the dist/server folder.

browserDistFolder

string The folder where the browser bundle is located. Defaults to the dist/browser folder.

indexHtml

string The path to the index.html file. Defaults to the index.html file in the browserDistFolder.