pushword / repurpose

1.0.105 2026-10-28 09:17 UTC

Requires

• php: ~8.5.0
• ext-gd: *
• ext-zip: *
• pushword/core: *

Suggests

• pushword/admin: Manage pages, media and users from an EasyAdmin-based back-office.
• pushword/admin-block-editor: Rich block editor (EditorJS) for the admin.
• pushword/advanced-main-image: Choose the main image format per page, from hidden to full hero.
• pushword/api: Token-authenticated REST API mirroring the admin, OpenAPI-described.
• pushword/conversation: Add comments, a contact form or any user input to your website.
• pushword/docs: Pushword documentation, readable offline from vendor/.
• pushword/flat: Turn Pushword into a flat-file CMS: content as Markdown in Git.
• pushword/link-improver: Automatic internal links: page names become in-content links at render time.
• pushword/newsletter: Audiences, segmented campaigns and criteria-driven automations.
• pushword/page-scanner: Find dead links, 404s, redirects and TODO reminders.
• pushword/page-update-notifier: Get an email when a page is created or edited.
• pushword/quiz: Interactive client-side quizzes (QCM) and personality tests.
• pushword/search: SQLite-native full-text search via Loupe, zero infrastructure.
• pushword/snippet: Reusable content fragments and dev-registered Twig components.
• pushword/static-generator: Export the whole site as static files (GitHub Pages, Apache, FrankenPHP).
• pushword/template-editor: Edit Twig view files online from the admin.
• pushword/version: Keep a version history of your pages and compare revisions.

MIT

• Robin@PiedWeb

• linkedin
• instagram
• carousel
• svg
• social-media
• image-generation
• pushword

Published on Packagist.org on 2026-10-30 14:14 UTC

README

Turn a Pushword page into ready-to-post social posts and carousels (LinkedIn, Instagram, Facebook, Pinterest, …). Pinterest is modelled as an organic image Pin: one 2:3 visual with a required caption.

• Agent-authored JSON spec — a carousel is a small JSON document (slides, text, focal-point crop, palette, font pairing, background effect, status). An AI agent writes it against a published JSON Schema; a human nudges it in the admin.
• Self-contained SVG slides — each slide renders server-side to one portable SVG with its font and image embedded as data: URIs. Text is laid out in PHP, so overflow and bad crops become validation errors before anything is rendered.
• Pixel-exact export — the browser rasterises the SVG to PNG; PHP assembles a .zip (PNGs + caption) and, for LinkedIn, a multipage PDF. No headless browser, no npm dependency.
• Motion design — pw:repurpose:motion exports a local HyperFrames project: editable timeline, SVG layers, crossfades and per-layer animation presets. An agent can add custom HTML/JavaScript scenes, preview frames and render an H.264 video. Node/HyperFrames dependencies are installed only in the exported project.
• Flat or DB — carousels round-trip through pw:flat:sync as JSON files, so they live in git on a flat-file site and in the database on a dynamic one.

Installation

composer require pushword/repurpose

Documentation

Visit pushword.piedweb.com/extension/repurpose.

For agent-authored animation, use the pw motion playbook from Pushword's AI skills. It covers the brief, scene authoring, visual checks, video render, upload and attachment to an admin draft.

Try the complete NORD. motion example, shipped with this package. From a Composer site's root (Node.js 22+ and FFmpeg):

node vendor/pushword/repurpose/examples/nord/prepare.mjs /tmp/nord-motion
cd /tmp/nord-motion
npm install
npm run check
npm run still -- --frame=205
npm run render

The output directory must be new. Preparation needs no PHP or fixture database. In the monorepo, use packages/repurpose instead of vendor/pushword/repurpose.