Before you can upload and publish your module to the Forge, build an uploadable module package.
build command performs a series of checks on your module and builds a
tar.gz package so
that you can upload your module to the Forge. To learn more about publishing your module to the
Forge, see the documentation
about publishing your module.
When you run the
pdk build command, PDK checks your module metadata, looks for any symlinks,
and excludes from the package any files listed in the
.pdkignore files. If PDK finds any issues with metadata or symlinks, it
prompts you to fix these issues.
By default, the
.pdkignore file contains a list of commonly ignored files, such as
temporary files. This file is located in the module's main directory. To add or remove
files to this list, define them in the module's
.sync.yml file and run
pdk update on your module.
PDK prompts you for confirmation
before building the package. It writes module packages to the module's
pkg directory, but you can specify a
different directory if you prefer. PDK names module packages with the convention
Build a module
Build a module package with the
pdk build command so that you can upload your
module to the Forge.
From the command line, change into the module's
pdk buildand respond to any prompts.
To change the behavior of the build command, add option flags to the command. For example, to create the package to a custom location, run
pdk build --target-dir=<PATH>. For a complete list of command options and usage information, see the PDK command reference.
PDK builds a package with the
forgeusername-modulename-version.tar.gz to the
pkg directory of the
You can now upload your module to the Forge.