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

# Installation

> Set up EasyCode Flow.

EasyCode Flow is an **IDE for vibe coders**. Unlike web based app builders, EasyCode Flow needs to be installed on your operating system.

This provides many benefits:

* you have full control of the development environment
* you have full ownership of the codebase
* you have full access to IDE features

## Download

<Warning>
  This is a beta release. Please report any issues you encounter to help us improve the software.
</Warning>

<Tabs>
  <Tab title="MacOS">
    <CardGroup cols={2}>
      <Card title="Apple Silicon" icon="download" horizontal href="https://update.easycode.ai/download/stable/b1f034d572336bd0f1c855c997973d52230612d4/EasyCode-Installer.dmg">
        M Series Macs
      </Card>

      <Card title="Apple Intel" icon="download" horizontal disabled>
        Not supported right now
      </Card>
    </CardGroup>

    1. Download the correct installer from above.
    2. Open the installer, move EasyCode to the Applications folder.
    3. Open EasyCode.

    <Frame height="100%">
      <img src="https://mintcdn.com/easycode/YN5Y-hzbFl3k9ffW/images/quick-start/install-macos.gif?s=367bbadfaa6a19e21bada59e85578acc" alt="MacOS Installation GIF" style={{height: '100%', width: '100%', objectFit: 'contain'}} width="800" height="477" data-path="images/quick-start/install-macos.gif" />
    </Frame>

    ## Initial Set Up

    EasyCode requires **NodeJS** and **Git** to function properly.

    <Frame height="100%">
      <img src="https://mintcdn.com/easycode/YN5Y-hzbFl3k9ffW/images/quick-start/setup.jpg?fit=max&auto=format&n=YN5Y-hzbFl3k9ffW&q=85&s=68693142295f2ff3277156d02f777bcd" alt="Initial Setup Screenshot" style={{height: '100%', width: '100%', objectFit: 'contain'}} width="2484" height="1268" data-path="images/quick-start/setup.jpg" />
    </Frame>

    If they are not installed, EasyCode will guide you through the installation.

    <Note>
      During Git installation, you will asked to include `xcode-select`, make sure to **Accept**. This step will take 5-10 minutes but is the only official to install **Git**.

      <Frame height="100%">
        <img src="https://mintcdn.com/easycode/YN5Y-hzbFl3k9ffW/images/quick-start/macos.png?fit=max&auto=format&n=YN5Y-hzbFl3k9ffW&q=85&s=4f908d60d6c21c1dabb2219071708fec" alt="Xcode Select Prompt" style={{height: '100%', width: '100%', objectFit: 'contain'}} width="1584" height="1190" data-path="images/quick-start/macos.png" />
      </Frame>
    </Note>
  </Tab>

  <Tab title="Windows">
    <CardGroup cols={2}>
      <Card title="Windows x64" icon="download" horizontal href="https://update.easycode.ai/download/stable/b1f034d572336bd0f1c855c997973d52230612d4/EasyCode-Installer.exe">
        Most Win 10/11 devices
      </Card>

      <Card title="Windows arm64" icon="download" horizontal disabled>
        Not supported right now
      </Card>
    </CardGroup>

    1. Download the correct Windows installer from above.

           <Info>
             You may need to bypass Browser security to download the file.
           </Info>
    2. Bypass Windows Security if necessary.
    3. Open the installer and follow the instructions.

    ## Initial Set Up

    EasyCode requires **NodeJS** and **Git** to function properly.

    <Frame height="100%">
      <img src="https://mintcdn.com/easycode/YN5Y-hzbFl3k9ffW/images/quick-start/setup.jpg?fit=max&auto=format&n=YN5Y-hzbFl3k9ffW&q=85&s=68693142295f2ff3277156d02f777bcd" alt="Initial Setup Screenshot" style={{height: '100%', width: '100%', objectFit: 'contain'}} width="2484" height="1268" data-path="images/quick-start/setup.jpg" />
    </Frame>

    If they are not installed, EasyCode will guide you through the installation.

    <Note>
      You will be prompted to give `Electron` and `NodeJS` network access during installation, make sure to **Accept**.

      <Frame height="100%">
        <img src="https://mintcdn.com/easycode/YN5Y-hzbFl3k9ffW/images/quick-start/electron.png?fit=max&auto=format&n=YN5Y-hzbFl3k9ffW&q=85&s=479b33b8a54225cc3d28806d6a132a05" alt="Electron Network Access Prompt" style={{height: '100%', width: '100%', objectFit: 'contain'}} width="1446" height="1082" data-path="images/quick-start/electron.png" />
      </Frame>
    </Note>
  </Tab>

  <Tab title="Linux">
    Linux is currently not supported.
  </Tab>
</Tabs>

## Common Installation Problems

<AccordionGroup>
  <Accordion title="I cannot download the installer file.">
    **Step 1: Check for browser notifications**

    Some browsers can silently block large files or ask for download permission. Check for any browser notifications.

    <Frame height="100%">
      <img src="https://mintcdn.com/easycode/YN5Y-hzbFl3k9ffW/images/keep-download.gif?s=f68cb4db4639e24364d98c60a8ca172e" alt="Keep Download" style={{height: '100%', width: '100%', objectFit: 'contain'}} width="958" height="480" data-path="images/keep-download.gif" />
    </Frame>

    **Step 2: Try a different browser**

    Some users who use Brave or Arc have reported issues with downloading the installer. Try using Chrome or Safari.

    **Step 3: Try direct download**

    If you continue to experience issues, you can try downloading directly from these links:

    * [Windows x64 Installer (Direct Download)](https://update.easycode.ai/download/stable/b1f034d572336bd0f1c855c997973d52230612d4/EasyCode-Installer.exe)
    * [Mac Silicon Installer (Direct Download)](https://update.easycode.ai/download/stable/b1f034d572336bd0f1c855c997973d52230612d4/EasyCode-Installer.dmg)
  </Accordion>

  <Accordion title="Installation fails due to errors">
    This is likely caused by NodeJS or Git not being installed correctly. If installation fails after multiple attempls, please try installing NodeJS and Git manually.

    You can find the official NodeJS and Git installation instructions below:

    * [NodeJS Official Download](https://nodejs.org/en/download)
    * [Git Official Download](https://git-scm.com/downloads)
  </Accordion>
</AccordionGroup>