# cargo-parcel project templates

This directory contains templates that provide minimal examples of
integrating cargo-parcel into a project, and can consist almost
entirely of boilerplate that can be copied verbatim into an
application crate to make it use cargo-parcel.

The `hello-world` template contains a basic integration for a project
that does not need to have its installation prefix compiled in, while
`hello-world-i18n` shows how to make use of the installation prefix.

See the [README](../README.md) for detailed integration instructions;
here is the short version:

- Copy the contents of the `parcel` directory, and `.cargo/config`
  into your crate's root directory.
- Add appropriate metadata to your crate's `Cargo.toml` in the
  `package.metadata.parcel` section.
- If you make use of the compilation prefix, you need to tell cargo to
  rebuild when the environment variable the installation prefix is
  passed to the build by cargo-parcel (namely `PARCEL_INSTALL_PREFIX`)
  changes. This can be done in a build script; see `build.rs` from the
  `hello-world-i18n` template; if you do not already have a build
  script, you can just copy the file verbatim into your project.