Your new Pushword site

This is a fresh Pushword install — a modular CMS built on Symfony, where content is Markdown + Twig and every feature is its own bundle.

Replace this README with your own once the site is yours.

Run it

php -S 127.0.0.1:8004 -t public/
# or, with the Symfony CLI
symfony server:start -d

A Caddyfile is included if you prefer FrankenPHP, which also runs Pushword in worker mode.

Log in

Open /admin with the account the installer created:

admin@example.tld
p@ssword

Change it right away — from the admin, or with php bin/console pw:user:create you@example.com 'your-password' ROLE_SUPER_ADMIN.

First steps

1. Name your site — config/packages/pushword.yaml holds hosts, locales and templates. php bin/console pw:new adds another site to it.
2. Write a page — from /admin, or as Markdown files if you install Flat.
3. Make it yours — override the Twig views in templates/, see themes.
4. Delete the demo content — the pages and media that came with the install are examples, not a starting point.

What came with it

Admin	Manage pages, media and users
Block editor	Write in blocks, stored as Markdown
Page Scanner	Find dead links, 404s and redirects
Static Generator	Export the site as static files
Template Editor	Edit Twig views from the admin

Add more as you need them — versioning, search, flat files, comments, newsletter:

composer req pushword/version
composer req pushword/search

The full list is on pushword.piedweb.com/extensions.

Working with an AI agent

AGENTS.md at the root (symlinked as CLAUDE.md) tells an agent how this project is laid out and points it at vendor/pushword/docs/CLAUDE.md, Pushword's own reference. Fill in its About this site section — that is the part no agent can infer from the code.

Update

composer update

Help

• Documentation — pushword.piedweb.com
• Questions and bugs — github.com/Pushword/Pushword/issues
• Support the project — Liberapay, or a star on GitHub

License

Pushword is MIT licensed. See the license.