Rspack config for Flarum JS/TS compilation

This package generates a Rsbpack config object that will compile JavaScript for use in Flarum.

Usage

rspack.config.js

var config = require('flarum-rspack-config');

module.exports = config(options);

package.json

{
  "scripts": {
-   "dev": "webpack --mode development --watch",
-   "build": "webpack --mode production",
+   "dev": "rspack --mode development --watch",
+   "build": "rspack --mode production",
  }
}

To merge in custom Webpack config options, use webpack-merge.

Rspack Bundle Analyzer

You can view a visual representation of your JS Bundle by building with Webpack Bundle Analyzer.

Add another build script to your package.json like the one below:

{
  "analyze": "npx cross-env ANALYZER=true npm run build"
}

Typescript

You'll need to configure a tsconfig.json file to ensure your IDE sets up Typescript support correctly.

For details about this, see the flarum/flarum-tsconfig repository

Options

useExtensions

Array<string>, defaults to [].

An array of extensions whose modules should be made available. This is a shortcut to add externals configuration for extension modules. Imported extension modules will not be bundled, but will instead refer to the extension's exports included in the Flarum runtime (ie. flarum.extensions["vendor/package"]).

For example, to access the Tags extension module within your extension:

forum.js

import { Tag } from '@flarum/tags/forum';

rspack.config.js

module.exports = config({
  useExtensions: ['flarum/tags'],
});