Async Github identicon avatars detection on user signup

Author: mr-chok

app/Http/Controllers/Auth/RegisterController.php

@@ -5,6 +5,7 @@
 use App\Http\Controllers\Controller;
 use App\Http\Requests\RegisterRequest;
 use App\Jobs\RegisterUser;
+use App\Jobs\UpdateUserIdenticonStatus;
 use App\Models\User;
 use App\Providers\AppServiceProvider;
 use Illuminate\Auth\Events\Registered;
@@ -70,6 +71,8 @@ public function register(RegisterRequest $request)
     protected function create(RegisterRequest $request): User
     {
         $this->dispatchSync(RegisterUser::fromRequest($request));
+        $user = User::findByEmailAddress($request->emailAddress());
+        $this->dispatch(new UpdateUserIdenticonStatus($user));
 
         return User::findByEmailAddress($request->emailAddress());
     }

app/Jobs/UpdateUserIdenticonStatus.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace App\Jobs;
+
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Bus\Dispatchable;
+use Illuminate\Foundation\Queue\Queueable;
+use Illuminate\Queue\InteractsWithQueue;
+use Illuminate\Queue\SerializesModels;
+use App\Models\User;
+use App\Social\GithubUserApi;
+
+final class UpdateUserIdenticonStatus implements ShouldQueue
+{
+    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
+
+    public function __construct(private User $user) {}
+
+    public function handle(GithubUserApi $github): void
+    {
+        $hasIdenticon = $github->hasIdenticon($this->user->githubId());
+        $this->user->update(['has_identicon' => $hasIdenticon]);
+    }
+}

app/Models/User.php

@@ -58,6 +58,7 @@ final class User extends Authenticatable implements MustVerifyEmail
         'remember_token',
         'bio',
         'banned_reason',
+        'has_identicon'
     ];
 
     /**
@@ -113,6 +114,11 @@ public function githubUsername(): string
         return $this->github_username ?? '';
     }
 
+    public function hasIdenticon(): bool
+    {
+        return (bool) $this->has_identicon;
+    }
+
     public function twitter(): ?string
     {
         return $this->twitter;

app/Social/GithubUserApi.php

@@ -14,4 +14,25 @@ public function find(int|string $id): ?GitHubUser
 
         return $response->failed() ? null : new GitHubUser($response->json());
     }
+
+    public function hasIdenticon(int|string $id): bool
+    {
+        $detectionSize = 40;
+        $response = Http::retry(3, 300, fn ($exception) => $exception instanceof ConnectionException)
+            ->get("https://avatars.githubusercontent.com/u/{$id}?v=4&s={$detectionSize}");
+
+        if ($response->failed()) {
+            return true;
+        }
+
+        $info = getimagesizefromstring($response->body());
+
+        if (!$info) {
+            return true;
+        }
+
+        [$width, $height] = $info;
+
+        return !($width === 420 && $height === 420);
+    }
 }

database/migrations/2025_09_11_152525_add_has_identicon_to_users_table.php

@@ -0,0 +1,16 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::table('users', function (Blueprint $table) {
+            $table->boolean('has_identicon')->after('bio')->default(false);
+        });
+    }
+
+};

resources/views/components/avatar.blade.php

@@ -4,7 +4,7 @@
 ])
 
 <?php
-$src = $user->githubId()
+$src = $user->githubId() && !$user->hasIdenticon()
     ? sprintf('https://avatars.githubusercontent.com/u/%s', $user->githubId())
     : asset('https://laravel.io/images/laravelio-icon-gray.svg');
 ?>