PHPackages riclep/social-graces - 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. [Image & Media](/categories/media) 4. / 5. riclep/social-graces ActiveLibrary[Image & Media](/categories/media) riclep/social-graces ==================== A wrapper around SidecarBrowsershot for managing dynamic social images - OGP, Twitter etc 0.0.7(1mo ago)592MITPHP Since Dec 14Pushed 1mo ago1 watchersCompare [ Source](https://github.com/RicLeP/social-graces)[ Packagist](https://packagist.org/packages/riclep/social-graces)[ Docs](https://github.com/riclep/social-graces)[ RSS](/packages/riclep-social-graces/feed)WikiDiscussions master Synced 1w ago READMEChangelog (5)Dependencies (10)Versions (9)Used By (0) Social Graces; a polite way to create dymanic social share images ================================================================= [](#social-graces-a-polite-way-to-create-dymanic-social-share-images) [![Latest Version on Packagist](https://camo.githubusercontent.com/bfe63007121735fbc7a1264f29165d074904599b429c34f3a02e25744031a7db/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7269636c65702f736f6369616c2d6772616365732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/riclep/social-graces)[![Total Downloads](https://camo.githubusercontent.com/82b4bfd53ed177697e13bcad31c70eca78e1e8b258667d872089806fc4251df3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7269636c65702f736f6369616c2d6772616365732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/riclep/social-graces) This package allows you to create dynamic social sharing images in your Laravel apps. It uses [Spatie’s Browsershot](https://github.com/spatie/browsershot) to screenshot special pages that represent the image you wish to use. Create any view, using any content from your site and it’ll become the image used when your page is shared on Twitter, Facebook and elsewhere. You can either create different images for each network using Manners or use the same Balde view with CSS breakpoints to to vary your images based on the size needed for each network. Installation ------------ [](#installation) You can install the package via composer: ``` composer require riclep/social-graces ``` Usage ----- [](#usage) No docs yet, but check the tests and code. It’s a pretty small package. ### Browsershot Requirements [](#browsershot-requirements) This package wraps Spatie’s Browsershot that requires Puppeteer, Chromium, Node etc. on your server. I can’t support installing these on your own server, but here is what I needed to do. **Use at your own risk!** ``` apt update -y sudo apt-get install -y nodejs gconf-service libasound2 libatk1.0-0 libc6 libcairo2 libcups2 libdbus-1-3 libexpat1 libfontconfig1 libgbm1 libgcc1 libgconf-2-4 libgdk-pixbuf2.0-0 libglib2.0-0 libgtk-3-0 libnspr4 libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxss1 libxtst6 ca-certificates fonts-liberation libappindicator1 libnss3 lsb-release xdg-utils wget libgbm-dev libxshmfence-dev export PHANTOM_JS='phantomjs-2.1.1-linux-x86_64'; wget -N https://bitbucket.org/ariya/phantomjs/downloads/$PHANTOM_JS.tar.bz2 ; tar xvjf $PHANTOM_JS.tar.bz2; mv $PHANTOM_JS /usr/local/share; ln -sf /usr/local/share/$PHANTOM_JS/bin/phantomjs /usr/local/bin; phantomjs --version sudo npm install --global --unsafe-perm puppeteer chmod -R o+rx /usr/local/lib/node_modules/puppeteer/.local-chromium ``` ### Testing [](#testing) ``` composer test ``` ### Changelog [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. ### Security [](#security) If you discover any security related issues, please email instead of using the issue tracker. Credits ------- [](#credits) - [Richard Le Poidein](https://github.com/riclep) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. Laravel Package Boilerplate --------------------------- [](#laravel-package-boilerplate) This package was generated using the [Laravel Package Boilerplate](https://laravelpackageboilerplate.com). ### Health Score 41 — FairBetter than 87% of packages Maintenance88 Actively maintained with recent releases Popularity15 Limited adoption so far Community7 Small or concentrated contributor base Maturity46 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 ~274 days Recently: every ~207 days Total 7 Last Release 58d ago PHP version history (2 changes)0.0.1-betaPHP ^7.4|^8.0 0.0.3PHP ^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/8cc0947c5075928ca6160ab3c81f608db980edaefafd50fd904d060ba5c40817?d=identicon)[ric@sirric.co.uk](/maintainers/ric@sirric.co.uk) --- Top Contributors [![RicLeP](https://avatars.githubusercontent.com/u/19726976?v=4)](https://github.com/RicLeP "RicLeP (20 commits)") --- Tags facebooktwittersharingogpriclepopen-graph-protocolsocial-imagessocial-graces ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/riclep-social-graces/health.svg) ``` [![Health](https://phpackages.com/badges/riclep-social-graces/health.svg)](https://phpackages.com/packages/riclep-social-graces) ``` ### Alternatives [craftcms/cms Craft CMS 3.6k3.7M3.4k](/packages/craftcms-cms)[illuminate/http The Illuminate Http package. 11938.5M8.2k](/packages/illuminate-http)[eslazarev/wildberries-sdk Wildberries OpenAPI clients (generated). 353.6k](/packages/eslazarev-wildberries-sdk)[simplestats-io/laravel-client Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof. 5226.7k](/packages/simplestats-io-laravel-client)[fleetbase/core-api Core Framework and Resources for Fleetbase API 1239.7k25](/packages/fleetbase-core-api)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 265.2k](/packages/aedart-athenaeum) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)