Remappings Configuration Generator

WHAT IT DOES

The Remappings Configuration Generator is a developer tool that generates Solidity import remappings for Foundry and Hardhat projects. It takes user-provided dependency paths and library prefixes, and outputs properly formatted configuration for foundry.toml or hardhat.config.js. This helps developers configure import resolution for external libraries, simplifying the setup of complex Solidity projects with multiple dependencies.

HOW TO USE

Select your target framework (Foundry or Hardhat). Enter your remappings in the format "prefix=path" (one per line). Click "generate configuration" to produce the formatted configuration file. The tool generates a complete configuration snippet with all remappings properly formatted. For Foundry, it generates a foundry.toml section with remappings array. For Hardhat, it generates a hardhat.config.js snippet with the remappings array in the compiler settings. Download the configuration file for integration into your project.

TECHNICAL MECHANISM

The tool parses user input by splitting each line on the "=" character to extract the prefix and path. It validates that both prefix and path are present. For Foundry, it generates a TOML configuration with the remappings as an array of strings in the format "[profile.default]" section. For Hardhat, it generates a JavaScript configuration with the remappings as an array in the compiler settings object. The tool handles multiple remappings and formats them with proper commas and indentation. The generated configuration includes default settings (src, out, libs for Foundry; compiler version and optimizer for Hardhat) alongside the custom remappings. The output is presented as a downloadable file with clear instructions for integration.

WHAT IT CANNOT SEE

The tool cannot automatically detect the correct remappings for complex project structures without user guidance. It cannot resolve transitive dependencies or nested imports. The tool cannot verify that the generated remappings will work with the specific project setup. It cannot detect conflicting remappings that may cause import resolution issues. The tool cannot account for different import styles (relative vs absolute) without additional configuration. It cannot validate that the library paths exist without manual confirmation.

PLEASE NOTE

This tool is designed for Ethereum Virtual Machine (EVM) compatible chains and Solidity projects using Foundry or Hardhat. The generated configuration is a starting point—users should verify that the paths match their actual directory structure. The tool provides estimates only and should be used as a reference for configuring import remappings. Always test the configuration by compiling the project after applying the remappings. For projects with complex dependency structures, additional manual configuration may be required.