Votre premier site

Cette procédure pas à pas va plus loin que Quickstart. Nous connectons un dépôt, examinons le manifeste du site produit par Showly, apportons une modification directement dans l'éditeur et l'expédions.

Connecter le référentiel

Depuis l'accueil de l'espace de travail, cliquez sur Connecter un site. La boîte de dialogue de l'application GitHub s'ouvre. Prendre:

• l'organisation ou le compte personnel propriétaire du référentiel
• le référentiel auquel vous souhaitez vous connecter

L'application GitHub demande Contenu : lecture et écriture sur les référentiels que vous sélectionnez — GitHub l'accorde au niveau du référentiel, et non par branche. En tant que politique produit, Showly ne s'engage que sur les branches sous le préfixe showly/* ; il ne pousse pas vers votre branche par défaut.

Après autorisation, le référentiel apparaît dans votre espace de travail avec le statut Importation.

Consultez le manifeste du site

L'étape d'importation écrit un manifeste showly.json dans l'espace de travail importé. Il s'agit d'un point de départ détecté automatiquement — Showly inspecte le dépôt et propose des valeurs ; vous pouvez ensuite consulter et remplacer n'importe quel champ. Cela ressemble à ceci :

{
  "rootDirectory": ".",
  "runtime": "node",
  "runtimeVersion": "22",
  "packageManager": "pnpm",
  "installCommand": "pnpm install",
  "buildCommand": "pnpm build",
  "output": {
    "directory": ".next"
  }
}

Le framework est détecté automatiquement (Showly reconnaît Astro, Vite, l'exportation Next.js et le HTML statique brut), il ne s'agit donc pas d'un champ que vous définissez dans le manifeste.

Le manifeste est la source de vérité que Showly utilise pour chaque build et chaque requête de contexte d'agent. Si le processus de construction de votre dépôt change, modifiez le manifeste — ne combattez pas la détection automatique de Showly. Voir Manifeste du site pour la référence complète du schéma et des champs.

Définir les variables d'environnement

Ouvrez le panneau Environnement du site et définissez les variables dont votre build et votre runtime ont besoin. Showly ne lit jamais les secrets de votre dépôt ; vous les définissez par environnement (preview, production), de sorte qu'une version préliminaire peut utiliser des valeurs différentes de celles de la production.

Effectuer une modification dans l'éditeur

L'éditeur Showly ouvre un panneau de discussion à côté d'une arborescence de fichiers. Essayer:

Ajoutez un nouvel itinéraire /about avec une courte bio.

L'agent répondra avec un plan de modification répertoriant les fichiers qu'il créera. Cliquez sur Appliquer le plan pour matérialiser le correctif dans un espace de travail isolé, créer et produire un aperçu.

La construction passe par queued → building et atterrit sur ready (un petit changement typique prend bien moins d'une minute). Lorsqu'elle atteint ready, l'URL d'aperçu apparaît dans le panneau Aperçu : ouvrez-le pour voir votre modification en direct sur un déploiement d'aperçu isolé. Si la build se termine par failed, développez le déploiement pour lire les journaux de build, corrigez le problème (souvent une commande de build ou un paramètre d'exécution dans le manifeste) et appliquez à nouveau.

Publier

Dans le panneau Releases, choisissez l'aperçu ready que vous souhaitez expédier. La publication ne nécessite jamais d’inscription à OTP/MFA.

Qui peut approuver dépend de votre plan. Sur les plans avec des workflows d'approbation activés, une demande de publication nécessite une approbation d'un owner ou d'un admin, et le demandeur ne peut pas s'auto-approuver. Sur Free et Pro il n'y a pas de deuxième réviseur : cliquez sur Publier ou utilisez la confirmation en deux étapes publish_site de l'agent.

Ce que vous venez d'exercer

• GitHub importer → manifeste du site
• Vars d'environnement par environnement
• Chat → changer de plan → patch → aperçu
• Approbation → publication de production

C'est toute la boucle de publication. Chaque flux de travail ultérieur dans Showly est une variante de ce même chemin.