Importer et déployer un projet existant

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

⏰ Durée estimée : 10 minutes Utilisez ce guide si vous disposez déjà de code, d’un projet provenant d’un autre outil ou d’une archive ZIP et que vous souhaitez continuer à le développer dans Replit. L’importation est la première étape. Le véritable objectif est de faire fonctionner le projet, de comprendre la configuration nécessaire, de le publier et de vérifier que la version publique fonctionne.

​

Ce que vous accomplirez

À la fin de ce guide, vous aurez :

• Un projet existant importé dans Replit.
• Un résumé par l’Agent du framework, des dépendances, des commandes et de la configuration manquante.
• Un aperçu fonctionnel.
• Les Secrets ou variables d’environnement requis ajoutés au bon endroit.
• Une URL publiée que vous avez testée comme un visiteur pour la première fois.

​

Ce que vous apprendrez

Vous apprendrez à :

• Demander à l’Agent d’inspecter un projet importé avant de modifier son comportement.
• Identifier les commandes d’exécution, les commandes de build, les dépendances, les ports et les Secrets.
• Corriger les problèmes de configuration dans le plus petit ordre possible.
• Tester l’application dans l’aperçu avant de la publier.
• Vérifier l’application publiée après le déploiement.

​

À qui s’adresse ce guide

Utilisez ce guide si vous importez :

• Un dépôt GitHub.
• Un projet Figma, Bolt, Lovable, Base44, Vercel ou ZIP.
• Du code commencé par quelqu’un d’autre.
• Un ancien projet que vous souhaitez continuer avec l’Agent.

Pour les étapes d’importation spécifiques à la source, consultez Importer depuis GitHub ou l’aperçu Importation.

​

Importer le projet

Ouvrez replit.com/import, choisissez la source et suivez le flux d’importation. Une fois le projet ouvert dans Replit, résistez à l’envie de demander de nouvelles fonctionnalités immédiatement. Commencez par demander à l’Agent d’inspecter ce que vous avez importé. Les projets importés nécessitent souvent une configuration car les valeurs locales, les identifiants privés et les paramètres de déploiement ne se transfèrent pas toujours depuis l’environnement d’origine.

​

Faire fonctionner l’aperçu

L’aperçu doit fonctionner avant de publier. Si l’application ne démarre pas, demandez à l’Agent de corriger les problèmes de configuration dans l’ordre plutôt que de réécrire l’application. Vérifiez :

• Les dépendances s’installent correctement.
• La commande d’exécution démarre l’application.
• L’application écoute sur le port attendu.
• L’aperçu s’ouvre sans page blanche ni écran d’erreur.
• Le flux principal de l’application fonctionne.

Si l’Agent suggère de modifier le comportement avant que l’application ne fonctionne, demandez-lui de faire une pause et de se concentrer uniquement sur la configuration.

​

Ajouter les Secrets et paramètres manquants

Les valeurs secrètes ne s’importent pas depuis GitHub ni depuis la plupart des sources externes. Ajoutez les clés API, jetons, URL de base de données et identifiants de fournisseurs via les Secrets, et non dans le code. Demandez à l’Agent d’identifier les valeurs manquantes sans les inventer. Si l’application possède une commande d’exécution ou de build personnalisée, consultez la documentation correspondante pour les Workflows et la Configuration.

​

Tester avant de publier

Ouvrez l’aperçu et testez l’application importée comme un visiteur pour la première fois. Vérifiez :

• La page d’accueil se charge.
• La navigation principale fonctionne.
• Les formulaires, boutons, connexion, paiement, téléversements ou appels API fonctionnent si l’application les utilise.
• L’actualisation de la page ne casse pas l’application.
• Le redémarrage de l’application fonctionne encore.
• Les journaux n’affichent pas d’erreurs cachées.

Si quelque chose échoue, décrivez le symptôme à l’Agent.

​

Publier et vérifier

Publiez uniquement après que l’aperçu fonctionne. Ajoutez les Secrets et variables d’environnement de production dans le volet de publication si l’application en a besoin. Les valeurs utilisées dans l’aperçu peuvent ne pas exister automatiquement pour l’application publiée. Après la publication :

• Ouvrez l’URL publique dans un nouvel onglet.
• Exécutez le même flux principal que vous avez testé dans l’aperçu.
• Vérifiez les fonctionnalités réservées à la production comme les callbacks de connexion, les appels API, les redirections de paiement et l’accès à la base de données.
• Confirmez que l’application fonctionne toujours sur mobile si les visiteurs utilisent des téléphones.

Si la publication échoue, utilisez Résoudre les problèmes de publication.

​

C’est terminé quand

• Le projet s’importe correctement.
• L’Agent a identifié le framework, les commandes, les ports, les dépendances et les Secrets requis.
• L’aperçu démarre et le flux principal fonctionne.
• Les Secrets requis sont stockés en dehors du code.
• L’application se publie correctement.
• L’URL publique fonctionne lorsqu’elle est testée depuis un nouvel onglet.

​

Améliorer ensuite

​

Besoin d’aide supplémentaire ?

• L’importation réussit mais l’application ne démarre pas : vérifiez les dépendances, les commandes d’exécution, les ports et les variables d’environnement manquantes.
• L’aperçu fonctionne mais la publication échoue : vérifiez les Secrets de production, l’accès à la base de données, la liaison d’hôte et la configuration des ports.
• Les fichiers téléversés disparaissent après la publication : utilisez une base de données ou un service de stockage pour les données persistantes.
• L’Agent veut réécrire l’application : demandez-lui de se concentrer d’abord sur la configuration et de préserver le comportement existant.

​

Ressources connexes

• Importation
• Secrets
• Workflows
• Résoudre les problèmes de publication