Server that lets PouchDB applications sync with passwordless logins
JavaScript HTML CSS
Latest commit 41fc070 Apr 28, 2016 @daleharvey daleharvey deprecate


This repository will likely be deleted shortly, keeping it up temporarily in case anyone wants to fork it etc before hand.


PouchBase is a service that lets your PouchDB applications easily provide login and online sync functionality.

When users of your application want to login, they provide an email address and your app notifies the service of that email. will generate a token for that user and send it to their email address.

When the user clicks the token, they will be authenticated with and sent back to your application, will create a database that that user alone can access, your PouchDB application can then sync with that database so whenever the user logs in to your application, their data is automatically kept in sync.

PouchBase Getting Started

The first step is to have a PouchDB application, you can visit for help getting started with PouchDB

Download and add it to your web application

<script src=""></script>

When the user wants to login, call PouchBase.login

loginButton.addEventListener('click', function() {
    email: emailField.value

The user will then be sent an email, when they click on the url they will be authenticated and sent back to your application with a valid session, so check for a valid session when your web application loads

var db = .... // Instiated elsewhere
var sync;

PouchBase.session().then(function (result) {
   if (result.ok) {
     // We have a valid session, sync!
     sync = db.sync(result.db, {live: true});

And your application should now keep your users data in sync wherever they login.

PouchBase API

The PouchBase API is a simple JSON api served from, if you dont want to use the provided JS client, then you can call it directly.

POST /login/

Example Body:
  "email": ""

Send a login request, the body of the request is JSON document, the email property is required, you can provide any extra fields you desire and they will be accessible via the session API

GET /session/

This will return JSON that indicates if the current user has a valid session, if they do any extra data provided to the POST /login/ or POST /session/ API will be included in the response

Example Response:
  "ok": true,
  "user": "",
  "db": ""
Failed Response:
  "error": true,
  "reason": "unauthorized"

POST /session/

If a user has a valid session, you can post a JSON object to it and it will be stored for future access

POST /logout/

Deletes a current users session


If the user has a current valid session, they will be provided a database in which to sync data to, requests to /db/* will be forwarded to a PouchDB (CouchDB) instance that only the current user can access.