Introduction - Cargo Generate Documentation
Description: cargo, make me a project

## Keyboard shortcuts

Press `←` or `→` to navigate between chapters

Press `S` or `/` to search in the book

Press `?` to show this help

Press `Esc` to hide this help

# Introduction

> cargo, make me a project

`cargo-generate` is a developer tool to help you get up and running quickly with a new Rust project by leveraging a pre-existing git repository as a template.

cargo-generate uses Shopify’s Liquid template language, Rhai for hook scripts and regex for placeholders.

Due to the use of Shopify’s Liquid, `cargo-generate` special cases files with the file-ending `.liquid`, by simply removing the file-ending when processing the files. If you, as a template author, truly want the `.liquid` file-ending, you need to repeat it twice!

For example: The file `README.md.liquid` will be renamed after templating to `README.md`. If `README.md` already exists, then it will be overwritten to include the contents of `README.md.liquid`.

Here’s an example of using `cargo-generate` with this template: