PHPackages                             iqual/project-scaffold - 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. [Templating & Views](/categories/templating)
4. /
5. iqual/project-scaffold

ActiveComposer-plugin[Templating & Views](/categories/templating)

iqual/project-scaffold
======================

Interactive project scaffolding and initializing.

v1.1.2(9mo ago)223.5k↓73.3%1GPL-2.0-or-laterPHPPHP >=7.3.0CI passing

Since Feb 2Pushed 6d ago3 watchersCompare

[ Source](https://github.com/iqual-ch/project-scaffold)[ Packagist](https://packagist.org/packages/iqual/project-scaffold)[ Docs](https://www.iqual.ch)[ RSS](/packages/iqual-project-scaffold/feed)WikiDiscussions 2.x Synced 2w ago

READMEChangelog (6)Dependencies (4)Versions (6)Used By (1)

Project Scaffold
================

[](#project-scaffold)

A Composer plugin that scaffolds and updates project files from versioned asset packages.

Files that usually get copied from project to project by hand — CI workflows, `.ddev` or `.devcontainer` setups, `.env` templates, `.gitignore`, Makefiles — can instead be defined once in an asset package and managed by Composer. When the package is required, updated or used with `composer create-project`, the plugin places the files, renders templates and, if run interactively, asks the questions the package defines and saves the answers to the project's `composer.json`.

The plugin is heavily inspired by Drupal's [drupal/core-composer-scaffold](https://github.com/drupal/core-composer-scaffold), generalized beyond Drupal. Credit to its contributors.

How it works
------------

[](#how-it-works)

An asset package declares its files under `extra.project-scaffold.assets`, grouped by operation:

- `add` — created once, never overwritten.
- `replace` — kept in sync on every update; an empty source deletes the destination.
- `merge` — values are merged into existing `.env`, line-based (`.gitignore`), JSON and YAML files, preserving local additions and comments.
- `read` — a questions definition; missing or newly asked variables are prompted interactively and written back to the root `composer.json`.

Sources ending in `.twig` are rendered with the project's variables before being placed. See [creating a project asset package](./docs/asset-package.md) for the full format.

The root project stays in control: it can ignore individual files, disable automatic scaffolding, force a hard re-scaffold or preview changes with a dry run. See [controlling scaffolding in the root project](./docs/root-project.md).

Getting started
---------------

[](#getting-started)

```
composer require iqual/project-scaffold --dev
```

Allow the plugin when Composer asks, then require one or more asset packages. The plugin prompts for the package's questions, saves the answers under `extra.project-scaffold` and scaffolds the files. From then on, `composer update` keeps the managed files up to date.

Commands
--------

[](#commands)

CommandPurpose`composer project:init`Prompt all package questions again and re-apply the scaffolding.`composer project:update`Alias of `project:init`.`composer project:scaffold`Re-apply the scaffolding without prompting.Scaffolding also runs automatically after `composer install`, `update`, `require` and `create-project`.

Both commands accept a `--force` flag for a hard re-scaffold and a `--dry-run` flag to preview changes, and the automatic scaffolding can be disabled — see [controlling scaffolding in the root project](./docs/root-project.md).

Versions
--------

[](#versions)

BranchRequirementsStatus`2.x`PHP `^8.3`, Composer 2.6+Active development`1.x`PHP >= 7.3Critical fixes onlyDevelopment
-----------

[](#development)

The test suite runs offline against fixture projects, locally via [ddev](https://ddev.com) (`ddev start`, then `make install` and `make test`) or any PHP >= 8.3 (`composer test`). See [testing](./docs/testing.md).

###  Health Score

45

—

FairBetter than 91% of packages

Maintenance80

Actively maintained with recent releases

Popularity30

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 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

Every ~248 days

Total

5

Last Release

299d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/90cd0a373720aba510d144cf310f4b036ae8d79f1f7385d663ae20b87a3fb017?d=identicon)[pvbergen](/maintainers/pvbergen)

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

![](https://www.gravatar.com/avatar/43082de1b2e2b2b2d48b7ff7dbc7c60ff1d0a015123d4062ac0b49ea0b3b725f?d=identicon)[iqual](/maintainers/iqual)

---

Top Contributors

[![martinstadelmann](https://avatars.githubusercontent.com/u/25382761?v=4)](https://github.com/martinstadelmann "martinstadelmann (65 commits)")

---

Tags

composercomposer-pluginidpinit-projectphpphp-project-initplatformproject-templaterecipesscaffoldscaffoldingscaffoldtemplatebootstrapkickstartinit

### Embed Badge

![Health badge](/badges/iqual-project-scaffold/health.svg)

```
[![Health](https://phpackages.com/badges/iqual-project-scaffold/health.svg)](https://phpackages.com/packages/iqual-project-scaffold)
```

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.7M3.4k](/packages/craftcms-cms)[drupal/core

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

19467.3M1.9k](/packages/drupal-core)[oro/platform

Business Application Platform (BAP)

645146.3k118](/packages/oro-platform)[october/rain

October Rain Library

1601.7M103](/packages/october-rain)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.8M674](/packages/shopware-core)[symfony/ux-toolkit

A tool to easily create a design system in your Symfony app with customizable, well-crafted Twig components

16164.9k1](/packages/symfony-ux-toolkit)

PHPackages © 2026

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