---
description: Configure Foundry with foundry.toml, profiles, and environment variables.
---

import { Cards, Card } from "vocs";

## Configuration

Foundry uses `foundry.toml` for project configuration. This file controls compiler settings, test behavior, formatting rules, and more.

### Quick start

A minimal configuration:

```toml [foundry.toml]
[profile.default]
src = "src"
out = "out"
libs = ["lib"]
solc_version = "0.8.28"
```

View your resolved configuration:

```bash
$ forge config
```

### Key capabilities

| Feature                   | Description                                                       |
| ------------------------- | ----------------------------------------------------------------- |
| **Profiles**              | Switch between configurations for development, CI, and production |
| **Environment variables** | Override settings without modifying files                         |
| **Global config**         | Share settings across all your projects                           |
| **Remappings**            | Customize import paths for dependencies                           |

### Learn more

<Cards>
  <Card
    title="Profiles"
    description="Configure different settings for development, CI, and production."
    to="/config/profiles"
  />
  <Card
    title="CI Integration"
    description="Set up GitHub Actions and other CI systems."
    to="/config/ci"
  />
  <Card
    title="Editor Setup"
    description="Configure VS Code and other editors for Foundry projects."
    to="/config/editors"
  />
  <Card
    title="Compiler and optimizer"
    description="Tune solc settings, via IR, and dynamic test linking."
    to="/config/reference/solidity-compiler"
  />
  <Card
    title="Testing configuration"
    description="Control fuzzing, invariants, and test behavior."
    to="/config/reference/testing"
  />
  <Card
    title="MESC"
    description="Manage RPC endpoints across all your crypto tools from a single config file."
    to="/config/mesc"
  />
  <Card
    title="Configuration Reference"
    description="Complete reference for all configuration options."
    to="/config/reference/overview"
  />
</Cards>
