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

# Share with Remix

> Share your Rocket.new apps as remix links - recipients clone your full app and customize it.

export const LlmsDirective = () => <blockquote className="llms-directive">
    For the complete documentation index, see <a href="/llms.txt">llms.txt</a>.
    For a lightweight markdown version of this page, append .md to the URL.
  </blockquote>;

<LlmsDirective />

<Info>
  **Turn any task into a shareable starter.** Generate a remix link for any task and share it with anyone. Recipients get an instant clone of your entire app - screens, code, and integrations - ready to customize with their own credentials.
</Info>

<Note>
  Creating a remix link requires a paid plan (Pro or above). Anyone with the link can clone the project for free.
</Note>

<Divider />

## Use cases

<CardGroup cols={2}>
  <Card title="Client handoff" icon="handshake">
    Build a project for a client and share the remix link. They clone it, add their own API keys, and own the project.
  </Card>

  <Card title="Starter projects" icon="rocket">
    Create reusable starter projects for common app types and share them with your team or community.
  </Card>

  <Card title="Portfolio showcase" icon="images">
    Share working demos of your projects. Viewers can clone and explore the full codebase.
  </Card>

  <Card title="Education and tutorials" icon="graduation-cap">
    Build example projects for courses or tutorials. Students clone and follow along with their own copy.
  </Card>
</CardGroup>

<Divider />

## What is included in a remix

| Included                                                 | Not included                       |
| :------------------------------------------------------- | :--------------------------------- |
| All screens and pages                                    | Environment variables and API keys |
| Complete codebase                                        | Deployment settings                |
| Integration configuration (which services are connected) | Domain configuration               |
| UI components and styling                                |                                    |
| Navigation and routing                                   |                                    |

<Info>
  API keys and integration credentials stored in environment variables are automatically stripped from remix links. Recipients must add their own credentials after cloning.
</Info>

<Warning>
  **Hardcoded secrets are not stripped.** If you have pasted API keys, tokens, or passwords directly into your code rather than storing them in environment variables, Rocket cannot detect or remove them. Always use environment variables for secrets.
</Warning>

<Divider />

## Detailed walkthrough

<Tabs>
  <Tab title="Web Browser">
    ### Before you begin

    <Info>
      **You will need:**

      * A [rocket.new](https://rocket.new) account, signed in.
      * A task you want to share.
    </Info>

    ### Creating a remix link

    <Steps>
      <Step title="Click the Remix icon">
        Open the task you want to share. Click the **Remix** icon in the top toolbar.

        A popup appears explaining that Rocket will create a copy of your task that anyone can use and build on. Click **Remix** to generate the link.

        <Frame caption="Click the Remix icon then click Remix">
          <img src="https://mintcdn.com/dhiwisepvtltd-5e04e6a4/q2IAjGMuqh78nicx/images/build-docs/create/share-with-remix/web-browser/remix-task-button-light.webp?fit=max&auto=format&n=q2IAjGMuqh78nicx&q=85&s=b4441cd062ea003f1082ac4967baaea2" alt="Rocket task editor with the Remix task popup open, showing the Remix button." className="theme-image light-image" width="2880" height="1624" data-path="images/build-docs/create/share-with-remix/web-browser/remix-task-button-light.webp" />

          <img src="https://mintcdn.com/dhiwisepvtltd-5e04e6a4/q2IAjGMuqh78nicx/images/build-docs/create/share-with-remix/web-browser/remix-task-button-dark.webp?fit=max&auto=format&n=q2IAjGMuqh78nicx&q=85&s=b2ef51b2945b966f455b5bd798dfc614" alt="Rocket task editor with the Remix task popup open, showing the Remix button." className="theme-image dark-image" width="2880" height="1624" data-path="images/build-docs/create/share-with-remix/web-browser/remix-task-button-dark.webp" />
        </Frame>
      </Step>

      <Step title="Copy and share your link">
        Rocket generates a unique shareable URL. Click **Copy link** and share it with anyone.

        <Frame caption="Remix link generated and ready to copy">
          <img src="https://mintcdn.com/dhiwisepvtltd-5e04e6a4/q2IAjGMuqh78nicx/images/build-docs/create/share-with-remix/web-browser/remix-link-generated-light.webp?fit=max&auto=format&n=q2IAjGMuqh78nicx&q=85&s=2322970ee506fc9244abbfd4d9537fc7" alt="Remix task popup showing the generated remix URL with a Copy link button." className="theme-image light-image" width="2880" height="1624" data-path="images/build-docs/create/share-with-remix/web-browser/remix-link-generated-light.webp" />

          <img src="https://mintcdn.com/dhiwisepvtltd-5e04e6a4/q2IAjGMuqh78nicx/images/build-docs/create/share-with-remix/web-browser/remix-link-generated-dark.webp?fit=max&auto=format&n=q2IAjGMuqh78nicx&q=85&s=891527a59da144204169bd099258dd05" alt="Remix task popup showing the generated remix URL with a Copy link button." className="theme-image dark-image" width="2880" height="1624" data-path="images/build-docs/create/share-with-remix/web-browser/remix-link-generated-dark.webp" />
        </Frame>

        <Tip>
          Anyone with the link can clone your task to their Rocket account, even if they are on a free plan.
        </Tip>
      </Step>
    </Steps>

    ### Using a remix link

    <Steps>
      <Step title="Preview and clone the task">
        Click the remix link shared with you. You will see a preview page with the task title, description, view count, and a live preview of the app.

        <Frame caption="Remix preview page showing task title, description, view count, and a live preview of the app">
          <img src="https://mintcdn.com/dhiwisepvtltd-5e04e6a4/q2IAjGMuqh78nicx/images/build-docs/create/share-with-remix/web-browser/remix-preview-page-light.webp?fit=max&auto=format&n=q2IAjGMuqh78nicx&q=85&s=f1ff2fb755c919b3a622e39f5adfe758" alt="Remix link preview page showing the task title, description, view count, Remix in Rocket button, and a live preview of the app on the right." className="theme-image" width="1440" height="900" data-path="images/build-docs/create/share-with-remix/web-browser/remix-preview-page-light.webp" />
        </Frame>

        Click **Remix in Rocket** to clone the entire task to your account.

        <Check>
          **Success check:** You will be redirected to your new task with a confirmation message.
        </Check>
      </Step>

      <Step title="Add your credentials">
        After cloning, add any required API keys or credentials for integrations used in the project (Supabase, Stripe, OpenAI, etc.).

        <Note>
          Environment variables and integration keys are automatically removed from remix links for security. You must provide your own.
        </Note>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Mobile App">
    <Note>
      **Mobile app limitation:** Remix links are not available on the mobile app. Use the web browser to create and use remix links.
    </Note>
  </Tab>
</Tabs>

<Divider />

## What's next?

<CardGroup cols={2}>
  <Card title="Iterate with chat" icon="messages" href="/build/editor/chat">
    Customize the cloned project using natural language.
  </Card>

  <Card title="Connectors" icon="puzzle-piece" href="/build/connectors/overview">
    Add your own API keys to activate the integrations.
  </Card>

  <Card title="Using templates" icon="layer-plus" href="/build/create/using-templates">
    Browse Rocket's built-in template library for more starting points.
  </Card>

  <Card title="Launch your app" icon="desktop" href="/build/launch-web/launch-your-site">
    Publish the task to the web once you have made it yours.
  </Card>
</CardGroup>
