Rolebase Développeurs

Installation & auto-hébergement

Configurez votre environnement de développement, lancez Rolebase en local et hébergez votre propre instance.

Prérequis

Avant de commencer, assurez-vous d'avoir installé les éléments suivants :

  • Node.js (v18 ou ultérieur)
  • npm (inclus avec Node.js)
  • Docker et Docker Compose (nécessaires pour le développement local avec Nhost)
  • Nhost CLI (installé globalement)
Warning 2 Docker requis

Nhost exécute ses services backend (PostgreSQL, Hasura, Auth, Storage) dans des conteneurs Docker. Assurez-vous que Docker Desktop est en cours d'exécution avant de continuer.

Cloner le dépôt

Terminal window
git clone https://github.com/Godefroy/rolebase.git
cd rolebase.io

Installer les dépendances

Rolebase utilise les workspaces npm. Installez toutes les dépendances depuis la racine :

Terminal window
npm install

Cela installe les dépendances de tous les packages : webapp, backend, shared, et plus encore.

Configurer Nhost

Rolebase utilise Nhost pour l'authentification, la base de données (PostgreSQL via Hasura) et le stockage. Pour le développement local, vous exécutez Nhost localement avec le CLI.

Se connecter à Nhost

Terminal window
nhost login

Démarrer le backend Nhost

Terminal window
nhost up

Cela lance des instances locales de PostgreSQL, Hasura, Nhost Auth et Nhost Storage via Docker. Le premier lancement peut prendre quelques minutes pour télécharger les images.

Info Circle Console Hasura

Une fois Nhost en cours d'exécution, vous pouvez accéder à la console Hasura à l'adresse http://localhost:9695 pour inspecter le schéma de la base de données et exécuter des requêtes GraphQL.

Configurer les secrets

Créez un fichier .secrets à la racine de la configuration Nhost s'il n'existe pas déjà. Ce fichier contient les secrets spécifiques à l'environnement (identifiants SMTP, clés API, etc.) requis par certaines fonctions backend.

Warning 2 Ne commitez pas les secrets

Le fichier .secrets est ignoré par git. Ne commitez jamais d'identifiants ou de clés API dans le dépôt.

Lancer le serveur de développement

Démarrez l'application web en mode développement :

Terminal window
npm run dev

Puis ouvrez votre navigateur à l'adresse http://localhost:5175.

Structure du projet

Le dépôt est un monorepo avec des workspaces npm. Consultez la vue d'ensemble de l'architecture pour le détail des packages.

Prochaines étapes

  • Explorez le guide Utiliser l'API pour apprendre à utiliser l'API GraphQL.
  • Parcourez l'API GraphQL pour le schéma complet des entités.