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

# Embedded app quickstart

export const Alert = ({type, title, children}) => {
  const variant = ["info", "success", "warning", "danger", "note"].includes(type) ? type : "note";
  return <div className={`alert alert--${variant}`}>
      <div className="alert-icon" />
      <div className="alert-content">
        {title && <div className="alert-title">{title}</div>}
        <div className="alert-body">{children}</div>
      </div>
    </div>;
};

Embedding a Superblocks application on a web page is straight-forward and only involves a few steps.

## Step 1. Create an application

Before you start embedding a Superblocks app in your website, you'll need an application to embed. Learn how to build a Superblocks application in [Building with Clark](/building-with-clark).

Once you have an initial version of your app ready, [**commit & deploy**](/development-lifecycle/version-control/superblocks-sdlc) your app.

## Step 2. Install the SDK

Install either Superblocks' [React](https://www.npmjs.com/package/@superblocksteam/embed-react) or [Javascript](https://www.npmjs.com/package/@superblocksteam/embed) SDK into your web application's client-side code.

<Tabs>
  <Tab title="React">
    ```bash theme={null}
    npm install --save @superblocksteam/embed-react
    ```
  </Tab>

  <Tab title="JavaScript">
    ```bash theme={null}
    npm install --save @superblocksteam/embed
    ```

    Alternatively, add the following `<script>` into the `<head>` of your web page.

    ```html theme={null}
    <script src="https://prod-cdn.superblocks.com/packages/@superblocksteam/embed@latest/embed.bundle.js"></script>
    ```
  </Tab>
</Tabs>

## Step 3. Add the embed component

Add the embed component to your HTML on the page you want the app to appear on.

<Tabs>
  <Tab title="React">
    <Alert type="info">
      Get your app's <code>\<SuperblocksEmbed></code> component by clicking the <strong>Share application</strong> icon in the app editor's header, followed by <strong>Setup embed</strong> in the share modal.
    </Alert>

    ```tsx theme={null}
    import React from 'react';
    import { SuperblocksEmbed } from '@superblocksteam/embed-react';

    const AppWithEmbed = () => {

        return <>
            <SuperblocksEmbed
                src='https://app.superblocks.com/code-mode/embed/applications/<APP_ID>'
            />
        </>;
    }
    ```
  </Tab>

  <Tab title="JavaScript">
    <Alert type="info">
      Get your app's <code>createSuperblocksEmbed</code> snippet by clicking the <strong>Share application</strong> icon in the app editor's header, followed by <strong>Setup embed</strong> in the share modal.
    </Alert>

    ```js theme={null}
    const sbApp = Superblocks.createSuperblocksEmbed({
        id: "sb-app",
        src: "https://app.superblocks.com/code-mode/embed/applications/<APP_ID>"
    });

    document.body.appendChild(sbApp);
    ```
  </Tab>
</Tabs>

## Step 4. View your embedded app

Run your web app in development mode to view and test the embedded app on your site.

<Alert type="success">
  You've now successfully embedded your application! Customize and extend your embed's behavior by exploring the docs below.
</Alert>

## What's next?

With a basic embedded app on your website, you're ready to [**authenticate external users**](/hosting/embedded-apps/authentication) with your Superblocks app.
