Skip to content
Transposit's JavaScript SDK
TypeScript JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs Remove user settings access from SDK (#29) Nov 12, 2019
LICENSE Prepare for open sourcing Apr 2, 2019
package.json v2.0.0 Nov 12, 2019


Transposit JavaScript SDK

SDK for web apps using Transposit as a backend.

  • Call endpoints: Call your backend through an idiomatic library.
  • Require sign-in: Ask users to sign in before interacting with your web app.
  • Manage authentication: Allow users to grant access to their third-party data.

To learn more about Transposit as a backend, see the Transposit documentation.


Install with npm or embed the library in a <script> tag.

$ npm install transposit
<script src=""></script>

Instantiate the SDK with the hosted app origin that uniquely identifies your application:

import { Transposit } from "transposit";

const transposit = new Transposit("");
  const transposit = new Transposit.Transposit("");

Call endpoints

Call your backend through an idiomatic library.

  .then(({results})) => {
    // do it!
  .catch(error => {


If your web app requires sign-in, implement these routes.

  • /signin: Displays a sign-in button
  • /handle-signin: Handles redirection after successful sign-in


Create a page that displays a sign-in button. Use the SDK to begin sign-in when the button is clicked.

<button type="button" onclick="signin()">Sign in</button>
  function signin() {

Specify <your-site>/handle-signin as a Successful sign-in URI when you enable user sign-in in Transposit.


Create a page that handles redirection at the end of sign-in. Use the SDK to complete sign-in when the page loads. You do not need to render anything on this page if you redirect once sign-in is complete.

  try {
    await transposit.handleSignIn();
    window.location.href = "/";
  } catch (error) {
    window.location.href = "/signin";

Signed in routes

For all routes that require sign-in, check if the user is signed in. Redirect to your sign-in page if they are not.

  if (!transposit.isSignedIn()) {
    window.location.href = "/signin";


Render a sign-out button. Use the SDK to sign out when the buttons is clicked.

<button type="button" onclick="signout()">Sign out</button>
  function signout() {

Managed authentication

Allow users to grant access to their third-party data. Use the SDK to link users to the Transposit settings page.

<button type="button" onclick="settings()">Settings</button>
  function settings() {
    window.location.href = transposit.settingsUri();


How do I use the SDK with React?

See our React tutorial.

I'm an SDK power user. Can you tell me more?

Absolutely! See the Transposit reference documentation.

I have a question about the SDK. Where should I ask?

File an issue against this repository.

I have a question about Transposit. Where can I learn more?

Check out the Transposit documentation. Email


The Transposit JavaScript SDK is licensed under the Apache License, Version 2.0.

You can’t perform that action at this time.