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

# Installation

> Installez le CLI OnePub, authentifiez-vous et ajoutez le SDK Flutter GimPay à votre projet.

## Installer le CLI OnePub

<Steps>
  <Step title="Installez le CLI (une fois par machine)">
    ```bash theme={null}
    dart pub global activate onepub
    ```

    <Note>
      Vérifiez que le répertoire des exécutables pub (`%LOCALAPPDATA%\Pub\Cache\bin` sous Windows, `~/.pub-cache/bin` sous macOS/Linux) est dans votre `PATH`.
    </Note>
  </Step>

  <Step title="Authentifiez-vous">
    ```bash theme={null}
    onepub login
    ```

    Une page de connexion s'ouvre dans le navigateur — utilisez le compte avec lequel vous avez été invité. La commande écoute sur `http://127.0.0.1:42666/` pour récupérer le token : si un pare-feu bloque le port TCP 42666, débloquez-le temporairement.
  </Step>

  <Step title="Ajoutez la dépendance">
    Dans le dossier de votre projet Flutter :

    ```bash theme={null}
    onepub pub add gimpay_sdk
    flutter pub get
    ```

    La commande ajoute au `pubspec.yaml` une dépendance `hosted:` pointant vers le dépôt privé et configure le token d'accès.
  </Step>
</Steps>

### Équivalent manuel

Si vous préférez éditer le `pubspec.yaml` directement (l'URL `hosted` exacte figure sur votre profil OnePub) :

```yaml pubspec.yaml theme={null}
dependencies:
  gimpay_sdk:
    version: ^0.3.0
    hosted: https://onepub.dev/api/<id-organisation>
```

## Intégration continue (CI)

Votre pipeline ne peut pas ouvrir un navigateur : il utilise un **token membre exporté** plutôt que `onepub login`.

<Steps>
  <Step title="Exportez votre token">
    Sur votre poste déjà authentifié :

    ```bash theme={null}
    onepub export
    ```

    Copiez la valeur affichée.
  </Step>

  <Step title="Stockez-le dans les secrets de votre CI">
    Sous le nom `ONEPUB_TOKEN` (GitHub Secrets, GitLab CI variables...).

    <Warning>
      Ne committez jamais ce token : il donne accès au dépôt privé avec vos droits.
    </Warning>
  </Step>

  <Step title="Utilisez-le dans le pipeline">
    Avant `flutter pub get` :

    ```bash theme={null}
    dart pub global activate onepub
    onepub import   # lit ONEPUB_TOKEN depuis l'environnement
    flutter pub get
    ```
  </Step>
</Steps>

## Étapes suivantes

<Card title="Démarrage rapide" icon="rocket" href="/sdks/quickstart">
  Initialisez le SDK et effectuez votre premier appel.
</Card>