From empty folder to working project in seconds
Foundry is a command-line tool that starts new projects from templates: ten ready-made ones are built in, and you can save your own. With a dry-run preview and safe copying. Written in Go, open source and made for scripting.
- Status
- Open source
- Licence
- AGPL-3.0
- Language
- Go
- Version
- 0.5.0
What Foundry does for you
- Ready-made templates
- Ten built-in templates for Go, Node.js, TypeScript, Python, Rust and HTML. Each builds and passes its own tests, with no frameworks.
- Your own templates
- Save any folder as a template or start with template init. A .foundry.yaml in the template can bring its own questions and setup steps; Foundry asks for whatever is still missing.
- Placeholders everywhere
- {{PROJECT_NAME}}, {{AUTHOR}}, {{YEAR}} and your own, in file contents and in file names, with snake, kebab and Pascal case variants.
- Safe copying
- Gitignore-style .foundryignore rules, symbolic links are never followed, and a failed run removes what it created.
- Git initialisation
- Initialises a repository with a .gitignore that fits the language and makes the first commit.
- Templates from Git
- Use any Git repository as a template, with a branch or tag, and save it with template add <address> to update it later.
Install
On Debian, Ubuntu and derivatives, install it with apt. Updates then come with your normal system updates. Other systems: download an archive from GitHub, or use go install.
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://sandsoftwaresolutions.github.io/apt/key.asc | sudo tee /etc/apt/keyrings/sandsoftwaresolutions.asc >/dev/null
echo "deb [signed-by=/etc/apt/keyrings/sandsoftwaresolutions.asc] https://sandsoftwaresolutions.github.io/apt stable main" | sudo tee /etc/apt/sources.list.d/sandsoftwaresolutions.list
sudo apt update
sudo apt install foundry
# or, with Go 1.25 or newer:
go install github.com/SandSoftwareSolutions/Foundry/cmd/foundry@latestStatus
Foundry is on GitHub, version 0.5.0, under the GNU Affero General Public License v3 (AGPL-3.0). Archives for Linux, macOS and Windows, Debian packages and checksums are attached to each release.
Frequently asked questions
What is Foundry?
A fast command-line tool that scaffolds new projects from templates.
Which templates come with Foundry?
go-basic, go-http, node-basic, node-http, typescript-basic, python-basic, python-http, rust-basic, static-site and blank. See them with foundry template list.
Which licence does Foundry use?
Foundry is open source under the GNU Affero General Public License v3 (AGPL-3.0).
Which systems does Foundry run on?
Linux, macOS and Windows, on Intel/AMD and ARM. On Debian and Ubuntu you can install it with apt.
Where can I find the code?
On GitHub, in the SandSoftwareSolutions organisation.
Also from us
A question or an idea?
Send us an email. You talk directly to the people who build the software and get an answer within 2 working days.