tok-to-insta-follower-bridge/docs/get-started.md

# Getting Started

Sky Follower Bridge helps you find and follow your X (Twitter) connections on Bluesky.

## Installation

Sky Follower Bridge is available on:

- [Chrome Web Store](https://chrome.google.com/webstore/detail/sky-follower-bridge/behhbpbpmailcnfbjagknjngnfdojpko) (Recommended)
- [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/sky-follower-bridge/)
- [Microsoft Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/sky-follower-bridge/dpeolmdblhfolkhlhbhlofkkpaojnnbb)

::: tip
We recommend using the Chrome Web Store version as it's always up to date. Other store versions may lag behind in updates.
:::

## Usage

### 1. Navigate to X (Twitter)

Visit any of these pages on X:
- Your Following page: `x.com/<your_handle>/following`
- Your Blocked users page: `x.com/settings/blocked/all`
- A public List's Members page: `x.com/i/lists/<list_id>/members`

![following-page](./images/following-page.png)

### 2. Launch Sky Follower Bridge

Either press `Alt + B` or click the extension icon in your browser toolbar.

![Open Extension](./images/open-extension.png)

### 3. Sign in to Bluesky

Enter your Bluesky handle (or email) and [App password](https://bsky.app/settings/app-passwords).

![enter-credentials](./images/enter-credentials.png)


### 4. Start the Search

Click "Find Bluesky Users" to begin scanning. The extension will search for matching Bluesky profiles by checking the Bluesky API.

![find-bluesky-users](./images/scan-users.png)

### 5. Review Results

Click "View Results" to see potential matches found on Bluesky.

![view-results-button](./images/click-results.png)

This will open the options page showing all detected Bluesky users.

![options](./images/options.png)

### 6. Follow Users

Click the "Follow" button next to any user you'd like to connect with.
That's all! Enjoy connecting with your community on Bluesky 🎉

![follow](./images/click-follow-btn.png)

::: warning
Please note that the matching process isn't perfect and may occasionally suggest incorrect matches. Always verify the profile before following.
:::