---
myst:
  html_meta:
    "description": "Connect Remix IDE to Foundry Anvil, use Foundry remappings, and deploy contracts to a local Anvil node."
    "keywords": "remix foundry, anvil, foundry remappings, local deployment, ethereum"
---

# Foundry

[Foundry](https://www.getfoundry.sh/) is an Ethereum development toolkit for compiling, testing, and deploying Solidity smart contracts. With **Remix Desktop**, you can connect to a local Foundry project folder and deploy to a local Anvil chain. These features are not available on the online IDE, you must use {doc}`Remix Desktop <desktop/>` to access them.

## Deploying to Anvil

To deploy to Anvil, Foundry's local test chain, Anvil needs to be installed and running on your computer.

```{note}
You can install Anvil by following the instructions in [this guide](https://www.getfoundry.sh/introduction/installation).
```

Then, start `Anvil` by running the command below in the Remix Desktop terminal:

```shell
anvil
```

![Running the anvil command in the Remix Desktop terminal](images/foundry/anvil-command.png)

Then select **Foundry Provider** in the **Environments** section of the **Deploy & Run** module.

![Foundry Provider option in the Environment dropdown](images/foundry/a-foundry-provider.png)

As soon as you select **Foundry Provider**, a modal is opened asking for the **Anvil JSON-RPC Endpoint**.

![Modal prompting for the Anvil JSON-RPC Endpoint](images/foundry/a-foundry-provider-modal.png)

If the Anvil node is running with default options, the default endpoint value in the modal doesn't need to be changed. If the Anvil node host and port are different, the JSON-RPC endpoint should be updated in the modal's text box.

Once the correct endpoint is filled in the modal, click **OK** and the accounts from the Anvil node will be loaded in the **ACCOUNT** section. The network id will also be shown.

![Remix IDE connected to Foundry Provider showing loaded accounts](images/foundry/a-foundry-provider-connected.png)

Now, you can start deploying the contract from Remix IDE to the local Anvil node as usual.

## Foundry remappings

Foundry manages dependencies using git submodules and can remap dependencies to make them easier to import. So imports defined by remappings can have compilation errors on Remix IDE.

To support such compilation, Remix suggests running [compilation using a compiler config file](https://remix-ide.readthedocs.io/en/latest/compile.html#json-file-for-compiler-configuration). Remix adds some default Forge remappings in the compiler config file when a Foundry project is loaded on Remix Desktop.

![Compiler config file with default Forge remappings](images/foundry/a-foundry-cc.png)

Further, more remappings can be added manually if required.