LLaraPost
Getting Started

Installation

A beginner-friendly path from Composer install to the first real post, with optional platform and MCP choices.

Requirements

  • PHP 8.3 or newer
  • Laravel 12 or 13
  • A database supported by Laravel
  • Provider developer credentials for the networks you actually enable

1. Install the package

composer require prateekbhujel/larapost
php artisan larapost:install

The installer lets you choose Facebook, Twitter / X, LinkedIn, TikTok, or any combination. It also asks whether to enable the operator dashboard and optional MCP integration.

Non-interactive examples

# Facebook only, no AI/MCP
php artisan larapost:install --platforms=facebook

# Facebook + TikTok
php artisan larapost:install --platforms=facebook,tiktok

# Posting API only, without the built-in dashboard
php artisan larapost:install --platforms=linkedin --no-dashboard

# Prepare MCP as well
php artisan larapost:install --platforms=facebook,tiktok --mcp
MCP is optional. If you select it, also install laravel/mcp. If you do not select it, LaraPost does not register an MCP route and does not need the MCP package in production.

2. Run migrations

The installer can run them for you. Otherwise:

php artisan migrate

3. Add provider credentials

Only add credentials for enabled platforms. For example, a Facebook + TikTok app can use:

LARAPOST_PLATFORMS=facebook,tiktok

FACEBOOK_APP_ID=
FACEBOOK_APP_SECRET=

TIKTOK_CLIENT_KEY=
TIKTOK_CLIENT_SECRET=
TIKTOK_PUBLISH_MODE=upload

4. Run the doctor

php artisan larapost:doctor

This checks database tables, active platforms, queue mode, scheduler registration, dashboard access middleware, and MCP configuration.

5. Connect an account

If the dashboard is enabled, sign in to your Laravel application and open /larapost/dashboard. LaraPost protects operator routes with web and auth middleware by default.

6. Publish

use SocialSync\Facades\SocialMedia;

$result = SocialMedia::post()
    ->content('Hello from our Laravel app.')
    ->platform('facebook')
    ->publish();

Next

Read Platforms before configuring production provider apps, then Publishing & scheduling for queues, retries, and multi-account targeting.