PHPackages                             stellarwp/pup - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI &amp; Console](/categories/cli)
4. /
5. stellarwp/pup

ActiveLibrary[CLI &amp; Console](/categories/cli)

stellarwp/pup
=============

StellarWP's Project Utilities &amp; Packager

1.3.9(2mo ago)6518[2 issues](https://github.com/stellarwp/pup/issues)[24 PRs](https://github.com/stellarwp/pup/pulls)MITPHPPHP ^7.2|^8.0CI passing

Since Jul 6Pushed 2mo ago15 watchersCompare

[ Source](https://github.com/stellarwp/pup)[ Packagist](https://packagist.org/packages/stellarwp/pup)[ RSS](/packages/stellarwp-pup/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (11)Versions (54)Used By (0)

**P**roject **U**tilities &amp; **P**ackager (`pup`)
====================================================

[](#project-utilities--packager-pup)

This is a CLI utility built by [StellarWP](https://stellarwp.com) for running project build processes, sanity checks, and packaging into zips.

[![Static Analysis](https://github.com/stellarwp/pup/actions/workflows/static-analysis.yml/badge.svg)](https://github.com/stellarwp/pup/actions/workflows/static-analysis.yml) [![Tests](https://github.com/stellarwp/pup/workflows/Tests/badge.svg)](https://github.com/stellarwp/pup/actions?query=branch%3Amain)

Docs
----

[](#docs)

- [Installation](/docs/installation.md)
    - [Install in a project as a phar](/docs/installation.md#install-in-a-project-as-a-phar) - recommended for most projects.
    - [Install as a composer dependency](/docs/installation.md#install-as-a-composer-dependency) - easy, but comes with some caveats.
    - [Install globally as a phar](/docs/installation.md#install-globally-as-a-phar) - good option for your system.
    - [Install globally as a git clone](/docs/installation.md#install-globally-as-a-git-clone) - another good option for your system.
- [Configuration](/docs/configuration.md)
    - [Glob patterns](/docs/glob-patterns.md) - for your `.distfiles` and `.distignore` files.
    - [Internationalization (i18n)](/docs/i18n.md)
- [Commands](/docs/commands.md)
    - [`pup build`](/docs/commands.md#pup-build)
    - [`pup check`](/docs/commands.md#pup-check)
        - [`pup check:tbd`](/docs/commands.md#pup-checktbd)
        - [`pup check:version-conflict`](/docs/commands.md#pup-checkversion-conflict)
    - [`pup clean`](/docs/commands.md#pup-clean)
    - [`pup do`](/docs/commands.md#pup-do)
    - [`pup get-version`](/docs/commands.md#pup-get-version)
    - [`pup help`](/docs/commands.md#pup-help)
    - [`pup i18n`](/docs/commands.md#pup-i18n)
    - [`pup info`](/docs/commands.md#pup-info)
    - [`pup package`](/docs/commands.md#pup-package)
    - [`pup workflow`](/docs/commands.md#pup-workflow)
    - [`pup zip`](/docs/commands.md#pup-zip)
    - [`pup zip-name`](/docs/commands.md#pup-zip-name)
- [Command flow for `pup zip`](/docs/flow.md)
- [Checks](/docs/checks.md)
    - [Default checks](#default-checks)
    - [Running all checks](#running-all-checks)
    - [Running specific checks](#running-specific-checks)
    - [Creating custom checks](#creating-custom-checks)
        - [Simple checks](#simple-checks)
        - [Class-based checks](#class-based-checks)
- [Workflows](/docs/workflows.md)
    - [Defining workflows](/docs/workflows.md#defining-workflows)
    - [Calling workflows](/docs/workflows.md#calling-workflows)
    - [Pseudo-workflows](/docs/workflows.md#pseudo-workflows)
- Examples
    - [GitHub Workflow: Zipping](/examples/workflows/zip.yml) - Breaks up the `pup zip` command into multiple steps so debugging is easy.

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance77

Regular maintenance activity

Popularity21

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 62.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~40 days

Recently: every ~156 days

Total

25

Last Release

84d ago

Major Versions

0.1.0 → 1.0.02023-07-08

PHP version history (2 changes)0.0.1PHP ^7.0|^8.0

0.0.2PHP ^7.2|^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/e3171496e198834c638911ad3c3220bec77871cdf6557eaa9e2a58d16600a1a1?d=identicon)[bordoni](/maintainers/bordoni)

![](https://www.gravatar.com/avatar/70a2847a265444714b48c64eceb3ca742baa3a56757ce65b18bd7bbbbf910312?d=identicon)[dpanta94](/maintainers/dpanta94)

![](https://www.gravatar.com/avatar/97fd764aa710e8d8263a7e3b3fececdfd736b8aad8055227bf592ddf50ad15ba?d=identicon)[stellarwp](/maintainers/stellarwp)

![](https://www.gravatar.com/avatar/ec4ef25906386b60f5f66b3d03064e3bb700bedc94ee8558918565612c74aef3?d=identicon)[johnhooks](/maintainers/johnhooks)

---

Top Contributors

[![borkweb](https://avatars.githubusercontent.com/u/430385?v=4)](https://github.com/borkweb "borkweb (146 commits)")[![test12376](https://avatars.githubusercontent.com/u/2381545?v=4)](https://github.com/test12376 "test12376 (46 commits)")[![ndossougbe](https://avatars.githubusercontent.com/u/1184438?v=4)](https://github.com/ndossougbe "ndossougbe (10 commits)")[![defunctl](https://avatars.githubusercontent.com/u/1066195?v=4)](https://github.com/defunctl "defunctl (10 commits)")[![redscar](https://avatars.githubusercontent.com/u/12241059?v=4)](https://github.com/redscar "redscar (6 commits)")[![estevao90](https://avatars.githubusercontent.com/u/18039589?v=4)](https://github.com/estevao90 "estevao90 (4 commits)")[![d4mation](https://avatars.githubusercontent.com/u/7770631?v=4)](https://github.com/d4mation "d4mation (4 commits)")[![bordoni](https://avatars.githubusercontent.com/u/236579?v=4)](https://github.com/bordoni "bordoni (4 commits)")[![lucatume](https://avatars.githubusercontent.com/u/2749650?v=4)](https://github.com/lucatume "lucatume (1 commits)")[![shvlv](https://avatars.githubusercontent.com/u/3157352?v=4)](https://github.com/shvlv "shvlv (1 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

---

Tags

cliutility

###  Code Quality

TestsCodeception

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/stellarwp-pup/health.svg)

```
[![Health](https://phpackages.com/badges/stellarwp-pup/health.svg)](https://phpackages.com/packages/stellarwp-pup)
```

###  Alternatives

[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

19462.3M1.3k](/packages/drupal-core)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)[crunzphp/crunz

Schedule your tasks right from the code.

2292.0M6](/packages/crunzphp-crunz)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
