Converse Headless

Converse has a special build called the headless build.

You can generate it yourself by running npm run build:headless in the root of the converse.js repo.

The headless build is a bundle of all the non-UI parts of Converse, and its aim is to provide you with an XMPP library (and application) on which you can build your own UI.

It's also installable with NPM/Yarn as @converse/headless.

The main distribution of Converse relies on the headless build.

The file src/headless/index.js is used to determine which plugins are included in the build.

Runtime files

When serving or bundling @converse/headless, these companion files must be available at runtime:

| File | Purpose | | -------------------------- | --------------------------------------------------------------------------- | | libomemo.esm.min.js | GPL-licensed crypto library, loaded on-demand when OMEMO encryption is used | | curve25519_compiled.wasm | WebAssembly crypto primitives, loaded by libomemo.esm.js | | emoji.json | Emoji metadata for the built-in emoji picker |

All files must live in the same directory. For CDN/self-host deployments, copy the entire dist/ directory. When using a bundler, ensure these files are treated as external (not bundled).