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(1w ago)591MITPHP Since Dec 14Pushed 1w 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 today 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 38 — LowBetter than 83% of packages Maintenance76 Regular maintenance activity Popularity14 Limited adoption so far Community7 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 ~274 days Recently: every ~207 days Total 7 Last Release 13d 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.6M3.0k](/packages/craftcms-cms)[illuminate/http The Illuminate Http package. 11937.9M6.8k](/packages/illuminate-http)[spatie/laravel-export Create a static site bundle from a Laravel app 674146.0k6](/packages/spatie-laravel-export)[fleetbase/core-api Core Framework and Resources for Fleetbase API 1235.9k20](/packages/fleetbase-core-api) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)