README

LaraPost is a Laravel package for publishing and scheduling content to Facebook Pages, Twitter / X, and LinkedIn from one API and one dashboard.

LaraPost supports publishing and scheduling for Facebook Pages, Twitter / X, and LinkedIn from one Laravel API and dashboard.

Features

• One fluent API via SocialSync\Facades\SocialMedia
• Built-in dashboard at /larapost/dashboard
• OAuth connect flow for Facebook, Twitter / X, and LinkedIn
• Multi-Page Facebook sync from one Meta login
• Immediate publishing and scheduled publishing
• Bulk composer for different content across different accounts
• Retry and scheduled runner commands
• CI for PHP 8.2, 8.3, 8.4, and 8.5

Support Matrix

Installation

composer require prateekbhujel/larapost
php artisan larapost:install

Manual setup:

php artisan vendor:publish --tag=larapost-config
php artisan vendor:publish --tag=larapost-migrations
php artisan vendor:publish --tag=larapost-views
php artisan migrate

Configuration

LARAPOST_DEFAULT_PLATFORM=facebook
LARAPOST_QUEUE_ENABLED=true
LARAPOST_MAX_RETRY_ATTEMPTS=3
LARAPOST_UI_ENABLED=true

FACEBOOK_APP_ID=
FACEBOOK_APP_SECRET=
FACEBOOK_API_VERSION=v20.0

TWITTER_CLIENT_ID=
TWITTER_CLIENT_SECRET=
TWITTER_BACKEND=twitter

LINKEDIN_CLIENT_ID=
LINKEDIN_CLIENT_SECRET=

# Optional Xquik backend for Twitter text posts
XQUIK_API_KEY=
XQUIK_ACCOUNT=
XQUIK_API_BASE_URL=https://xquik.com/api/v1

Dashboard-saved provider credentials override .env values.

Quick Start

Connect at least one provider account, then publish from code:

use SocialSync\Facades\SocialMedia;

$results = SocialMedia::post()
    ->content('Release update from LaraPost')
    ->platforms(['facebook', 'twitter'])
    ->publish();

Schedule for later:

use SocialSync\Facades\SocialMedia;

$results = SocialMedia::post()
    ->content('Tomorrow morning post')
    ->platforms(['facebook'])
    ->scheduleFor(now()->addHours(12))
    ->publish();

Connect an account from the CLI:

php artisan larapost:add-account facebook
php artisan larapost:add-account twitter
php artisan larapost:add-account linkedin

Dashboard

The built-in dashboard lives at GET /larapost/dashboard.

It includes:

• Provider credential forms with encrypted database storage
• Login popups for Facebook Pages, Twitter / X, and LinkedIn profiles
• Account targeting for exact Pages and accounts
• Bulk composer for different copy per connected account
• Recent publish history and account toggles

The dashboard is a real operator surface, not a demo screen. It only exposes the support that ships in v1.0.0.

Scheduling

Run the scheduled runner every minute:

* * * * * php /path/to/artisan larapost:run-scheduled >> /dev/null 2>&1

Useful commands:

• php artisan larapost:install
• php artisan larapost:add-account {platform}
• php artisan larapost:test
• php artisan larapost:run-scheduled

Docs

• Docs portal: https://prateekbhujel.github.io/larapost/
• Xquik backend: docs/XQUIK.md
• Contributing guide: CONTRIBUTING.md
• Security policy: SECURITY.md
• Release playbook: RELEASE.md
• Changelog: CHANGELOG.md

Contributing

Community contributions should come from forks. See CONTRIBUTING.md for the expected workflow.

License

LaraPost is released under the MIT license.