Démarrage rapide

Cette page vous mène de zéro à un site en ligne : créer un compte, raccorder GitHub, créer un projet et suivre sa première mise en ligne. Comptez une dizaine de minutes, construction comprise. La même chose se fait ensuite par la ligne de commande ou par un agent, en fin de page.

Ce qu'il vous faut

• Une adresse de courriel que vous consultez.
• Un dépôt Git qui contient une application web. Un dépôt GitHub public suffit ; un dépôt privé demande l'application GitHub de Bastide, installée à l'étape 3.
• Un navigateur. Aucune commande n'est à saisir pour le parcours de la console.

Note. Bastide est en bêta. La bêta est gratuite, ne demande aucun moyen de paiement et ne prend aucun engagement de disponibilité : mettez-y des applications qui ne sont pas critiques. Les conditions se lisent sur https://console.bastide.app/beta.

1. Créer votre compte

1. Ouvrez https://console.bastide.app/creer-un-compte (ou « Créer un compte » sous le formulaire de Connexion).
2. Saisissez votre adresse de courriel et le nom de votre organisation (votre entreprise ou votre équipe, de 2 à 100 caractères ; il se change plus tard).
3. Cochez la case des conditions de la bêta, puis « Recevoir le lien ».
4. Ouvrez le courriel reçu. Le lien vaut sept jours et ne sert qu'une fois ; il mène à la page Ouvrir un compte (/ouvrir-un-compte).
5. Choisissez votre mot de passe (12 caractères au moins), cochez les conditions, puis « Ouvrir le compte ».

Le compte et l'organisation sont créés ensemble, et vous en êtes Propriétaire. La console vous fait entrer dans l'organisation ; si elle n'y parvient pas, connectez-vous avec votre adresse et votre mot de passe.

Conseil. Rien reçu après quelques minutes ? Regardez les indésirables. Si un compte porte déjà cette adresse, aucun lien ne part : connectez-vous, ou demandez un nouveau mot de passe. Le détail est dans Compte.

2. Poser un second facteur

Ouvrez Compte, section « Sécurité », et ajoutez une application d'authentification ou une clé d'accès. Gardez les dix codes de récupération affichés à la fin : ils ne seront plus montrés. Ce n'est pas obligatoire pour mettre un site en ligne, mais l'écriture SQL, les migrations de schéma et la gestion des clés du backend l'exigent, et une organisation peut l'imposer. Voir Compte.

3. Raccorder GitHub

Ouvrez Projets, puis « Nouveau projet ». L'écran Nouveau projet montre une carte « Importer un dépôt » :

1. Cliquez « Raccorder un compte GitHub ». La console vous envoie chez GitHub installer l'application de Bastide, sur le compte ou l'organisation GitHub de votre choix et sur les dépôts que vous choisissez.
2. GitHub vous ramène sur Nouveau projet. La carte liste désormais vos dépôts, du dernier poussé au plus ancien, privés compris.

Le raccordement demande le rôle Administrateur de l'organisation ; il se gère ensuite dans Réglages de l'organisation, carte « GitHub ». Pour un dépôt public, vous pouvez sauter cette étape et coller son adresse.

4. Créer le projet

Sur Nouveau projet :

1. Cliquez « Importer » sur la ligne du dépôt, ou collez son adresse dans le champ du haut (https://, ssh:// ou git://).
2. Vérifiez les champs que la console a déduits :

1. Cliquez « Créer et mettre en ligne ».

Rien d'autre n'est demandé : la commande de construction, le dossier de sortie et le cadriciel sont détectés dans le dépôt. Le projet naît au palier Découverte, avec son environnement de production et sa base de données, et le premier déploiement part aussitôt.

Partir d'un modèle

Pas encore de dépôt ? Le bouton « Modèles » de Nouveau projet ouvre Modèles de départ : une vingtaine de modèles écrits par Glowsoft (sites Next.js, Astro, Nuxt ou SvelteKit, applications React, API Fastify, FastAPI ou Go, entre autres), filtrables par catégorie. Choisissez-en un : le formulaire demande chaque variable requise, avec sa description et le lien où l'obtenir, avant de lancer la construction. « Déployer » crée le projet, écrit vos valeurs en production, puis construit. Chaque modèle est construit et déployé chaque semaine ; celui qui échoue deux fois de suite quitte le catalogue.

5. Suivre la première mise en ligne

La console passe à l'écran Première mise en ligne. Il suit le déploiement et la base de données, étape par étape, avec le journal de construction en direct et une estimation du temps restant. Il finit de deux façons :

• En ligne : « Votre site est en ligne », avec l'adresse HTTPS du site, les points d'entrée de la base et sa clé publiable.
• En échec : la cause, l'endroit où corriger et l'action à mener. Corrigez le dépôt (une poussée suffit) ou le réglage indiqué, puis « Redéployer ». « Annuler la mise en ligne » arrête une construction en cours.

L'adresse du site s'affiche aussi sur la Vue d'ensemble du projet, sous « Adresse de production ».

6. Et ensuite

• Chaque poussée sur la branche de production redéploie le site : voir Git et Déployer.
• Ajoutez vos variables d'environnement dans Variables : voir Environnements.
• Rattachez votre propre domaine dans Domaines : voir Domaines.
• Une mise en ligne ratée se défait sans reconstruire : voir Restaurer.

La même chose par la ligne de commande

npm install -g bastide
bastide login

bastide login affiche une adresse et un code, et ouvre votre navigateur sur Autoriser la ligne de commande : comparez le code à celui du terminal, puis autorisez. Aucun mot de passe ne passe par le terminal. La commande liste ensuite vos organisations ; bastide account organization list les relit.

bastide project create_with_backend \
  --organization-id org_01JQ8ZK4M7NP2RSTVWXYZ34567 \
  --slug ma-boutique \
  --name "Ma boutique" \
  --git-remote https://github.com/votre-compte/ma-boutique \
  --idempotency-key creation-ma-boutique-001

La réponse porte le projet, l'identifiant de sa production (environmentId), le déploiement lancé et une liste suivi qui dit quoi relire, adresse attribuée comprise. Suivez le déploiement :

bastide deployment read --project-id prj_… --deployment-id dep_…
bastide deployment log read --project-id prj_… --deployment-id dep_…

Voir Ligne de commande et la référence de la ligne de commande.

La même chose par un agent

Branchez votre agent sur le serveur MCP https://mcp.bastide.app/mcp, puis demandez-lui de créer le projet : il appelle project_create_with_backend, suit le travail par task_read ou deployment_read, et lit le journal par deployment_log_read en cas d'échec. Le parcours complet, champ par champ, est dans Créer un projet.

Note. Un projet créé par un agent naît « non revendiqué » : il s'éteint au bout de sept jours si personne ne le revendique depuis la console. Voir Créer un projet.

Erreurs fréquentes

Voir aussi

• Concepts
• Compte
• Créer un projet
• Déployer

Signaler une erreur sur cette page