# 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](account.md).

## 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](account.md).

## 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 :

| Champ | Ce qu'il est |
| --- | --- |
| Branche | La branche à mettre en ligne, `main` par défaut. C'est elle que la plateforme construit. |
| Nom du projet | Le nom affiché dans la console, tiré du dépôt. Il se change à tout moment. |
| Identifiant | Il entre dans l'adresse du site et ne se change plus : minuscules, chiffres et tirets, de 2 à 63 caractères. |

3. 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](git.md) et [Déployer](deploy.md).
- Ajoutez vos variables d'environnement dans **Variables** : voir [Environnements](environments.md).
- Rattachez votre propre domaine dans **Domaines** : voir [Domaines](domains.md).
- Une mise en ligne ratée se défait sans reconstruire : voir [Restaurer](restore.md).

## La même chose par la ligne de commande

```sh
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.

```sh
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 :

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

Voir [Ligne de commande](cli.md) et la [référence de la ligne de commande](../reference/ligne-de-commande.md).

## 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](project.md).

> **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](project.md).

## Erreurs fréquentes

| Ce que vous voyez | Remède |
| --- | --- |
| Aucun courriel après « Recevoir le lien » | Regardez les indésirables. Un compte existe peut-être déjà à cette adresse : connectez-vous ou demandez un nouveau mot de passe. |
| « Cette invitation n'ouvre aucun compte » | Le lien est expiré, déjà servi ou inconnu : refaites la demande sur `/creer-un-compte`. |
| La carte « Importer un dépôt » ne montre pas votre dépôt | Seuls les dépôts ouverts à l'application GitHub sont listés, et les 300 plus récemment poussés : ajoutez le dépôt à l'installation chez GitHub, ou collez son adresse. |
| « L'adresse doit commencer par https://, ssh:// ou git:// » | Recopiez l'adresse telle que GitHub l'affiche. |
| L'identifiant est refusé | Minuscules, chiffres et tirets, de 2 à 63 caractères, sans tiret initial, et unique dans l'organisation. |
| La mise en ligne échoue | Lisez la cause et le lieu affichés, corrigez, puis « Redéployer ». Voir [Constructions](builds.md) et [Dépannage](troubleshooting.md). |

## Voir aussi

- [Concepts](concepts.md)
- [Compte](account.md)
- [Créer un projet](project.md)
- [Déployer](deploy.md)