PHPackages                             stoutlogic/local-wordpress-theme-repository - 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. [Utility & Helpers](/categories/utility)
4. /
5. stoutlogic/local-wordpress-theme-repository

ActiveComposer-plugin[Utility & Helpers](/categories/utility)

stoutlogic/local-wordpress-theme-repository
===========================================

Use to setup a local wordpress-theme package repository for development or production

v1.0.0(10y ago)04711GPL-2.0+PHP

Since Jan 5Pushed 10y ago1 watchersCompare

[ Source](https://github.com/StoutLogic/local-wordpress-theme-repository)[ Packagist](https://packagist.org/packages/stoutlogic/local-wordpress-theme-repository)[ RSS](/packages/stoutlogic-local-wordpress-theme-repository/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (1)Versions (2)Used By (1)

Local WordPress Theme Repository
================================

[](#local-wordpress-theme-repository)

### A Composer Plugin

[](#a-composer-plugin)

The purpose of this composer plugin is to allow you to easily set up and maintain a local composer repository for a wordpress-theme package on a local file system, and then be able to require that wordpress-theme package into your root site package allowing you to run `composer install` or `composer update` and symlink that theme to `wp-content/themes` and manage any theme dependencies.

This is useful in development so you can separate out your theme development from the wordpress environment. You can blow away the wordpress install without cloberring your theme.

This can also be useful on the server as well, if you only deploy the theme. Especially if you do rolling deploys, you can set the location of the local wordpress-theme repostiory to the path of the symlinked "current" theme deploy.

Installation
------------

[](#installation)

To install this composer plugin, simply require it in your composer.json file

```
"require": {
  ...
  "stoutlogic/local-wordpress-theme-repository": "^1.0",
  ...
}
```

or run

`composer require stoutlogic/local-wordpress-theme-repository`

Using
-----

[](#using)

This plugin provides 3 scripts: init-theme, change-theme-name, and change-theme-version

### init-theme

[](#init-theme)

`composer run-script init-theme`

This is the first command that should be performed. It will walk you through the steps of setting up your local theme repository. It will ask you for a series of inputs. The defaults will be shown in \[brackets\], and you can just hit enter to accept the defaults.

```
Package name of the theme you wish to init [stoutlogic/understory-theme]:
Relative path of the theme package is or will be located [./theme]:
Relative path to the WordPress themes directory [wp-content/themes]:

```

Then you'll be ask to input the relative path to the WordPress install's theme directory

```
Relative path to the WordPress themes directory [wp-content/themes]:

```

If the theme package isn't found, you will get the chance to download it from the packagist if it exists. Type y or yes to do so, the default behavior is not to

```
Download stoutlogic/understory-theme using `composer create-project --no-install` [n]?

```

If you don't, please copy, download or create the theme manually in the the specified path. Be sure that the version is set in the theme's composer.json file. If it doesn't you can manually add it. Make sure it matches the version required in teh site's composer.json file and run `composer update`

It may be easier just to run the init-theme script again. It will pull the values you already set in your theme and site composer.json files as defaults so it should go quickly.

### change-theme-name

[](#change-theme-name)

`composer run-script change-theme-name`

If the name you specified in either site or theme composer.json differ, or if you want to easily change both, simply run the change-theme-name script to change it in both places.

### change-theme-version

[](#change-theme-version)

`composer run-script change-theme-version`

Much like the change-theme-name script, if the version you specified in either site or theme composer.json differ, or if you want to easily change both, simply run the change-theme-version script to change it in both places.

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

3829d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/13740017?v=4)[Stout Logic, LLC](/maintainers/stoutlogic)[@StoutLogic](https://github.com/StoutLogic)

---

Top Contributors

[![stevep](https://avatars.githubusercontent.com/u/9717?v=4)](https://github.com/stevep "stevep (1 commits)")

### Embed Badge

![Health badge](/badges/stoutlogic-local-wordpress-theme-repository/health.svg)

```
[![Health](https://phpackages.com/badges/stoutlogic-local-wordpress-theme-repository/health.svg)](https://phpackages.com/packages/stoutlogic-local-wordpress-theme-repository)
```

###  Alternatives

[symfony/runtime

Enables decoupling PHP applications from global state

74794.9M945](/packages/symfony-runtime)[drupal/core-composer-scaffold

A flexible Composer project scaffold builder.

5344.1M527](/packages/drupal-core-composer-scaffold)[drupal/core-project-message

Adds a message after Composer installation.

2124.0M194](/packages/drupal-core-project-message)[sandersander/composer-link

Adds ability to link local packages for development with composer

94441.4k](/packages/sandersander-composer-link)[phpro/grumphp-shim

GrumPHP Phar distribution

284.6M334](/packages/phpro-grumphp-shim)[lullabot/drainpipe

An automated build tool to allow projects to have a set standardized operations scripts.

41759.2k3](/packages/lullabot-drainpipe)

PHPackages © 2026

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