.\" -*- mode: troff; coding: utf-8 -*-
.TH "nix3-flake-new" "1" ""
.PP
\fBWarning\fR: This program is \fBexperimental\fR and its interface is subject to change.
.SH Name
\fCnix flake new\fR - create a flake in the specified directory from a template
.SH Synopsis
\fCnix flake new\fR [\fIoption\fR\[u2026]] \fIdest-dir\fR
.SH Examples
.IP "\(bu" 2
Create a flake using the default template in the directory \fChello\fR:
.LP
.EX
# nix flake new hello
.EE
.IP "\(bu" 2
List available templates:
.LP
.EX
# nix flake show templates
.EE
.IP "\(bu" 2
Create a flake from a specific template in the directory \fChello\fR:
.LP
.EX
# nix flake new hello -t templates#trivial
.EE
.SH Description
This command creates a flake in the directory \fCdest-dir\fR, which must
not already exist. It\[u2019]s equivalent to:
.LP
.EX
# mkdir dest-dir
# cd dest-dir
# nix flake init
.EE
.SH Options
.IP "\(bu" 2
\fC--template\fR / \fC-t\fR \fItemplate\fR
.br
The template to use.
.LP
\fBCommon evaluation options:\fR
.IP "\(bu" 2
\fC--arg\fR \fIname\fR \fIexpr\fR
.br
Pass the value \fIexpr\fR as the argument \fIname\fR to Nix functions.
.IP "\(bu" 2
\fC--argstr\fR \fIname\fR \fIstring\fR
.br
Pass the string \fIstring\fR as the argument \fIname\fR to Nix functions.
.IP "\(bu" 2
\fC--eval-store\fR \fIstore-url\fR
.br
The Nix store to use for evaluations.
.IP "\(bu" 2
\fC--impure\fR
.br
Allow access to mutable paths and repositories.
.IP "\(bu" 2
\fC--include\fR / \fC-I\fR \fIpath\fR
.br
Add \fIpath\fR to the list of locations used to look up \fC<...>\fR file names.
.IP "\(bu" 2
\fC--override-flake\fR \fIoriginal-ref\fR \fIresolved-ref\fR
.br
Override the flake registries, redirecting \fIoriginal-ref\fR to \fIresolved-ref\fR.