.TH DUB-INIT 1 "2024-07-07" "The D Language Foundation" "The D Language Foundation"
.SH NAME
dub-init \- Initializes an empty package skeleton
.SH SYNOPSIS
\fBdub init \fR[<\fIdirectory\fR> [<\fIdependency\fR>...]] \fIOPTIONS\&.\&.\&.\fR
[-- <\fIapplication arguments\&.\&.\&.\fR>]
.SH DESCRIPTION
Initializes an empty package of the specified type in the given directory.

By default, the current working directory is used.



Custom templates can be defined by packages by providing a sub-package called "init-exec". No default source files are added in this case.

The "init-exec" sub-package is compiled and executed inside the destination folder after the base project directory has been created.

Free arguments "dub init -t custom -- free args" are passed into the "init-exec" sub-package as app arguments.
.SH OPTIONS
.PP
\fB\-t\fR, \fB\-\-type\fR=\fIVALUE\fR
.RS 4
Set the type of project to generate. Available types:

minimal - simple "hello world" project (default)
vibe.d  - minimal HTTP server based on vibe.d
deimos  - skeleton for C header bindings
custom  - custom project provided by dub package
.RE
.PP
\fB\-f\fR, \fB\-\-format\fR=\fIVALUE\fR
.RS 4
Sets the format to use for the package description file. Possible values:
  json (default), sdl
.RE
.PP
\fB\-n\fR, \fB\-\-non\-interactive\fR
.RS 4
Don't enter interactive mode.
.RE
.SS COMMON OPTIONS
See \fBdub\fR(1)
.SH EXIT STATUS
.TP
.BR 0
DUB succeeded
.TP
.BR 1
usage errors, unknown command line flags
.TP
.BR 2
package not found, package failed to load, miscellaneous error
.SH FILES
\fIdub\&.sdl\fR, \fIdub\&.json\fR
.SH AUTHOR
Copyright (c) 1999-2024 by The D Language Foundation
.SH ONLINE DOCUMENTATION
.URhttp://code.dlang.org/docs/commandline
http://code.dlang.org/docs/commandline
.UE
.SH SEE ALSO
\fBdub\fR(1), \fBdub-add\fR(1), \fBdub-convert\fR(1)