> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Laravel Bluesky

> Panoramica, requisiti, installazione, configurazione iniziale e primo post di revolution/laravel-bluesky.

## Panoramica

[revolution/laravel-bluesky](https://github.com/invokable/laravel-bluesky) è un pacchetto per usare AT Protocol (Bluesky) da Laravel.

La Facade è `Revolution\Bluesky\Facades\Bluesky`. Puoi gestire creazione post, recupero feed, ricerca, pubblicazione di media e altro con uno stile simile al client HTTP di Laravel.

## Requisiti

* PHP `>= 8.3`
* Laravel `>= 12.x`

## Installazione

```bash theme={null}
composer require revolution/laravel-bluesky
```

## Variabili d'ambiente

Se usi l'autenticazione tramite App Password, configura `.env`.

```dotenv theme={null}
BLUESKY_IDENTIFIER=your-handle.bsky.social
BLUESKY_APP_PASSWORD=xxxx-xxxx-xxxx-xxxx
```

## Quick start

### Primo post

```php theme={null}
use Revolution\Bluesky\Facades\Bluesky;

$response = Bluesky::login(
    identifier: config('bluesky.identifier'),
    password: config('bluesky.password'),
)->post('Hello Bluesky');
```

### Gestire link e tag con TextBuilder

```php theme={null}
use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Record\Post;
use Revolution\Bluesky\RichText\TextBuilder;

$post = Post::build(function (TextBuilder $builder) {
    $builder->text('Hello Bluesky')
        ->newLine(count: 2)
        ->link('https://bsky.app/')
        ->newLine()
        ->tag('#Bluesky');
});

$response = Bluesky::login(
    identifier: config('bluesky.identifier'),
    password: config('bluesky.password'),
)->post($post);
```

<Warning>
  `searchPosts()` attualmente non funziona senza autenticazione a causa di una restrizione temporanea dell'API. Anche per usare la ricerca, usa una sessione autenticata.
</Warning>

## Documentazione

<Columns cols={2}>
  <Card title="Basic client" href="/it/packages/laravel-bluesky/basic-client" icon="terminal-square">
    App Password / OAuth, post, media, risposte, citazioni, feed e ricerca.
  </Card>

  <Card title="Socialite" href="/it/packages/laravel-bluesky/socialite" icon="shield-check">
    Configurazione e uso di Socialite specifica per Bluesky con AT Protocol OAuth (DPoP).
  </Card>

  <Card title="Canale di notifica" href="/it/packages/laravel-bluesky/notification" icon="bell">
    Invia post e DM a Bluesky come canale Laravel Notification.
  </Card>

  <Card title="Feed Generator" href="/it/packages/laravel-bluesky/feed-generator" icon="rss">
    Crea e pubblica feed algoritmici personalizzati.
  </Card>
</Columns>

## Link di riferimento

* GitHub: [invokable/laravel-bluesky](https://github.com/invokable/laravel-bluesky)
* DeepWiki: [invokable/laravel-bluesky](https://deepwiki.com/invokable/laravel-bluesky)


## Related topics

- [Laravel Bluesky](/en/packages/laravel-bluesky/index.md)