Skip to content
Sand Software Solutions

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@latest

Status

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.