Zoi

yay -S zoi-bin

brew install Zillowe/tap/zoi

scoop bucket add zillowe https://github.com/Zillowe/scoop.git
scoop install zoi

cargo install zoi-rs

curl -fsSL https://zillowe.pages.dev/scripts/zoi/install.sh | bash

powershell -c "irm zillowe.pages.dev/scripts/zoi/install.ps1|iex"

# Build the release binary
# For Linux/macOS
./build/build-release.sh
# For Windows
./build/build-release.ps1

# Install it locally
./configure
make
sudo make install
# Install CLI completions (bash, zsh, fish, elvish, powershell)
make install-completion

# Add a repository interactively
zoi repo add

# Add a repository by name
zoi repo add community

# Add a repository by git URL (auto-clone)
zoi repo add https://example.com/my-zoi-repo.git

# Remove a repository
zoi repo rm community

# List active repositories
zoi repo ls

# yaml-language-server: $schema=https://gitlab.com/Zillowe/Zillwen/Zusty/Zoi/-/raw/main/app/pkg.schema.json
# The name of the package. This is required and should be unique.
name: my-awesome-app
# The repository where the package is located (e.g. 'core', 'community', 'core/linux/amd64').
repo: community
# The version of the package. Can be a static version number or a URL to a file containing the version.
version: 1.0.0
# (Optional) A map of version channels to version numbers or URLs.
# Zoi will use the 'stable' channel by default if it exists.
versions:
  stable: 1.0.0
  latest: 1.1.0-beta
# A brief description of the package.
description: My awesome application does awesome things.
# (Optional) The official website for the package.
website: https://my-awesome-app.com
# (Optional) A URL to a README file for the package.
readme: https://my-awesome-app.com/README.md
# (Optional) The source code repository URL.
git: https://github.com/user/my-awesome-app
# Information about the package maintainer.
maintainer:
  name: "Your Name"
  email: "[email protected]"
  # (Optional) URL to the maintainer's public GPG key or the 40-character fingerprint.
  key: "DEADC0DEDEADBEEFDEADC0DEDEADBEEFDEADC0DE"
  # (Optional) Website of the maintainer
  website: "https://maintainer.com"
# (Optional) Information about the original author, if different from the maintainer.
author:
  name: "Author Name"
  email: "[email protected]"
  website: "https://author.com"
  # (Optional) URL to the author's public GPG key or the 40-character fingerprint.
  key: "https://example.com/author.gpg"
# (Optional) The license of the package. Should be a valid SPDX license expression
# (e.g. "MIT", "GPL-3.0-or-later", "MIT OR Apache-2.0").
# Use "Proprietary" for non-SPDX/proprietary licenses.
# Zoi will check for OSI-approved licenses and warn if the check fails.
license: MIT
# (Optional) The installation scope. Can be 'user' (default) or 'system'.
scope: user
# (Optional) The package type. Can be 'package' (default), 'collection', 'service', or 'config'.
type: package
# (Optional) An alternate source to resolve this package from. Can be another
# package name (e.g. 'my-app-git'), a URL to a raw .pkg.yaml file, or a local file path.
alt: my-app-v2
# (Optional) The installation method to use for `zoi update`.
# Can be 'binary', 'com_binary', 'script', or 'source'.
updater: binary
# (Optional) Enable or disable rollbacks for this package. Defaults to true.
# This overrides the global setting in Zoi's config.
rollback: true

# (Optional) A list of important messages to show to the user before installation.
updates:
  - type: change
    message: "This version introduces a new configuration file format."
  - type: vulnerability
    message: "A critical vulnerability (CVE-2025-12345) is present in this version."
  - type: update
    message: "This package will no longer be maintained after 2026."

# (Optional) A list of binaries this package provides. Used for conflict detection.
bins:
  - my-awesome-app
# (Optional) A list of package names that this package conflicts with.
conflicts:
  - my-awesome-app-legacy

# (Optional) A list of tags for discovery and filters.
tags:
  - cli
  - devtools

# (Optional) Defines this package as an extension.
extension:
  type: zoi # The type of extension, currently only 'zoi' is supported.
  changes:
    # A list of changes to apply.
    - type: repo-git # Clones a git repository into the git package source.
      add: https://github.com/user/my-zoi-pkgs.git
    - type: registry-repo # Sets the main package database registry URL.
      add: https://my-mirror.com/Zoi-Pkgs.git
    - type: repo-add # Adds an official repository to the active list.
      add: my-custom-repo

# A list of methods to install the package. Zoi will try them in order.
installation:
  - type: binary
    url: "https://github.com/user/my-awesome-app/releases/download/v{version}/my-awesome-app-{platform}"
    platforms: ["linux-amd64", "macos-amd64", "windows-amd64"]
    # (Optional) Checksum verification for the downloaded file.
    checksums:
      # Option A: simple URL to a checksums file (defaults to sha512)
      url: "https://github.com/user/my-awesome-app/releases/download/v{version}/checksums.txt"
      # Option B: explicit list with type (supports sha512 or sha256)
      # type: sha256
      # list:
      #   - file: "my-awesome-app-zip"
      #     checksum: "<hex-digest-or-url>"
    # (Optional) GPG signature verification for the downloaded file.
    # Zoi will use the 'key' from the 'maintainer' or 'author' fields.
    sigs:
      - file: "my-awesome-app-{platform}"
        sig: "https://github.com/user/my-awesome-app/releases/download/v{version}/my-awesome-app-{platform}.sig"
    # (Optional) A list of installer/bundle types like 'dmg', 'msi', or 'appimage'.
    # Zoi will handle these file types with appropriate platform-specific actions.
    binary_types: ["dmg", "msi", "appimage"]

  - type: com_binary
    url: "https://github.com/user/my-awesome-app/releases/download/v{version}/my-awesome-app-v{version}-{platform}.{platformComExt}"
    platforms: ["linux-amd64", "macos-amd64", "windows-amd64"]
    platformComExt:
      linux: tar.zst
      macos: tar.zst
      windows: zip
    # (Optional) The path or filename of the binary inside the archive.
    # If it ends with .exe, Zoi will name the installed file <package>.exe; otherwise <package>.
    # On Windows targets, if binary_path does not end with .exe, Zoi will also try with .exe appended.
    # Examples:
    # binary_path: "bin/my-awesome-app"
    # binary_path: "my-awesome-app.exe"
    binary_path: "bin/my-awesome-app"

  - type: source
    url: "https://github.com/{git}"
    platforms: ["linux-amd64", "macos-amd64", "windows-amd64"]
    # (Optional) Use only one of these. {version} will be expanded.
    # tag: "v{version}"
    # branch: "release/{version}"
    commands:
      - "make build"
      - "mv ./bin/my-awesome-app {store}/my-awesome-app"

# (Optional) Dependencies required by the package.
dependencies:
  # Dependencies are split into 'build' and 'runtime'.
  build:
    required:
      - native:cmake
    optional:
      - native:doxygen:for generating documentation
  runtime:
    required:
      # Simple required dependency
      - zoi:another-zoi-package
      # A group of selectable required dependencies
      options:
        - name: "GUI Toolkit"
          desc: "Choose a GUI provider"
          all: no # User must choose one
          depends:
            - native:qt6:for KDE desktops
            - native:gtk4:for GNOME desktops
    optional:
      - zoi:awesome-plugin:to enable the awesome feature

# (Optional) Post-installation commands to run after a successful installation.
post_install:
  - platforms: ["linux", "macos"]
    commands:
      - "{name} generate-completions bash > ~/.local/share/bash-completion/completions/{name} || true"
      - "{name} generate-completions zsh > ~/.zsh/completions/_{name} || true"
      - "{name} generate-completions fish > ~/.config/fish/completions/{name}.fish || true"
  - platforms: ["windows-amd64"]
    commands:
      - "powershell -NoProfile -Command \"$p=\"$env:USERPROFILE\\Documents\\PowerShell\"; if(!(Test-Path $p)){New-Item -ItemType Directory -Path $p|Out-Null}; {name}.exe generate-completions powershell >> \"$p\\Microsoft.PowerShell_profile.ps1\"\""

# (Optional) Post-uninstallation commands to run before the package is removed.
post_uninstall:
  - platforms: ["linux", "macos"]
    commands:
      - "rm -f ~/.local/share/bash-completion/completions/{name}"
      - "rm -f ~/.zsh/completions/_{name}"
      - "rm -f ~/.config/fish/completions/{name}.fish"