Airdrop TODO snap-in

The Airdrop TODO snap-in syncs data between TODO and DevRev using DevRev's Airdrop platform.

Prerequisites

Install the following tools:

• DevRev CLI
• jq
• Node.js
• ngrok

Set your DevRev organization slug (the part after app.devrev.ai/ in your DevRev URL) and your email in the .env file:

DEV_ORG=my-org
USER_EMAIL=my@email.com

Getting Started

After installing the prerequisites above you can start developing the snap-in. Run the following code from the code directory:

1. Authenticate to your DevRev organization using the DevRev CLI

devrev profiles authenticate --usr <your email> --org <your DevRev organization slug>

2. Install NPM dependencies

npm ci

3. Start the snap-in development server

npm run test:server -- local

4. Start the ngrok tunnel in a separate terminal window

For this step, you will need to create a ngrok account.

ngrok http 8000

This will create a tunnel to your local server. The ngrok forwarding URL will be displayed in the terminal window.

5. Create a new snap-in version and package in a separate terminal window

Copy the ngrok 'Forwarding' URL from the previous step (the one ending with ngrok-free.app).

devrev snap_in_version create-one  --manifest ./manifest.yaml --create-package --testing-url <ngrok forwarding URL>

6. Create a snap-in draft

devrev snap_in draft

7. Install the snap-in

You can install it in the DevRev UI by going to Settings -> Snap-ins -> Installed -> <your snap-in> -> Install snap-in or using the following command:

devrev snap_in activate

8. Start the import

In the DevRev UI, go to Airdrops -> Start Airdrop -> <your snap-in> and start the import.