API Reference
createConfig
import { createConfig } from '@ng-rsbuild/plugin-angular';
The createConfig function is used to create a Rsbuild
configuration object setup for Angular applications.
It takes an optional RsbuildConfig object as an argument, which
allows for customization of the Rsbuild configuration.
function createConfig(
options: Partial<PluginAngularOptions>,
additionalConfig?: Partial<RsbuildConfig>
)
Examples
The following example shows how to create a configuration for a SSR application:
rsbuild.config.ts
import { createConfig } from '@ng-rsbuild/plugin-angular';
export default createConfig({
browser: './src/main.ts',
server: './src/main.server.ts',
ssrEntry: './src/server.ts',
});
PluginAngularOptions
The PluginAngularOptions object is an object that contains the
following properties:
export interface PluginAngularOptions {
root: string;
index: string;
browser: string;
server?: string;
ssrEntry?: string;
polyfills: string[];
assets: string[];
styles: string[];
scripts: string[];
jit: boolean;
inlineStylesExtension: 'css' | 'scss' | 'sass';
tsconfigPath: string;
hasServer: boolean;
useParallelCompilation: boolean;
useHoistedJavascriptProcessing: boolean;
}
root
string
The root directory of the project. This is the directory where the rsbuild.config.ts file is located.
index
string
The path to the index.html file. This is used to determine the base html template to use.
browser
string
The path to the browser entry file. This is used to determine the entry point for the browser build. It is usually ./src/main.ts
server
string
The path to the server entry file. This is used to determine the entry point for the server build. It is usually ./src/main.server.ts
ssrEntry
string
The path to the node server entry file. This contains the express server setup. It is usually ./src/server.ts
polyfills
Array<string>
An array of polyfills to include in the build. Can be either a path to a polyfill file or a package name.
assets
Array<string>
An array of assets to include in the build. Can be a path to a directory or a file. Resolved from the path provided in root.
styles
Array<string>
An array of styles to include in the build. Resolved from the path provided in root.
scripts
Array<string>
An array of scripts to include in the build. Resolved from the path provided in root.
fileReplacements
Array<FileReplacement>
An array of file replacements to be used in the build. This is used to replace files during the build process.
jit
boolean
Default: true
A boolean value indicating whether to use the JIT mode. This is used to tell the Angular compiler to use Just-In-Time Compilation. **Not Recommended**
inlineStylesExtension
'css' | 'scss' | 'sass'
The inline styles extension to use. This is used to inform the compiler how to handle inline styles, setting up Sass compilation if required.
tsconfigPath
string
Default: true
The path to the TypeScript configuration file. This is used to set compilerOptions for the Angular compilation.
hasServer
boolean
internal
A boolean value indicating whether the project has a server. This is inferred based on the presence of ssrEntry and server and does not need to be set manually.
useParallelCompilation
boolean
Default: true
A boolean value indicating whether to use parallel compilation. Parallel compilation uses workers to speed up the compilation process.
useHoistedJavascriptProcessing
boolean
Default: true
Hoisted javascript processing is a technique used to improve build speeds by moving processing of the JavaScriptTransformer to a separate plugin in order to share cache between server and browser builds.