# Magic Social Auth

**Sosyal giriş, tek bir facade ile.**

iOS ve Android'de yerel Google girişi, iOS'ta yerel Apple girişi; GitHub, Microsoft ve geri kalanı için backend'in sunduğu bir tarayıcı akışı; iOS, Android ve web'de. Hazır `SocialAuthButtons` dahil.

## Tek facade. Dört provider.

Google, Apple, GitHub ve Microsoft; iOS, Android ve web'de, tek bir `SocialAuth` facade'i arkasında. `magic-starter-laravel` sosyal girişinin istemcisidir, bu yüzden o backend gerekir.

### Tek facade API

`SocialAuth.driver(name).signIn()` giriş yaptırır, `SocialAuth.supports(name)` bir provider'ı sorgular, `SocialAuth.signOut()` çıkış yaptırır. Laravel Socialite kullananlar şekli tanır.

[Daha fazla Tek facade API hakkında](https://anilcancakir.com/magic/docs/social_auth/architecture/overview.md)

### Yerel giriş ekranları

Google iOS ve Android'de `google_sign_in` ile, Apple iOS'ta `sign_in_with_apple` ile yereldir. Android ve web'de Apple tarayıcı akışını kullanır.

[Daha fazla Yerel giriş ekranları hakkında](https://anilcancakir.com/magic/docs/social_auth/basics/drivers.md)

### PKCE ile tarayıcı akışı

GitHub ve Microsoft her platformda, Google ise web'de bunu kullanır. Akışı backend sunar; web'de bir popup sayfa (`auth.html`) sonucu uygulamaya geri iletir.

[Daha fazla PKCE ile tarayıcı akışı hakkında](https://anilcancakir.com/magic/docs/social_auth/basics/flows.md)

### Bağlama ve onay

Giriş yapmış bir kullanıcının hesap bağlaması için driver sözleşmesi `beginConnect`, `connect` ve `confirm` sunar.

[Daha fazla Bağlama ve onay hakkında](https://anilcancakir.com/magic/docs/social_auth/basics/flows.md)

### Komut satırıyla kurulum

`social:install` yerel kurulumu yapar; `social:doctor` onu denetler ve backend `.env` satırlarını yazdırır.

[Daha fazla Komut satırıyla kurulum hakkında](https://anilcancakir.com/magic/docs/social_auth/getting-started/installation.md)

### Özel driver'lar

Kendi driver'ınızı `SocialAuth.manager.extend(name, factory)` ile kaydedin; driver `SocialDriver` sözleşmesini uygular.

[Daha fazla Özel driver'lar hakkında](https://anilcancakir.com/magic/docs/social_auth/basics/drivers.md)

## Saniyeler içinde ekleyin

```bash
flutter pub add magic_social_auth
```

Ya da `pubspec.yaml` dosyasına ekleyin:

```yaml
dependencies:
  magic_social_auth: ^1.0.2
```

Ya da yapay zeka ajanınıza şu istemi verin:

```text
https://anilcancakir.com/magic/docs/social_auth/llms.txt adresini oku ve Magic Social Auth paketini bu projeye kur.
```

## Dokümanlar

### Getting Started

- [Installation](https://anilcancakir.com/magic/docs/social_auth/getting-started/installation.md)
- [Configuration](https://anilcancakir.com/magic/docs/social_auth/getting-started/configuration.md)

### The Basics

- [Drivers](https://anilcancakir.com/magic/docs/social_auth/basics/drivers.md)
- [Flows](https://anilcancakir.com/magic/docs/social_auth/basics/flows.md)

### Architecture

- [Architecture Overview](https://anilcancakir.com/magic/docs/social_auth/architecture/overview.md)