/revert

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

Primary LanguageTypeScriptGNU Affero General Public License v3.0AGPL-3.0

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

Star us on GitHub Vercel twitter Revert API PRs welcome Commits-per-month License

Hacker News

Featured on Hacker News Revert - Open-source unified API to build product integrations | Product Hunt Revert - Open-source unified API to build product integrations | Product Hunt

⭐ 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

Sign up for an account or read our docs here !

🚀 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:

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

Book us with Cal.com

🔒 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:

  • Salesforce

  • Hubspot

  • Zoho CRM

  • Pipedrive

  • Close CRM

  • Other CRMs such as Zendesk Sell, MS 365

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 ❤️