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

# Remix a project

> Make your own independent copy of a project, control who can remix yours, and know exactly what a copy includes and what it leaves behind.

Remixing creates your own independent copy of a project. The copy is a new project that you own, and changes you make to it never affect the original. The original's owner can't see, change, or take back your copy.

<Frame>
  <img src="https://cdn.vibely.sh/doc/v1/projects-remix.webp" alt="Remix a project" width="1200" height="675" />
</Frame>

## Why remix a project

* **Duplicate your own work**: Keep a safe copy before a big change, or spin off a variation of an app you already built.
* **Start from a public project**: Use someone else's remixable project as a starting point instead of building from scratch.
* **Get a copy into another workspace**: Remixing is the way to take a copy of a project you can open into the workspace you're working in.

## Control who can remix your project

The **Enable public remixing** setting in [project settings](/features/projects/settings#access-and-sharing) controls whether people outside your project can make their own copy from its link. It's off by default.

* **Off**: Only people who can already open the project in the editor can remix it: you, members of its workspace who have access, and invited collaborators.
* **On**: Anyone with the project link can see a preview of the **latest version** of your app and make their own copy. Nobody gains access to your project itself.

Turning it on shows the project link with a **Copy link** button. You can turn public remixing off again at any time; copies people already made stay theirs.

### What visitors see

Public remixing doesn't add people as collaborators and doesn't give them access to your editor or your project chat. Someone who opens a remixable project's link sees a preview of your app and a **Remix** button. If they aren't signed in, Vibely asks them to sign up or sign in when they click **Remix**, then finishes the copy for them.

Both the preview and every copy are the **latest version** of your project, including changes you haven't published. Your project doesn't need to be published for people to open the link.

<Warning>
  A copy contains your project's files, so anyone who remixes your project can read all of its source code. Make sure it doesn't contain passwords, API keys, or personal data. Your secrets and connected services are never copied.
</Warning>

To let people see your app without letting them copy it, share a [preview link](/features/collaboration/sharing) instead.

## How to remix

* **From the dashboard**: Open a project card's **⋯** menu and choose **Remix**.
* **From a public project link**: Open the link and click **Remix**.

Vibely creates the copy right away, names it **Remix of** followed by the original name, and opens it with a first message already sent, so you land in a running chat rather than an empty one. Rename the copy any time from [project settings](/features/projects/settings).

The copy is created in the workspace you currently have selected, and members of that workspace can see it. To put the copy in a different workspace, switch to that workspace first. You can remix up to 10 times per hour.

## What carries over

A remix copies your app's code and leaves behind everything tied to the original's identity, like its live URL, its collaborators, and its connections.

**Carries over to the copy:**

* Every file in the project, from the latest version
* Web or mobile mode
* The project description
* [Project knowledge](/features/context/knowledge), when you can open the original in the editor: you, members of its workspace who have access, and invited collaborators

**Does not carry over:**

* `.env` files and other secret files (example files like `.env.example` are kept)
* Project knowledge, when you remix a public project you can't open in the editor. Knowledge becomes instructions Vibely follows in the copy, so it only comes along from projects you already have access to.
* The chat history
* Version history: the copy starts fresh
* The Supabase connection and your database data
* The connected GitHub repository
* The published URL, custom domains, and deployment history
* Collaborators, preview links, and access settings
* Connector connections

In practice, the copy is your app's code with a clean slate around it. If the app relies on Supabase or other services, reconnect them and add their credentials again in the copy before your next build message.

<Note>
  Because `.env` files are left out, a remix of your own project starts with no credentials either. This is on purpose: a copied `.env` would point the remix at the original project's database.
</Note>

## Remix a mobile project

A remix of a mobile project stays a mobile project, with the same phone preview and store build path. Creating one needs the same plan as creating a new mobile project.

Store credentials and the store listing are not copied. The app configuration file is, so the bundle identifier and package name come across unchanged. Change them in the copy before you build, or your build will collide with the original app. See [Ship to the stores](/features/mobile-apps/ship).

## FAQ

<AccordionGroup>
  <Accordion title="Does the copy stay in sync with the original?">
    No. A remix is a snapshot of the project at the moment you remix it. Changes to the original never reach the copy, and changes to the copy never affect the original.
  </Accordion>

  <Accordion title="Can I remix a deleted project?">
    No. Deleting a project is permanent. If you want a backup, remix the project before deleting it.
  </Accordion>

  <Accordion title="Do people need a Vibely account to open my remixable project link?">
    No. Anyone with the link can open it and see a preview of the latest version of your app. Making a copy requires signing in or creating an account.
  </Accordion>

  <Accordion title="Can people with the link see my project chat?">
    No. The link shows a preview of the app and a **Remix** button. Your chat history is never copied, and your project knowledge isn't copied for people who reach the project only through its public link. Anyone who makes a copy does get your code, and can read it in their copy.
  </Accordion>

  <Accordion title="Why can't I remix a project?">
    The most common reasons are:

    * The owner hasn't turned on **Enable public remixing**, and you can't open the project in the editor.
    * The project's workspace has turned off **Project transfers** in [Privacy & security](/features/workspace/privacy-security), which stops copies from leaving that workspace. You can still remix it into that same workspace: switch to it, then remix.
    * It's a mobile project and your plan doesn't include mobile apps.
    * You've remixed 10 projects in the last hour. Wait a while and try again.
  </Accordion>
</AccordionGroup>

## Related topics

<CardGroup cols={2}>
  <Card title="Project settings" icon="gear" href="/features/projects/settings">
    Turn public remixing on or off.
  </Card>

  <Card title="Sharing" icon="share-nodes" href="/features/collaboration/sharing">
    Preview links and published-site access.
  </Card>

  <Card title="Templates" icon="layer-group" href="/features/design/workspace-templates">
    Start from a working app.
  </Card>

  <Card title="Privacy & security" icon="lock" href="/features/workspace/privacy-security">
    Workspace rules for project transfers.
  </Card>
</CardGroup>


## Related topics

- [Projects in Vibely](/features/projects/overview.md)
- [Project settings](/features/projects/settings.md)
- [Vibely workspace](/features/workspace/overview.md)
- [FAQ](/faq.md)
- [Undo and restore with version history](/features/projects/history.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.