airfiveYour apps
Back to your apps

Install airfive

One script. Your own app. Pick the instructions that match how you built it.

First, get your app’s prompt

Open Your apps, choose your app, and find Add airfive to your app. The prompt and script there belong to that app — don’t copy them from a different app.

Built with Lovable?

  1. Choose the Lovable tab in airfive and copy the prompt.
  2. Open that app’s project in Lovable. Paste the whole prompt into the chat where you normally ask Lovable to change your app. Send it.
  3. Wait for Lovable to finish. Click Publish, then Update to put the change on your live website.

Bolt, Replit, v0, Cursor or another AI builder?

  1. Choose Other AI builders in airfive and copy the prompt.
  2. Open your app’s project in your builder and paste it into the AI chat or agent. In Cursor, open your app’s folder first.
  3. Let the builder add the script using the right method for your app. Then use its publish or deploy option. Saving code alone may not update your live site.

Adding the script yourself?

Copy from the Script tag tab. In website settings, look for a site-wide Custom code, Head code or Header scripts field. Paste the entire script there, then save and publish.

For a plain HTML site, place it just before </head> in the template shared by all pages. In React or another framework, use its supported shared document head or global script configuration. If you’re unsure, give your AI builder the prompt instead.

Don’t paste it into a text block, browser address bar, or only one page. You don’t need an npm package.

Make sure it works

  1. Open your published website, not just the builder preview.
  2. Refresh and look for the airfive bubble in the corner you chose.
  3. Send a test question. In airfive, open the same app and check Questions from your users.

No bubble yet?

  • Check you published or deployed after adding the script.
  • Make sure the live address matches the website address you entered when adding the app to airfive. airfive blocks unrelated websites for safety. If the address was wrong, add an app with the correct address and use its new script.
  • Check the app isn’t paused in airfive and the script uses that app’s ID.
  • Try a private browser window with ad-blocking extensions off.
  • If it shows on one page only, ask your builder to move it to the shared document head so it loads across every page.

Connect your app’s code

First, copy your app to GitHub

There are two connections: your builder copies this app’s code to GitHub, then airfive gets access to that repo. Connecting your GitHub account alone doesn’t copy your app.

1. Open this app’s project settings

Open the project you built in Lovable—not airfive’s project. Click the project name → Settings → Git → GitHub.

On your phone: switch to Chat mode if needed, then tap the project name → Settings → Git → GitHub. You can also use the bottom-right … → Settings.

Illustrated example · tap to enlarge

2. Connect the project—not just your account

Under Accounts, choose the GitHub account you use with airfive and press Connect. Confirm the connection if asked. Lovable creates a new private repository and keeps your app’s code in sync.

No account listed? A workspace owner or admin needs to open Workspace settings → Git → GitHub → Add connection → Add account, then finish GitHub’s authorization. Return to this project’s Git settings and press Connect. If you can’t connect the project, ask its owner or admin.

Illustrated example · tap to enlarge

Wait until Lovable shows the linked repository. Note its owner/repo name so you can choose the same one in airfive.

Official Lovable GitHub guide

3. Allow airfive to read that repo

Return to this app in airfive and use Connect GitHub. Choose the account that owns the new repo. If you allowed only selected repositories, open GitHub → Installed GitHub Apps → airfive → Configure, add this repo under Repository access, and save.

Using an access key instead? Include the new repo in that key’s repository access. Can’t find it? Check that your builder and airfive use the same GitHub account or organization.

4. Return, choose your app, and test

In this app’s airfive settings, press Refresh list, choose the matching owner/repo under Which repo is this app?, then press Test GitHub connection. Wait for the test to confirm access. If it fails, follow its message—don’t assume the code is connected.

A new repo can take a minute to appear. Refresh again if needed. Keep using Lovable normally; its connected repo stays in sync.

Give this prompt to Lovable
Help me connect THIS project's code to GitHub so airfive can read it. Walk me through project Settings → Git → GitHub and connecting the project to the same GitHub account I use in airfive. If my workspace needs a GitHub connection first, explain that step too. I know you cannot click these settings for me. Once connected, help me identify the owner/repo name. Then I will allow airfive access to that repo, refresh airfive's repo list, select this app's repo, and run Test GitHub connection. Do not treat GitHub sign-in alone as a connected project.