JavaScript API client for Bloombox


9272.1.23 years ago4 years agoMinified + gzip package size for @bloombox/js-client in KB


Bloombox for JavaScript

npm Codacy Badge License Maintainability codecov

Latest Version: v2.1.3

This package provides support for Bloombox APIs in browser-oriented JavaScript. It's built using the Closure stack from Google, including Closure Compiler, Library, builder, and so on. Made with love by Bloombox in Sacramento, CA.

Build Status

Using the code

You can either embed the library directly in your project (the compiled copy, or via Closure), or you can use the CDN, which is the simplest and usually the most performant way:

<!doctype html>

  <script type="text/javascript" src="https://js.bloombox.cloud/latest.min.js"></script>
  <script type="text/javascript">
    bloombox.setup("<partner>", "<location>", "<apikey>", function() {
      // use the library


Debug mode

If you are having trouble getting things working correctly, you can use the debug copy, by affixing -debug before the .min in the script URL:

  <script type="text/javascript" src="https://js.bloombox.cloud/latest-debug.min.js"></script>

Then, you'll see debug logs in your console that describe what's going on.

Beta mode

If you want to test against the latest library features while they are still in staging, you can also try the -beta variant of the library, placed just before the .min in the script URL, like -debug:

<script type="text/javascript" src="https://js.bloombox.cloud/latest-beta.min.js"></script>

Version-pinned URL

If you would like to pin your application to a specific version of the library, you can do that:

  <script type="text/javascript" src="https://js.bloombox.cloud/client/v2.1.3.min.js"></script>


  <script type="text/javascript" src="https://js.bloombox.cloud/client/v2.1.3-debug.min.js"></script>

Building the code

Required tools:

  • node
  • yarn
  • git


  • git clone [...] && cd [project root]
  • git submodule update --init --remote
  • make

Other useful tidbits

Running the dev server (serves a test page at 'http://localhost:8000'):

  make serve

Publishing the library (GCS CDN permissions required):

  make publish

This library was made and is managed with <3 by Bloombox, a subsidiary of Momentum Ideas, Co., from Sacramento, California. Bloombox JS is distributed under the Apache License v2, which is enclosed herein as LICENSE.txt. Third party license notices, including ones from MochiKit and Google, via the Closure Authors.

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.