# Source: https://docs.replit.com/getting-started/quickstarts/remix-an-app.md

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

# Remix an App

> Learn how to create a **Remix** as a starting point for your app. A Remix is a Replit App started from a publicly shared Replit App.

## Create your Remix

⏰ *Estimated time: 1 minute*

Follow the steps in this guide to create a Remix of the following solar system visualization:

<Frame>
  <img src="https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_app_preview.png?fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=2b22cccdd1616aeec84b9ba52b0656a2" alt="image of the Remix button on the Replit App page" data-og-width="3732" width="3732" data-og-height="2100" height="2100" data-path="images/getting-started/quickstart_remix_app_preview.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_app_preview.png?w=280&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=a9fcb3ca94edf00a32695a3d562d1689 280w, https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_app_preview.png?w=560&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=5b6dd0ac9f05783d01e34b06174a86ef 560w, https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_app_preview.png?w=840&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=8263df2809884cb319df978dff880ae9 840w, https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_app_preview.png?w=1100&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=221280ae664ea6bd3eb777bc067a2a80 1100w, https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_app_preview.png?w=1650&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=99119ebd6a053fe89c0dbe92eebcd5ab 1650w, https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_app_preview.png?w=2500&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=bb9e56fbe9ab7b38bc83624507c1fd67 2500w" />
</Frame>

<Tip>
  Try the published app at [Solar System Visualization Demo Replit
  App](https://replit.com/@matt/Solar-System-Visualization).
</Tip>

<Steps>
  <Step title="Remix the app">
    Open the [Solar System Visualization](https://replit.com/@matt/Solar-System-Visualization?v=1) Replit App in your browser
    and select **Remix Template**:

    <img src="https://mintcdn.com/replit/0UCOQvZyQpUEM03B/images/shared/buttons/remix_button.png?fit=max&auto=format&n=0UCOQvZyQpUEM03B&q=85&s=8a951b014e4eea31767bbf22c18d7ec2" width="300" alt="image of the Remix button on the Replit App page" data-og-width="228" data-og-height="36" data-path="images/shared/buttons/remix_button.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/replit/0UCOQvZyQpUEM03B/images/shared/buttons/remix_button.png?w=280&fit=max&auto=format&n=0UCOQvZyQpUEM03B&q=85&s=9e8687fcc4076b0bc7c2a4e302142cfb 280w, https://mintcdn.com/replit/0UCOQvZyQpUEM03B/images/shared/buttons/remix_button.png?w=560&fit=max&auto=format&n=0UCOQvZyQpUEM03B&q=85&s=31c9ef4b6f3ec486a4f9f50becf9cb3a 560w, https://mintcdn.com/replit/0UCOQvZyQpUEM03B/images/shared/buttons/remix_button.png?w=840&fit=max&auto=format&n=0UCOQvZyQpUEM03B&q=85&s=d43ec4837c3e47fe8dff411e83fd47a7 840w, https://mintcdn.com/replit/0UCOQvZyQpUEM03B/images/shared/buttons/remix_button.png?w=1100&fit=max&auto=format&n=0UCOQvZyQpUEM03B&q=85&s=6d419c6968dc0b605e2050fbb09b147a 1100w, https://mintcdn.com/replit/0UCOQvZyQpUEM03B/images/shared/buttons/remix_button.png?w=1650&fit=max&auto=format&n=0UCOQvZyQpUEM03B&q=85&s=7cb4952ca0f450271043a29d4d1465b2 1650w, https://mintcdn.com/replit/0UCOQvZyQpUEM03B/images/shared/buttons/remix_button.png?w=2500&fit=max&auto=format&n=0UCOQvZyQpUEM03B&q=85&s=17d60c5ebec7b3b331aacc582d20e49a 2500w" />
  </Step>

  <Step title="Complete the app details">
    In the **Remix App** dialog, select **Remix App** to continue. You can edit these details later.

    <Frame>
      <img src="https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_dialog.png?fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=7d2b6ac64b7bf6fb72a7372cb6f2352d" alt="image of the Remix App dialog" data-og-width="1026" width="1026" data-og-height="1002" height="1002" data-path="images/getting-started/quickstart_remix_dialog.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_dialog.png?w=280&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=b8dbde047efe26339dfe1b249ae32de3 280w, https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_dialog.png?w=560&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=dadfb2a6f406d4fda18581d6dc6f2249 560w, https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_dialog.png?w=840&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=2a91a28641ca0a7621c10fe4ed84cae9 840w, https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_dialog.png?w=1100&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=495470d92068519d42d1ccee4dacc531 1100w, https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_dialog.png?w=1650&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=0dcc734dbaee39b04e8ac2cb8e694de2 1650w, https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_dialog.png?w=2500&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=c7310a6150919852b3b87cba7448eabf 2500w" />
    </Frame>
  </Step>

  <Step title="Start the app">
    Select **Run** to start the app:

    <img src="https://mintcdn.com/replit/0UCOQvZyQpUEM03B/images/shared/buttons/run_button.png?fit=max&auto=format&n=0UCOQvZyQpUEM03B&q=85&s=0f045185e312ee3578d93ac2332755b8" width="100" alt="image of the Run button" data-og-width="132" data-og-height="64" data-path="images/shared/buttons/run_button.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/replit/0UCOQvZyQpUEM03B/images/shared/buttons/run_button.png?w=280&fit=max&auto=format&n=0UCOQvZyQpUEM03B&q=85&s=6de173e07f31108d56332e6ea67507ce 280w, https://mintcdn.com/replit/0UCOQvZyQpUEM03B/images/shared/buttons/run_button.png?w=560&fit=max&auto=format&n=0UCOQvZyQpUEM03B&q=85&s=87a43869028b584412d448c76ee721c7 560w, https://mintcdn.com/replit/0UCOQvZyQpUEM03B/images/shared/buttons/run_button.png?w=840&fit=max&auto=format&n=0UCOQvZyQpUEM03B&q=85&s=fe3b88e5b8869d952a837f3944da5a1f 840w, https://mintcdn.com/replit/0UCOQvZyQpUEM03B/images/shared/buttons/run_button.png?w=1100&fit=max&auto=format&n=0UCOQvZyQpUEM03B&q=85&s=35bd09b90b96c4eceb27386982efcba8 1100w, https://mintcdn.com/replit/0UCOQvZyQpUEM03B/images/shared/buttons/run_button.png?w=1650&fit=max&auto=format&n=0UCOQvZyQpUEM03B&q=85&s=ba9f1126a352ecb46df0013279ecd9cc 1650w, https://mintcdn.com/replit/0UCOQvZyQpUEM03B/images/shared/buttons/run_button.png?w=2500&fit=max&auto=format&n=0UCOQvZyQpUEM03B&q=85&s=8d72cbe4b105fe39b5d4a33e067a7688 2500w" />

    Navigate to the **Preview** tab to confirm the app displays animated planets.

    <Frame>
      <img src="https://mintcdn.com/replit/rBzGsKp9NcWJ7sib/images/getting-started/solar_system_webview.webp?fit=max&auto=format&n=rBzGsKp9NcWJ7sib&q=85&s=c5b7c2d86c9dd5025bedb952ad4879d1" alt="animated image of the Preview tab in the Solar System Visualization" data-og-width="800" width="800" data-og-height="450" height="450" data-path="images/getting-started/solar_system_webview.webp" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/replit/rBzGsKp9NcWJ7sib/images/getting-started/solar_system_webview.webp?w=280&fit=max&auto=format&n=rBzGsKp9NcWJ7sib&q=85&s=47b033cc057a921737961b490dd4d7db 280w, https://mintcdn.com/replit/rBzGsKp9NcWJ7sib/images/getting-started/solar_system_webview.webp?w=560&fit=max&auto=format&n=rBzGsKp9NcWJ7sib&q=85&s=b825a1b6ebc08c3b8368224d229c932d 560w, https://mintcdn.com/replit/rBzGsKp9NcWJ7sib/images/getting-started/solar_system_webview.webp?w=840&fit=max&auto=format&n=rBzGsKp9NcWJ7sib&q=85&s=2b3ed3b56a3cd8240e2e8810e3a5e07e 840w, https://mintcdn.com/replit/rBzGsKp9NcWJ7sib/images/getting-started/solar_system_webview.webp?w=1100&fit=max&auto=format&n=rBzGsKp9NcWJ7sib&q=85&s=c8f15f2a5b89d2fe06f030250408c492 1100w, https://mintcdn.com/replit/rBzGsKp9NcWJ7sib/images/getting-started/solar_system_webview.webp?w=1650&fit=max&auto=format&n=rBzGsKp9NcWJ7sib&q=85&s=63f6a7703b683ab97ab42139d469cf7d 1650w, https://mintcdn.com/replit/rBzGsKp9NcWJ7sib/images/getting-started/solar_system_webview.webp?w=2500&fit=max&auto=format&n=rBzGsKp9NcWJ7sib&q=85&s=8ea3bb9747c28baeebe5395565353db4 2500w" />
    </Frame>
  </Step>

  <Step title="Interact with the app">
    You now have a fully functioning Remix that you can interact with and iteratively improve.

    To interact with the visualization, try the following controls in the **Preview** tab:

    * Drag to rotate the view
    * Scroll to zoom in and out
    * Click a planet to select it
    * Select **Planet info** while a planet is selected to view information about it
    * Select **Pause Rotation** or **Start Rotation** to toggle the animation

    Select Earth and then select **Planet Info** to read facts about it.
  </Step>
</Steps>

## Explore

Try the tasks in the following sections to learn how **Agent**,
Replit's AI-powered tool, can help you build your app.

Agent specializes in building projects from scratch and making changes to a Replit App. Use [Fast mode](/replitai/fast-mode) for quick, targeted edits.

<Note>
  Agent relies on popular AI models and occasionally produces
  results that don't fulfill your request. If you encounter issues, follow up
  with a prompt that describes the error messages or the incorrect behavior.
  Alternatively, you can use the Rollback feature to restore your Replit App to
  a previously known working state.
</Note>

The following sections show examples of using Agent to enhance this Remix.

### Add a feature using Agent

<Tip>
  Agent is now available on all projects, including Remixes. Use [General Agent](/replitai/general-agent) to work with any framework or project type.
</Tip>

Follow these steps to add a complex feature to your Remix using Agent:

<Steps>
  <Step title="Craft a prompt">
    Navigate to the **Agent** tab.

    Enter the following prompt in the text area:

    ```text  theme={null}
    Add a button that toggles an autopilot flyby mode.
    ```

    After you submit the prompt, Agent might pause and ask for clarification or confirmation. Respond in the text area.
  </Step>

  <Step title="Test the feature">
    Navigate to the **Preview** tab to see Agent's updates to the visualization.

    Try toggling the added autopilot button.

    Since the initial prompt excluded information such as speed and position of the flyby, the result might not
    match your expectations.
  </Step>

  <Step title="Refine the feature">
    If the feature differs from your expectations, continue the conversation by entering the following prompt
    in the **Agent** text area:

    ```text  theme={null}
    Change the autopilot to slowly and continuously fly between planets.
    ```

    After Agent completes the feature, the **Preview** might resemble the following image:

    <Frame>
      <img src="https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_app_preview.png?fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=2b22cccdd1616aeec84b9ba52b0656a2" alt="image of the Remix button on the Replit App page" data-og-width="3732" width="3732" data-og-height="2100" height="2100" data-path="images/getting-started/quickstart_remix_app_preview.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_app_preview.png?w=280&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=a9fcb3ca94edf00a32695a3d562d1689 280w, https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_app_preview.png?w=560&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=5b6dd0ac9f05783d01e34b06174a86ef 560w, https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_app_preview.png?w=840&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=8263df2809884cb319df978dff880ae9 840w, https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_app_preview.png?w=1100&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=221280ae664ea6bd3eb777bc067a2a80 1100w, https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_app_preview.png?w=1650&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=99119ebd6a053fe89c0dbe92eebcd5ab 1650w, https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_app_preview.png?w=2500&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=bb9e56fbe9ab7b38bc83624507c1fd67 2500w" />
    </Frame>

    To undo these changes, select **Rollback to here** in the Checkpoint created immediately
    after starting the plan for the change in the **Agent** tab.

    Learn more about [Checkpoints and Rollbacks](/replitai/checkpoints-and-rollbacks).
  </Step>
</Steps>

### Add a feature using Fast mode

Follow these steps to add a quick enhancement to your Remix using [Fast mode](/replitai/fast-mode):

<Steps>
  <Step title="Craft a prompt">
    Switch to [Fast mode](/replitai/fast-mode) and enter the following prompt:

    ```text  theme={null}
    Add a button that changes the planet orbit speeds to 0.5x, 1x, and 2x.
    ```

    After you submit the prompt, Agent describes the changes it wants to make and lets you review the code changes before proceeding.
    Select **Preview code changes** to view a comparison of the current code and the updates.
  </Step>

  <Step title="Test the feature">
    Select **Apply all** and approve any following confirmations to continue.

    Navigate to the **Preview** tab to check the result.

    After Agent completes the feature, the **Preview** might resemble the following image:

    <Frame>
      <img src="https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_assistant_result.png?fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=54d2f6e5a2bd9d654898245a6ee9ba4a" alt="image of the solar system visualization with speed controls" data-og-width="932" width="932" data-og-height="645" height="645" data-path="images/getting-started/quickstart_remix_assistant_result.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_assistant_result.png?w=280&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=f2412ad5f6910e265f6650d470f859d4 280w, https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_assistant_result.png?w=560&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=94b6ae810c0eb2cf33131db674c4d9c5 560w, https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_assistant_result.png?w=840&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=439fb5041217504e27012e997d681207 840w, https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_assistant_result.png?w=1100&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=cfd56daf737804b1e2a43a0e5267a0d3 1100w, https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_assistant_result.png?w=1650&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=68f08585bf51164d1a5af59f2d54d020 1650w, https://mintcdn.com/replit/h9U_mFqw8XzNXJwv/images/getting-started/quickstart_remix_assistant_result.png?w=2500&fit=max&auto=format&n=h9U_mFqw8XzNXJwv&q=85&s=1d92b70b96ae1fb84881e3375df34edb 2500w" />
    </Frame>

    To undo these changes, use the Rollback feature in the **Agent** tab.
  </Step>
</Steps>

## Continue your journey

Now that you've completed this tutorial, you're ready to explore more possibilities with your Replit App.
Try the following next steps to enhance your skills:

* Ask Agent to implement a new complex feature or to check the code for bugs.
* Use [Fast mode](/replitai/fast-mode) for quick, targeted edits and code explanations.
* View and edit the Replit App source code and configuration in the **Files** tab.
* Share your Replit App for others to remix. To learn more, see [Make your Replit App Public](/replit-app/collaborate#make-your-replit-app-public).