pushword/installer

Run the post-install scripts shipped by Pushword bundles when a Pushword app is installed or updated.

1.0.0-rc877 2026-08-05 07:41 UTC

Requires

• pushword/core: *
• symfony/filesystem: ^7.3 || ^8.0

Requires (Dev)

• composer/composer: *
• phpunit/phpunit: *

MIT

• Robin@PiedWeb

• symfony
• installer
• cms
• pushword

Published on Packagist.org on 2026-08-13 20:38 UTC

README

Install Pushword and its packages in minutes — automatic per-package install hooks.

Features

• Automatic package setup — runs each package's install.php on composer require.
• Stays installed to support future package installs.

How It Works

PostInstall::runPostUpdate executes each package's install.php when you add a Pushword package, once per package. pushword/core's script is what sets a new project up: database, super admin, routes, assets and default config.

pushword/installer remains installed afterwards so later composer require calls get the same treatment.

The src/installer bash script is obsolete

It hung off post-install-cmd, which composer create-project never fires — so it never ran on the documented install path, while install.php quietly did the same work. It did fire on a later composer install, where it truncated config/routes.yaml and blocked on a prompt.

Since rc828 it is a no-op that removes itself from post-install-cmd. Projects created before then clean up on their next composer install; nothing to do by hand.

Manual Installation

If you prefer not to use automatic installation, you can:

1. Remove pushword/installer from your dependencies
2. Manually follow the steps in each package's install.php file

Documentation

Visit pushword.piedweb.com/installation.

The Pushword ecosystem

Pushword is a modular CMS — one Symfony bundle for the core and one bundle per feature. Pick only what you need:

Core

• pushword/core — Symfony-based CMS core: Page, Media & User entities, Markdown + Twig rendering.

Editing & admin

• pushword/admin — EasyAdmin interface to manage pages, media and users.
• pushword/admin-block-editor — Gutenberg-like block editor (stores Markdown).
• pushword/advanced-main-image — Hero images & main-image format control.
• pushword/template-editor — Edit Twig templates online.
• pushword/snippet — Reusable content fragments & components.

Content & workflow

• pushword/flat — Flat-file (Markdown + Git) CMS mode.
• pushword/version — Page & snippet versioning.
• pushword/page-update-notifier — Email alerts on content changes.
• pushword/conversation — Comments, contact & newsletter forms.

Publishing & performance

• pushword/static-generator — Export a static website (GitHub Pages, Apache, FrankenPHP).
• pushword/search — SQLite full-text search (Loupe), zero infra.
• pushword/page-scanner — Find dead links, 404s, redirects & TODOs.
• pushword/api — Token-authenticated REST API.

Tooling

• pushword/installer — Project & package installer. (this package)
• pushword/js-helper — Front-end JavaScript helpers.

Full list and guides on pushword.piedweb.com/extensions.

Contributing

If you're interested in contributing to Pushword, please read our contributing docs before submitting a pull request.

Credits

• PiedWeb
• All Contributors

License

The MIT License (MIT). Please see License File for more information.