Working on an Existing Project

Foundry makes developing with existing projects have no overhead.

For this example, we will use PaulRBerg’s foundry-template.

First, clone the project and run forge install inside the project directory.

$ git clone https://github.com/PaulRBerg/foundry-template
$ cd foundry-template 
$ forge install

We run forge install to install the submodule dependencies that are in the project.

To build, use forge build:

$ forge build
Compiling 23 files with 0.8.23
Solc 0.8.23 finished in 4.36s
Compiler run successful!

And to test, use forge test:

$ forge test
No files changed, compilation skipped

Running 3 tests for test/Foo.t.sol:FooTest
[PASS] testFork_Example() (gas: 3759)
[PASS] testFuzz_Example(uint256) (runs: 1000, μ: 8402, ~: 8402)
[PASS] test_Example() (gas: 8676)
Test result: ok. 3 passed; 0 failed; 0 skipped; finished in 385.71ms
 
Ran 1 test suites: 3 tests passed, 0 failed, 0 skipped (3 total tests)

Foundry Book

Working on an Existing Project