A toolchain manager for Roblox developers to install and manage development tools like Rojo, Remodel, and DarkLua.
Foreman is a toolchain manager built for Roblox developers to handle installations and versions of development tools like Rojo, Remodel, and DarkLua. It solves the problem of inconsistent tooling across different projects and team members by providing a centralized way to manage tool binaries. Inspired by rustup and asdf, it uses simple TOML configuration files to define required tools and their versions.
Roblox developers and teams who use multiple development tools like Rojo, Remodel, or DarkLua and need a consistent way to manage these tools across different projects and environments.
Developers choose Foreman because it simplifies tool management specifically for the Roblox ecosystem, reduces setup friction, and ensures version consistency. Its integration with GitHub Actions and support for custom hosts make it flexible for both individual and team workflows.
Toolchain manager for Roblox projects
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Foreman uses straightforward TOML files to define tools, making it easy to set up and share configurations across projects, as shown in the README examples with minimal syntax.
Allows specifying exact tool versions in config files, ensuring consistency and preventing conflicts in team environments, which is crucial for production use cited in the README.
Provides pre-built binaries for Windows, macOS, and Linux with automatic detection, reducing cross-platform setup complexity and aligning with its production-ready claims.
Offers a GitHub Actions setup for automated tool installation in workflows, enhancing DevOps practices for Roblox projects as highlighted in the installation section.
Historical issues with downloading incorrect CPU architectures, such as the 'Bad CPU type' error on Mac, require manual troubleshooting and cache deletion, as admitted in the troubleshooting section.
Currently only supports GitHub, GitLab, and Artifactory protocols, with custom hosts marked as 'under construction' in the README, restricting tool source flexibility.
Users must manually add .foreman/bin to their system PATH, which can be a barrier for less technical users and prone to misconfiguration, as noted in the setup instructions.