# `mix nerves.new`
[🔗](https://github.com/nerves-project/nerves_bootstrap/blob/v1.17.0/lib/mix/tasks/nerves.new.ex#L11)

Creates a new Nerves project

    mix nerves.new PATH [--module MODULE] [--app APP] [--target TARGET] [--cookie STRING] [--no-nerves-pack]

The project will be created at PATH. The application name and module name
will be inferred from PATH unless `--module` or `--app` is given.

An `--app` option can be given in order to name the OTP application for the
project.

A `--module` option can be given in order to name the modules in the
generated code skeleton.

A `--target` option can be given to limit support to one or more of the
[officially Nerves
systems](https://nerves.hexdocs.pm/supported-targets.html).

A `--cookie` options can be given to set the Erlang distribution
cookie in `vm.args`. This defaults to a randomly generated string.

Generate a project without `nerves_pack` support by passing
`--no-nerves-pack`.

## Examples

    mix nerves.new blinky

Is equivalent to:

    mix nerves.new blinky --module Blinky

Generate a project that only supports Raspberry Pi 5

    mix nerves.new blinky --target rpi5

Generate a project that supports Raspberry Pi 5 and Raspberry Pi Zero

    mix nerves.new blinky --target rpi5 --target rpi0

Generate a project without `nerves_pack`

    mix nerves.new blinky --no-nerves-pack

---

*Consult [api-reference.md](api-reference.md) for complete listing*