Skip to main content

Overview

revolution/laravel-bluesky is a Laravel package for AT Protocol (Bluesky). It exposes Revolution\Bluesky\Facades\Bluesky and lets you create posts, fetch feeds, search posts, and attach media through Laravel-friendly APIs.

Requirements

  • PHP >= 8.3
  • Laravel >= 12.x

Installation

Environment variables

For App Password authentication, configure your .env values.

Quick start

Create your first post

Due to a temporary API restriction, searchPosts() currently does not work for unauthenticated access. Use an authenticated session for searches.

Documentation map

Basic client

Learn App Password and OAuth auth, posting, media, replies, quotes, feeds, and search.

Socialite

Bluesky-specific Socialite setup with AT Protocol OAuth (DPoP).

Notification channel

Send Bluesky posts and direct messages using Laravel’s notification system.

Feed Generator

Build and publish custom algorithmic feeds on Bluesky.

References

Last modified on April 26, 2026