---
title: "JavaScript/Sass build pipeline"
manual: "Yoast SEO for TYPO3"
version: "main"
permalink: "https://docs.typo3.org/permalink/yoast-seo-for-typo3/yoast_seo:development-resources@main"
source: "Development/Resources/Index.rst"
rendered: "2026-11-04T08:23:39+00:00"
---

# JavaScript/Sass build pipeline {#development-resources}

The resources build pipeline in `Build/resources/` uses Webpack to bundle React / Yoast
components (wrapped as web components via `@r2wc/react-to-web-component`), build the Yoast webworker and compile
SCSS into production CSS assets.

## Prerequisites {#prerequisites}

-   **Node.js** v22.20.0 (see `Build/resources/.nvmrc`)
-   **Yarn** package manager

Install dependencies:

```bash
cd Build/resources
yarn install
```

## Commands {#commands}

### Build (production) {#build-production}

```bash
cd Build/resources
yarn build
```

### Start (development server) {#start-development-server}

```bash
cd Build/resources
yarn start
```

### Start with Hot Module Replacement {#start-with-hot-module-replacement}

```bash
cd Build/resources
yarn start:hot
```

## Tech stack {#tech-stack}

-   **Webpack 5** via `@wordpress/scripts`
-   **React** with `@r2wc/react-to-web-component` for wrapping React components as
    custom elements
-   **Babel** for JavaScript transpilation
-   **SCSS** / PostCSS for stylesheets
-   **Yoast packages**: `yoastseo`, `@yoast/analysis-report`, `@yoast/components`,
    `@yoast/search-metadata-previews`, `@yoast/social-metadata-previews`, and more

## JavaScript entries {#javascript-entries}

Configured in `Build/resources/webpack.config.js`:

### `webcomponents.tsx` {#webcomponents-tsx}

-   ***Entry***

    `./javascript/webcomponents.tsx`

-   ***Output***

    `Resources/Public/JavaScript/dist/webcomponents.js`

-   ***Description***

    Bundles all 13 React-based web components. Each React component is wrapped with
    `@r2wc/react-to-web-component` and registered as a custom element.
    See [Web Components](https://docs.typo3.org/permalink/yoast-seo-for-typo3/yoast_seo:development-webcomponents@main) for the full component reference.

### `worker.js` {#worker-js}

-   ***Entry***

    `./javascript/worker.js`

-   ***Output***

    `Resources/Public/JavaScript/dist/worker.js`

-   ***Description***

    The Yoast SEO analysis web worker that performs text analysis in a background thread.

## SCSS entries {#scss-entries}

### `backend-module.scss` {#backend-module-scss}

-   ***Entry***

    `./sass/backend-module.scss`

-   ***Output***

    `Resources/Public/CSS/yoast-seo-backend.min.css`

-   ***Description***

    Styles for the Yoast SEO backend module (overview, dashboard).

### `yoast.scss` {#yoast-scss}

-   ***Entry***

    `./sass/yoast.scss`

-   ***Output***

    `Resources/Public/CSS/yoast.min.css`

-   ***Description***

    Core Yoast SEO styles used across the TYPO3 backend interface.

## Webpack configuration {#webpack-configuration}

The build uses a base configuration in `Build/resources/webpack.config.base.js` that
extends `@wordpress/scripts/config/webpack.config` with:

-   Babel loader for all `.js` files
-   `RemoveEmptyScriptsPlugin` to clean up empty JS files generated from SCSS-only entries
-   Custom `DefinePlugin` for `process.env.NODE_DEBUG` and `SCRIPT_DEBUG`
-   The `DependencyExtractionWebpackPlugin` from `@wordpress/scripts` is removed since
    dependencies are bundled rather than externalized
