The client is implemented in typescript. The build system uses both Rollup and WebPack to bundle and transpile the typescript to single files using a variety of module systems. For testing, the typescript compiler is used to compile the code into ES5 and commonjs modules to support direct unit testing in node.
The core Convergence capability is composed of multiple individual projects that are released together. To simplify things, there is a central project that is used for issues, project planning, and road mapping. To report an issue please use the convergence-project repository.
npm install @convergence/convergence
See our developer guide for a quick overview and some getting started code snippets.
- API introduced in a MAJOR or MINOR pre-release version (e.g. 1.1.0-alpha.1) is considered unstable and subject to breaking changes until that MAJOR or MINOR version is released.
- API marked with an
@experimentaltag is considered unstable and subject to breaking changes in a future release.
These deviations from strict Semantic Versioning are intended to get potential new functionality to the community as fast as possible in order to get rapid feedback before the API is finalized. If you do not want to be an early adopter, then you should refrain from using pre-release versions or API marked as
Convergence Labs provides several different channels for support:
- Please use the Discourse Forum for general and technical questions, so the whole community can benefit.
- For paid dedicated support, integration assistance, or other custom development services, contact us directly.
- Chat with us on the Convergence Public Slack.
- Email firstname.lastname@example.org for all other inquiries.
To build a distribution build:
npm install npm run dist
npm run test
Test coverage can be run using
npm run test:cover
Test Pages and Scripts
Several examples are available in the test-pages folder. These allow you to open a browser window with the current compiled version of the client and test functionality. Similarly, the src/scripts directory contains several node scripts that leverage ts-node to execute the raw typescript codebase without compiling.
In both cases, an active server must be available to run the examples or scripts.
The Convergence Client is also available under a Commercial License. If you are interested in a non-open source license please contact us at Convergence Labs.