Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
index.js Add reverse parameter to Bucket.list() Oct 23, 2019
package.json Add reverse parameter to Bucket.list() Oct 23, 2019 JavaScript API client

API client for, a managed key-value storage service that lets you quickly build applications in the key-value domain without worrying about backend infrastructure.


  • Minimal
  • Async-ready and Promises-friendly
  • Only a single dependency when used from node.js (node-fetch)
  • Uses the Fetch API, making it compatible for use with both node.js and the browser

Example Usage


Drop this line into your HTML source:

<script src=""></script>


Install npm module:

npm i

Use it:

const KVdb = require('')

Use the API

const bucket = KVdb.bucket('MY_BUCKET_ID', 'MY_ACCESS_TOKEN') // access token arg optional

const myapp = async () => {
  // set a key
  await bucket.set('users:1:flavor', 'oatmeal')

  // get a key
  let res = await bucket.get('users:1:flavor')
  console.log('flavor: ', res)

  // increment a key
  await bucket.incr('users:1:profile_views', 1)

  // list key by prefix (returns an array of keys)
  res = await bucket.list({prefix: 'users:1:'})
  console.log('keys: ', res)

  // list key-values by prefix (returns an array of [key, value] tuples)
  res = await bucket.list({prefix: 'users:1:', values: true})
  for (const [key, value] of res) {
    console.log(`key: ${key} => ${value}`)

  // delete a key
  await bucket.delete('users:1:flavor')


LocalForage Driver

If you're interested in using the KVdb localForage driver, it's easy:

<script src="localforage.js"></script>
<script src=""></script>

  bucket: KVdb.bucket('MY_BUCKET_ID', 'MY_ACCESS_TOKEN')

  .then(() => localForage.setItem('foo', 'bar'))
  .then(() => localForage.getItem('foo'))
  .then(value => alert('value: ' + value))



You can’t perform that action at this time.