Awesome

Get started · Docs · Issues · Discord · Get in touch

</center> <center>

</center>

Revert API <a href="https://github.com/revertinc/revert/pulse"><img src="https://img.shields.io/github/commit-activity/m/revertinc/revert" alt="Commits-per-month"></a> <a href="https://github.com/revertinc/revert/tree/main/LICENSE.txt" target="_blank"> <img src="https://img.shields.io/static/v1?label=license&message=AGPL-3.0&color=white" alt="License"> </a>

</p>

Hacker News

⭐ About Revert

Revert makes it incredibly easy to build integrations with any third party API such as

Go-to-market tools like CRMs (Salesforce, Hubspot).
Communication tools (Slack, MS Teams)
Ticketing tools like (Jira, Asana)

We believe an open source unified API enables us to cover the long tail of third party APIs while empowering engineers to customise the integration code we offer out of the box. This way engineers can use us over building everything from scratch.

Why Revert?

You might want to check us out if

You are developer building a B2B product
You have a ton of integrations on your roadmap
Your focus is building your core product vs maintaining integration code
You want to move fast and not break things

🚀 What makes us faster and reliable.

Seamless Integration: Revert has pre-configured apps on all these platforms so you don't have to create them and deal with nuances on each platform.
Graceful Failure Handling: Ensures smooth handling of expired permissions by customers, preventing any service disruptions.
Automatic OAuth Token Refresh: OAuth tokens are automatically refreshed, ensuring continuous API functionality.
API Retry Mechanism: Revert automatically retries failed API calls, improving reliability and minimizing potential issues.
SDKs for Popular Frameworks: Ready-to-use SDKs available for React, Vue, and Angular, enabling quick and easy integration.
Self-Hosted: Provides the flexibility to self-host the integration solution, giving you full control over deployment and data.

Quickstart

Revert Cloud

The easiest way to get started is to create a Revert Cloud account. The cloud version offers the same functionality as the self-hosted one.

If you want to self-host Revert though, you can do that today with docker-compose as instructed below.

Spinning up Revert with docker-compose

The easiest way to start with self-hosted Revert is to run it via docker-compose:

# Get the code
git clone --depth 1 https://github.com/revertinc/revert

# Copy the example env file
cd revert
cp .env.example .env
cp packages/backend/.env.example packages/backend/.env
cp packages/client/.env.example packages/client/.env
cp packages/js/.env.example packages/js/.env
cp packages/react/.env.example packages/react/.env
cp packages/vue/.env.example packages/vue/.env

# Ensure that clerk is setup in `client` and a user is created by following the instructions here: https://docs.revert.dev/overview/developer-guide/developer-guide#-revertdotdev-client

# Update these .env files with any of your own secrets if you'd like to.

# Then In the root directory run

# When running for the first time to seed the database. (RUN ONLY ONCE)
docker-compose run db-seed

# For subsequent runs
docker-compose up -d

The UI is now available at http://localhost:3000 and the backend is available at http://localhost:4001.

Architecture

Connection flow for your app's users with Revert

Architecture Overview

Packages

This repo contains a set of packages under @reverdotdev/ namespace such as:

@revertdotdev/backend: The core Revert API that powers the frontend SDKs.
@revertdotdev/revert-react: Official SDK for React.
@revertdotdev/revert-vue: Official SDK for Vue.
@revertdotdev/js: Official SDK for Javascript.
...

Examples

The repo revert-example-apps contains a set of examples how to use revert with different frameworks.

📞 Support

In case of questions/feedback, you can get in touch in the following ways

Open a Github support issue
Contact us at email
Ask a question in our discord
If you'd like you can book a call with our team below

🔒 Security

We take security seriously.

Please do not file GitHub issues or post on our public forum for security vulnerabilities.

Email security@revert.dev if you believe you have uncovered a vulnerability. In the message, try to provide a description of the issue and a way of reproducing it.

🗺️ Roadmap

CRMs:

Communication tools:

Slack
Discord
Microsoft Teams

Accounting software:

Xero
Quickbooks

...and more

Ability to self-host Revert inside your own cloud
SOC 2 (In Progress)

Feel free to create an issue if you'd like an integration we're missing here

💪 Contributors

Thankful to the community for making Revert better every day ❤️