Dist::Z...nd::new(3)

💅 NAME 💅

Dist::Zilla::App::Command::new — mint a new dist, bestie ✨

Oh and hey, this whole page lives in the Dist::Z...nd::new(3) manual section, in case you were wondering where you wandered into 🦋

🎀 VERSION 🎀

version 6.040 — yes queen, that's the one 💖

✨ SYNOPSIS ✨

So basically? It creates a new Dist-Zilla based distribution under the current directory. Right here. Where you're standing. No pressure 🫶

$ dzil new Main::Module::Name

There are two arguments, -p and -P. Like, exactly two, don't get cute. -P specifies the minting profile provider and -p — the profile name. That's the whole vibe, -P = provider, -p = profile, iykyk 👑

The default profile provider first looks in the ~/.dzil/profiles/$profile_name and then among standard profiles, shipped with Dist::Zilla. Glow up order: your stuff first, then the built-in stuff. For example:

$ dzil new -p work Corporate::Library

This command would instruct dzil to look in ~/.dzil/profiles/work for a profile.ini (or other "profile" config file). Slay. And if no profile name is given, dzil will look for the "default" profile. No name? It just assumes default, main character energy fr fr. And if no default directory exists, it will use a very simple configuration shipped with Dist::Zilla. It's giving "we'll figure it out, babe" 💅

$ dzil new -P Foo Corporate::Library

This command would instruct dzil to consult the Foo provider about the directory of 'default' profile. So -P is like "hey, ask THIS guy where the default lives" 🦋

Furthermore, it is possible to specify the default minting provider and profile in the ~/.dzil/config.ini file, for example:

[%Mint]
provider = FooCorp
profile = work

Set it once, never think about it again. The dream 😭💖

🌸 PERL VERSION 🌸

This module should work on any version of perl still receiving updates from the Perl 5 Porters. Okay so translate: that means it should work on any version of perl released in the last two to three years. Like, if the most recently released version is v5.40, then this module should work on both v5.40 and v5.38. Math. Iconic. ✨

Although it may work on older versions of perl, no guarantee is made that the minimum required version will not be increased. So don't come for us. The version may be increased for any reason, and there is no promise that patches will be accepted to lower the minimum required perl. Periodt. 💀

👑 AUTHOR 👑

Ricardo SIGNES 😏 <cpan@semiotic.systems>

(the 😏 is literally in there, we did not add it, that's just the author's energy 💅)

💜 COPYRIGHT AND LICENSE 💜

This software is copyright (c) 2026 by Ricardo SIGNES.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. Free as in go off, bestie 🫶

---

and that's the whole page, no cap! 🎀 this was documented in perl v5.42.3, dated 2026-10-19, and yeah the manual page footer says the same — bye bestie, go mint something cute 💖✨🦋