Supabase › Initialiser son projet
Apprenez à initialiser votre projet Supabase : créer un compte, créer un projet, récupérer vos clés, installer le SDK et configurer le client.
Créer un compte Supabase
Rendez-vous sur supabase.com et inscrivez-vous avec votre email ou votre compte GitHub.
Créer un projet
Une fois connecté au dashboard, choisissez votre organisation et cliquez sur New Project :
- Donnez un nom à votre projet
- Sélectionnez la région la plus proche de vos utilisateurs
- Définissez un mot de passe pour votre base PostgreSQL
Se connecter à Supabase
Une fois le projet Supabase prêt, il est temps de s’y connecter afin de pouvoir interagir avec la base de données, l’authentification ou le stockage.
Informations de connexion
URL de connexion
Dans le dashboard Supabase de votre projet, vous retrouverez dans Settings > Data API l’URL unique de votre projet.
Son format est le suivant :
https://********.supabase.co
Elle constituera la base de vos endpoints API pour interagir avec votre base de données, l’authentification et le stockage.
Clés API
Pour accéder à l’API RESTful de Supabase, vous devez utiliser des clés API.
Ces clés sont accessibles depuis l’onglet Settings > API Keys de votre projet Supabase.
Supabase fournit deux types de clés :
| Nom de la clé | Description | Format |
|---|---|---|
| Clé publique | Utilisable côté client (frontend) de manière sécurisée à condition que les RLS policies (Row Level Security) soient activées sur les tables concernées pour sécuriser l’accès aux données. | sb_publishable_***************** |
| Clés secrètes | Accès complet aux APIs du projet. À utiliser uniquement côté serveur (backend, fonctions, workers, etc.). | sb_secret_***************** |
Voyez les RLS policies comme des pare-feux applicatifs qui permettent de contrôler qui peut et qui ne peut pas exploiter vos données.
Connexion via cURL (Bash)
Vous pouvez tester la connexion à votre projet Supabase en utilisant cURL dans votre terminal Bash.
curl GET 'https://********.supabase.co/rest/v1/...' \
-H "apikey: votre_cle_publique"
Cette commande vous permet de faire une requête GET vers l’API RESTful de Supabase en transmettant votre clé publique en en-tête HTTP pour authentifier la requête.
cURL c’est sympa, mais si vous souhaitez interagir avec Supabase depuis votre application, il est préférable d’utiliser un SDK adapté à votre langage de programmation. Et bonne nouvelle… Supabase a pensé à tout !
Connexion via un SDK
Installer le SDK
En fonction du langage de programmation que vous utilisez pour votre frontend, Supabase propose des SDK adaptés :
je m’intéresserai dans cette formation à la librairie JavaScript, qui est la plus utilisée et polyvalente pour les applications web et mobiles.
Vous pouvez par exemple utiliser npm pour installer le client JavaScript :
npm install @supabase/supabase-js
Supabase propose également d’installer le client via CDN avec :
<script src="https://unpkg.com/@supabase/supabase-js@2"></script>
Si vous utilisez un framework comme Vue, React, Ionic ou de nombreux autres, Supabase propose des « Quickstarts » pour vous aider à démarrer rapidement. Vous pouvez les trouver dans la documentation officielle.
Configurer le client
Afin d’utiliser Supabase dans votre application, vous devez créer une instance du client en établissant une connexion avec le backend Supabase.
Vous devez, pour cela, fournir à votre client JS l’URL de votre projet et la clé publique que vous avez récupérée précédemment.
import { createClient } from '@supabase/supabase-js'
const supabaseUrl = 'https://********.supabase.co'
const supabaseKey = 'votre_cle_publique'
const supabase = createClient(supabaseUrl, supabaseKey)
Cette configuration vous permet désormais, via votre objet supabase, de faire vos requêtes vers votre base, gérer l’authentification et le stockage.