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

# Deploy

> Learn how app deployment works on Same.new. Deploy full-stack apps built with prompts, no infrastructure setup or configuration needed.

Deployment brings your project **online**. Same integrates with [Netlify](https://www.netlify.com/) to generate a permanent domain that anyone can access. You can claim the deployment to take control and customize the domain.

## Trigger deployment

Same often deploys automatically when a task seems complete. You can also directly tell Same to deploy at any point:

```md theme={null}
Deploy my project
```

Same will automatically clean up your code, solve errors, and deploy for you.

<Note>
  If the deployment attempt failed, just tell Same to debug and retry: `md My
      deployment failed, debug and retry `
</Note>

## Deployment URLs

After deployment, you'll get:

1. **Preview Domain:** A unique URL for that specific deployment. Good for testing.
2. **Main Domain:** The primary project URL that stays updated with your latest deployed version.

<Tip>
  Share your main domain with friends or on social media to let others visit
  your site. You can always find the domain by clicking Deployed button.
</Tip>

<Frame>
  <img src="https://mintcdn.com/same/6v_Kyyhq-0v66NVR/images/deploy-this.png?fit=max&auto=format&n=6v_Kyyhq-0v66NVR&q=85&s=046a21a899e4ae7e1adf55794a8f676e" width="1018" height="766" data-path="images/deploy-this.png" />
</Frame>

## Claim deployment

You can claim deployment in Netlify to transfer the site to your own account and setup domains.

**To claim the deployment**

1. Click **Deployed** button
2. Click <Icon icon="key" /> **Claim Deployment**
3. You will be redirected to Netlify, follow the instructions to claim

<Note>
  Domain customization is not yet available within Same. Claim your project via
  Netlify and follow their domain setup instructions.
</Note>

<Frame>
  <img src="https://mintcdn.com/same/6v_Kyyhq-0v66NVR/images/deploy.png?fit=max&auto=format&n=6v_Kyyhq-0v66NVR&q=85&s=7735a735bd999623b9a74642df0d0192" width="1160" height="796" data-path="images/deploy.png" />
</Frame>

## Manage deployment

You can take down the deployment to unpublish your project. A project taken down can be redeployed, and the main domain stays the same.

**To take down deployment**

1. Click **Deployed** button
2. Click <Icon icon="unlink" /> **Take down**

**To redeploy**

1. Click **Deploy** button
2. Click <Icon icon="rotate-ccw" /> **Redeploy**

## Troubleshooting deployment issues

If your deployment fails with an error message, there are several common causes and solutions to try.

<Warning>
  **Build failed during deployment. Build the project locally to reproduce and fix the errors.**

  This error can occur when there are issues with your deployment configuration or account limits.
</Warning>

To troubleshoot this error, check the following:

1. **Have you claimed the deployment for this project?**

   When you claim a deployment, all future deployments for that project will use your own Netlify account and credits. Check if you've claimed this project's deployment:

   * Click **Deployed** button to see deployment status
   * If it shows as claimed, you're using your own Netlify resources

   Learn more about [claiming your deployment](#claim-deployment) above.

2. **Have you run out of free credits in your Netlify account?**

   If you've claimed this project's deployment, check your Netlify account to see if you've exhausted your build minutes. Claimed deployments use your own Netlify resources, which have limits on free plans.

   <Note>
     Unclaimed deployments use Same's Netlify resources and are free to you. If
     your deployment isn't claimed, credit issues are unlikely the cause.
   </Note>

3. **Solutions to resolve credit issues:**

   If you've claimed the deployment and run out of Netlify credits, you have two options:

   * **Top up your Netlify credits:** Log into your Netlify account and add more build minutes to your plan
   * **Remix your project on Same:** Create a fresh copy of your project with a new, unclaimed deployment that uses Same's resources

   <Tip>
     Remixing creates a new project with its own unclaimed deployment. This
     gives you a fresh start with deployments handled by Same's infrastructure.
     Learn more about [remixing projects](/essentials/project-management#remix).
   </Tip>

If the issue persists after checking these items, contact our support team at [support@same.new](mailto:support@same.new) and include the link to your project (example: [https://same.new/chat/project-id](https://same.new/chat/project-id)).

## FAQ

<AccordionGroup>
  <Accordion title="Why should I deploy?">
    Deploying your project has several benefits:

    1. **Share with Others:** Make your project accessible to anyone through a public URL
    2. **Test in Production:** Verify your project works in a real environment
    3. **Version Control:** Each deployment creates a snapshot you can return to
    4. **Professional Presentation:** Show your work to clients or employers with a live site

    <Tip>
      Deploy early and often to catch issues and gather feedback from real users.
    </Tip>
  </Accordion>

  <Accordion title="Can I deploy my site elsewhere?">
    Currently, Same doesn't support deploying to other platforms natively. However, you have two options:

    1. **Download your project:**
       * Download the code and deploy it manually to your preferred platform
       * Follow the platform-specific deployment instructions

    <Note>
      Project download is a premium feature only available on paid plans.
    </Note>

    2. **Link with GitHub:**
       * Push your code to GitHub
       * Deploy from your GitHub repository using any hosting service
       * Maintain full control over your deployment process
  </Accordion>

  <Accordion title="How to customize the domain of my deployed project?">
    Currently, Same doesn't support custom domains natively. To use a custom domain:

    1. **Claim your project on Netlify:**
       * Deploy your project first through Same
       * Follow the claiming process on Netlify

    2. **Set up custom domain:**
       * Go to your site settings in Netlify
       * Follow Netlify's domain configuration process
  </Accordion>

  <Accordion title="Why should I claim my project?">
    Claiming your project on Netlify provides several key benefits:

    1. **Permanent URL:** Get a consistent, non-expiring URL for your site
    2. **Custom Domain:** Add your own domain name
    3. **Site Controls:** Access deployment settings and analytics
    4. **Team Access:** Share site management with collaborators

    Learn more about [claiming benefits on Netlify](https://docs.netlify.com/welcome/build-with-ai/prototyping-best-practices/#benefits-of-claiming-your-deployments).
  </Accordion>

  <Accordion title="What will happen if I don't claim my deployed project?">
    If you don't claim your deployed project:

    1. **Temporary Access:** Your project will remain accessible through the Same-generated URL
    2. **Limited Time:** The deployment will expire after 14 days of inactivity
    3. **Data Preservation:** Your project code and history remain safe in Same
    4. **Redeployment:** You can always redeploy the project to reactivate the URL

    <Warning>
      Unclaimed deployments expire after 14 days. To ensure continuous availability, either claim your project on Netlify or redeploy regularly.
    </Warning>
  </Accordion>
</AccordionGroup>