Home

Awesome

zinit-packages

🌻 Welcome to zinit's package repository.

To learn more about zinit packages and how to install them please refer to:

https://zdharma-continuum.github.io/zinit/wiki/Zinit-Packages/

Developers!

🆕 Creating new packages

To create a new package named foo:

./zinit-pkg-gen.sh create foo

This will create a directory named foo which contains:

To add another profile (as in zinit pack"PROFILE" for PACKAGE), for example bar:

./zinit-pkg-gen.sh create foo bar

This will create a new file in your package directory: bar.ices.zsh.

📄 The package format

As mentionned above you should start by editing your .ices.zsh file.

📓 Exactly one zinit call is required in there, multiple zinit calls are not supported.

📝 You can also define metadata in your .ices.zsh files:

VariableDescriptionExample Value
AUTHORAuthor of the packagezdharma-continuum
DESCRIPTIONDescription of the packageMy amazing blockchain project
LICENSELicense of the packaged softwareGPL-3
MESSAGEMessage to be display when installingThanks for using zinit pack!
NAMEPackage name (defaults to plugin name if not set)stuxnet-monero-miner
REQUIREMENTSList of requirements for this packagebgn;tar
PARAM_DEFAULTOptional Default param ice valueMOD -> speed-test
URLLink to the upstream projecthttps://github.com/zdharma-continuum/null
VERSIONVersion of the package0.0.1

Also please refer to the null package for an up-to-date example

👏 Updating package.json files

To generate a package.json file for your package run:

# Replace these
pkg=null
profile=default

./zinit-pkg-gen.sh gen ${pkg} ${profile}

🐳 How do I run these?

There's a shorthand subcommand for running a .ices.zsh file locally, inside a container:

./zinit-pkg-gen.sh run PACKAGE PROFILE

Great, but I want to test my package.json directly!

Here you go:

./zinit-pkg-gen.sh run --pack PACKAGE PROFILE
<!-- vim: set ft=markdown et ts=2 sw=2 tw=80 --!>