Next time when you update a dependency, forget about manually checking if changelogs contain breaking changes.
Adaptly will do that for you.
- Add Adaptly to your repository by installing Adaptly github app.
- Once installed, Adaptly will analyse all open Dependabot and Renovate PRs and leave PR comments to inform about breaking changes found or PRs being good to merge.
- When a new Dependabot or Renovate PRs are open, it will analyse them automatically.
![](https://private-user-images.githubusercontent.com/42170848/261340239-8ccf6a7e-29f9-4482-8c70-e67414a3c758.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjQ3MTc0MzAsIm5iZiI6MTcyNDcxNzEzMCwicGF0aCI6Ii80MjE3MDg0OC8yNjEzNDAyMzktOGNjZjZhN2UtMjlmOS00NDgyLThjNzAtZTY3NDE0YTNjNzU4LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA4MjclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwODI3VDAwMDUzMFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTg5NmFkNGRiMmYwMjJkMjE0NDQ0YzAxNjc5NjY5MjQ3YzQyMzk5ZGI3ODRkN2IwNDgzODM4NTZhYjVlOWNiZDQmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.c0yyOBea70foMRODSiFQSLoRYmrCAdHKYzZ-Szi6tZg)
Last Updated: 24 Aug 2023
Welcome to Adaptly! At Adaptly, we prioritize your privacy. This Privacy Policy outlines the types of information we collect, how we use it, and the steps we take to safeguard your information while you interact with our GitHub App.
By using Adaptly, you consent to the practices described in this Privacy Policy. If you do not agree with the terms of this Privacy Policy, please do not access or use our services.
Given that our GitHub App is designed to be stateless and non-persistent, we do not collect or store any personal information from your GitHub repositories. Our services come into action only when a new Pull Request (PR) is generated by Dependabot or Renovate in your repository.
Our GitHub App may automatically collect the following technical data:
- GitHub repository ID
- GitHub Pull Request ID
- GitHub User ID of the PR creator
- Timestamp of the PR
We use the automatically collected data solely to:
- Post comments on Pull Requests generated by Dependabot or Renovate
- Provide real-time updates and checks on such Pull Requests
- Improve the functionality and performance of our GitHub App
We do not store any personal information or code from your repositories on our servers. Our services are stateless and designed to forget this information after a comment is posted on the respective PR.
We take reasonable measures to protect your information from unauthorized access or against loss, misuse, or alteration by third parties.
Our GitHub App may contain links to third-party websites or services such as GitHub. We are not responsible for the privacy practices or the content of these third-party services. We encourage you to read the Privacy Policies of these third-party services.
Changes to Our Privacy Policy
We reserve the right to update this Privacy Policy at any time. Any changes will be posted on this page with an updated revision date. Contact Information
If you have any questions about this Privacy Policy, you can contact us at:
Email: [email protected]
Table of contents:
- Use Node.js at the version Adaptly requires:
- Install nvm (Node Version Manager) from here.
- Run “nvm install && nvm use” in the project root.
- Install dependencies using “pnpm”:
- Adaptly uses “pnpm” as the package manager and you can install “pnpm” from here.
- Run “pnpm install” at the project root.
- If it fails, uninstall pnpm and install it again.
- Setup Docker containers:
- Install Docker desktop from here and then start Docker.
- Run “docker-compose up -d” to start Docker containers.
- Setup Doppler for environment variables:
- Sign up for Doppler here.
- Create Doppler project and config with the same names as in “doppler.yaml” in the project root.
- Within the Doppler config setup environment variables required by “source/env.ts”
- Install Doppler CLI from here.
- Authenticate Doppler CLI using “doppler login”
- Run “doppler setup” in project root.
- Setup Local database and Prisma:
- Instantiate tables and run migrations using “pnpm migrate:dev”
- Seed database using “prisma/seed.ts” file
- In production Adaptly is connected to a specific repository. In development we need to simulate it, so replace “owner” and “name” in “prisma/seed.ts” by repository
- Run “npx prisma db seed” to seed database with data
- Build prisma client “pnpm build:prisma”
- To learn how to view database data and apply migrations check “Local development database” section.
- Expose local port 3001 to the internet using ngrok by running “ngrok http 3001”
- In GitHub app settings set “Callback URL” and “Webhook URL” to the one provided by ngrok, but for “Webhook URL” append “/webhook” at the end of it. For example “https://78xx-82-132-200-100.ngrok-free.app/webhook”
- Run “pnpm dev” to start Adaptly on port 3001. It’s now ready to process GitHub app requests.
This document provides step-by-step instructions to set up and manage your local development database using Prisma and Postgres.
-
Start the Postgres Container
docker-compose up -d
-
Instantiate Tables
Apply all pending migrations to instantiate your tables with:
pnpm migrate:dev
-
Seed database using
prisma/seed.ts
filenpx prisma db seed
-
Build Prisma Client
Sync the Prisma client with your database using the command:
pnpm build:prisma
-
View Database
Open TablePlus and connect to your local Postgres database. The default user and password should be 'postgres' and connect to local host. Alternatively, you can view your local development database in your web browser by running Prisma Studio:
pnpm prisma-studio
-
Modify and Migrate Schema
If you make changes to your Prisma schema, create a new migration and apply it with:
pnpm migrate:dev
Remember to commit and push the migration files to your version control system.
-
Rebuild Prisma Client
Sync the Prisma client with your updated database using the command:
pnpm build:prisma
Adaptly uses Doppler to manage secrets. Follow steps below to setup Doppler:
- Sign up for Doppler here.
- Create Doppler project and config with the same names as in “doppler.yaml” in the project root.
- Within the Doppler config setup environment variables required by “source/env.ts”
- The GitHub secrets (
GITHUB_ACCESS_TOKEN
,GITHUB_APP_ID
andGITHUB_APP_PRIVATE_KEY
) are from creating a GitHub app.
- The GitHub secrets (
Make sure you have Docker installed before running the following commands.
You are going to need a DOPPLER_TOKEN
that you can get by following these steps.
- Build the image:
docker build -t adaptly-app .
- Run it:
docker run -p 3001:3001 -d -e DOPPLER_TOKEN="$DOPPLER_TOKEN" --name adaptly-container adaptly-app
You should be able to navigate to your browser and check localhost:3001/ping
is alive.
Once the server is running locally, you can expose it as you want, with ngrok
or running it on any cloud providers and you can then update your GitHub app settings to point to it.
The entry webhook for the app is located at: <YOUR_APP_URL>/webhook
.