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).