92/ 100 · A
A top-tier open source project. Docs, tests, and CI are all in excellent shape.
Foundry is a blazing fast, portable and modular toolkit for Ethereum application development written in Rust.
Rust10,423 starsApache-2.0updated 4d ago
DocumentationREADME, setup, examples, license
EngineeringTests, CI, linting, lockfiles
Project healthDescription, activity, stars, deps
What to fix first
The highest-impact improvements for this repo.
- 1CI/CDEngineeringInfo
Add `tsc --noEmit`, `mypy`, or `cargo check` to catch type errors before they merge.
- 2CI/CDEngineeringInfo
Upload coverage to Codecov, Coveralls, or report it with `--coverage` flags.
- 3READMEDocumentationInfo
Add CI/build status badges from shields.io or your CI provider to signal project health.
Detailed breakdown
Documentation
91- README90
- README is present.
- README is well structured with multiple sections.
- README includes screenshots or visuals. Great for first impressions.
- README has code examples.
- README links to a live demo or deployed app.
- No status badges in the README (−10 pts).Add CI/build status badges from shields.io or your CI provider to signal project health.
- Install and run instructions90
- README documents how to install the project.
- README documents how to run the project.
- If your project uses environment variables, add a .env.example listing them (+10 pts).Add a .env.example listing all required environment variables so contributors know what to set up.
- License100
- Licensed under Apache-2.0.
- Contributing guide86
- Contributing guide is detailed and thorough.
- Contributing guide lacks a setup section (−12 pts).Show new contributors how to get a local dev environment running.
- Contributing guide describes code style expectations.
- Contributing guide explains how to run tests.
- Contributing guide describes the PR/review workflow.
- Contributing guide includes code examples.
- Optional: add a Code of Conduct (+5 pts).A CODE_OF_CONDUCT.md signals that your project is welcoming. GitHub has a template you can add in one click.
Engineering
92- Tests90
- Test files detected (crates/anvil/tests).
- Rust workspace with test files detected. Run with `cargo test --workspace`.
- CI/CD100
Not applicable?
- CI is configured (.github/workflows/ci-mpp.yml).
- CI workflow runs tests.
- CI runs on pull requests, not just on pushes to main.
- CI workflow runs a lint or format check.
- Optional: add type checking to CI.Add `tsc --noEmit`, `mypy`, or `cargo check` to catch type errors before they merge.
- Optional: report test coverage in CI.Upload coverage to Codecov, Coveralls, or report it with `--coverage` flags.
- CI tests across multiple environments or versions.
- CI includes a build step.
- Linting and formatting60
- Linter or formatter configured (rustfmt.toml).
- Reproducibility100
- Lockfile present (Cargo.lock). Installs are reproducible.
- Environment pinned via Dockerfile.
- Dockerfile uses multi-stage builds (smaller, more secure images).
- Dockerfile runs as a non-root user.
- Dependabot covers 2 ecosystems (github-actions, cargo). Dependencies stay current.
- Issue and PR templates100
- Issue or PR templates present.
- Security policy present.
Project health
92- Dependency manifest100
- Dependency manifest found (Cargo.toml).
- Cargo.toml is a workspace manifest for a multi-crate Rust project.
- Repository metadata70
- Repository has a description.
- Primary language detected: Rust.
- Activity100
- Actively maintained (pushed within the last month).
- 10,423 stars.
- Housekeeping100
- .gitignore present.
Repository files28 root entries
- .cargo
- .config
- .githubGood: Contributing guide is detailed and thorough.Info: Contributing guide lacks a setup section (−12 pts).Fix: Show new contributors how to get a local dev environment running.Good: Contributing guide describes code style expectations.Good: Contributing guide explains how to run tests.Good: Contributing guide describes the PR/review workflow.Good: Contributing guide includes code examples.Good: CI is configured (.github/workflows/ci-mpp.yml).Good: Dependabot covers 2 ecosystems (github-actions, cargo). Dependencies stay current.Good: Issue or PR templates present.
- benches
- cratesGood: Test files detected (crates/anvil/tests).
- docs
- foundryup
- testdata
- .dockerignore
- .git-blame-ignore-revs
- .gitattributes
- .gitignoreGood: .gitignore present.
- benchmark.sh
- Cargo.lockGood: Lockfile present (Cargo.lock). Installs are reproducible.
- Cargo.tomlGood: Dependency manifest found (Cargo.toml).
- clippy.toml
- CONTRIBUTING.md
- deny.toml
- DockerfileGood: Environment pinned via Dockerfile.
- dprint.json
- FUNDING.json
- LICENSE-APACHE
- LICENSE-MIT
- Makefile
- README.mdGood: README is present.Good: README is well structured with multiple sections.Good: README includes screenshots or visuals. Great for first impressions.Good: README has code examples.Good: README links to a live demo or deployed app.Info: No status badges in the README (−10 pts).Fix: Add CI/build status badges from shields.io or your CI provider to signal project health.Good: README documents how to install the project.Good: README documents how to run the project.
- rustfmt.tomlGood: Linter or formatter configured (rustfmt.toml).
- SECURITY.mdGood: Security policy present.
- typos.toml