> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brikl.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

The Brikl Chrome Extension integrates directly into the Bubble editor. Follow the steps below to get up and running in under 2 minutes.

## Requirements

Before installing, make sure you have the following:

* Google Chrome or any Chromium-based browser (Brave, Arc, Edge)
* A [Bubble.io](http://Bubble.io) account with at least one active project
* A Brikl account - create one for free in the extension

## Step-by-step setup

<Steps>
  <Step title="Install the Chrome Extension" titleSize="h4">
    Go to the Chrome Web Store and search for **Brikl**, or use the direct link. Click **Add to Chrome**, then confirm by clicking **Add Extension**.

    <Badge color="purple">Soon</Badge>
  </Step>

  <Step title="Open your Bubble editor" titleSize="h4">
    Navigate to [https://bubble.io](https://bubble.io) and open any project. Go to the editor view — the Brikl panel will appear automatically on the right side of the screen.
  </Step>

  <Step title="Create your Brikl account" titleSize="h4">
    Inside the panel, sign up to Brikl. Your license will be verified automatically.
  </Step>

  <Step title="Copy a component" titleSize="h4">
    Browse the library, find a component you want, and click **Copy**.
  </Step>

  <Step title="Paste into your Bubble editor" titleSize="h4">
    Click anywhere on your Bubble canvas and press `Cmd + V` (Mac) or `Ctrl + V` (Windows). The component will appear immediately, fully editable.
  </Step>
</Steps>

## Permissions

Brikl only runs on `bubble.io` pages. It does not access any other websites or collect any personal data from your browser.

## Troubleshooting

<AccordionGroup>
  <Accordion title="The Brikl panel doesn't appear in the editor">
    Refresh the Bubble editor page after installing the extension. If the issue persists, click the Brikl icon in your Chrome toolbar to check that the extension is enabled.
  </Accordion>

  <Accordion title="Pasting a component doesn't work">
    If `Cmd + V` (Mac) or `Ctrl + V` (Windows) doesn't work, try the following:

    1. Right-click anywhere on the Bubble editor canvas.
    2. A context menu will appear with several options.
    3. Click **Paste** at the position where you want to place the component. The component will be inserted exactly where you right-clicked.
  </Accordion>

  <Accordion title="I'm not logged in / my session expired">
    Click the Brikl icon in your Chrome toolbar and sign in again with your Brikl credentials. If you still can't log in, contact our support team at [support@brikl.co](mailto:support@brikl.co).
  </Accordion>

  <Accordion title="The extension was installed but I don't see any components">
    1. Click the **refresh icon** located in the top left corner of the Brikl panel to reload the extension. 2. If no components appear after refreshing, reload the entire Bubble editor page `Cmd + R` on Mac, `Ctrl + R` on Windows).
  </Accordion>
</AccordionGroup>

## Still having issues

Reach out to our support at [support@brikl.co](mailto:support@brikl.co) and we'll get back to you as soon as possible.