Foire aux questions

Foire aux questions

  • Acceptez-vous des sponsors

    Oui, absolument - et nous serions ravis de votre soutien.

    Les parrainages maintiennent le projet en vie et nous permettent de pousser des mises à jour, des correctifs et de nouvelles fonctionnalités pour toutes les personnes qui utilisent Stardrive.

    Vous pouvez soutenir le projet via le bouton GitHub Sponsors sur le dépôt.

    Chaque étoile, chaque partage et chaque sponsor fait une vraie différence - merci de garder l’open source en bonne santé.

  • Comment commencer

    Lancez npm create stardrive@latest et suivez les indications.

    Vous pouvez aussi cloner ou forker le dépôt directement et lancer npm install.

    Démarrez le serveur de développement avec npm run dev.

    À partir de là, ajustez theme.config.ts à votre marque, remplacez les favicons et les images sociales dans /public, et modifiez les collections de contenu dans /src/content selon vos besoins.

    Si vous utilisez un assistant de code IA, dirigez-le vers le dépôt et le fichier AGENTS.md - Stardrive est conçu pour être repris et étendu par des LLMs dès le départ.

    Consultez la section docs pour des indications plus détaillées sur la configuration, la structure et le déploiement.

  • Comment effectuer une mise à niveau

    En raison de son caractère de modèle, la mise à niveau d’un projet Stardrive vers la dernière version de Stardrive peut être un défi.

    Tu peux le mettre à jour en récupérant la dernière version depuis le dépôt GitHub (via git pull).

    Cependant, garde à l’esprit qu’en fonction de l’ampleur de tes modifications, tu peux facilement rencontrer des conflits susceptibles de bloquer complètement ce processus.

    Dans ce cas, tu devrais adapter le code manuellement, en comparant les changements actuels avec ta version et en mettant à jour les fichiers un par un. Tu peux aussi confier cette tâche à un agent de codage IA, qui la réalisera pour toi.

    Dans la plupart des cas, tu n’as pas nécessairement besoin de mettre à niveau la version de Stardrive, mais simplement le paquet Astro sous-jacent.

    Exécute npx @astrojs/upgrade pour ce faire. Garde à l’esprit que cela peut également comporter quelques tâches manuelles. Jette un œil à la documentation officielle d’Astro et surtout aux changelogs et guides de migration.

    Note : La version locale de Stardrive est fixée dans le package.json sous la clé stardriveVersion. Lorsque tu vérifies les modifications, compare les notes de version du dépôt GitHub avec l’état de ta version locale pour voir ce qui a changé depuis.

  • Dois-je abandonner React

    Non - et vous n’avez pas à le faire.

    Astro n’est pas un remplaçant de React. C’est la couche qui l’entoure. Vous pouvez continuer à utiliser des composants React dans des pages Astro à chaque fois que vous avez besoin de vraie interactivité, et Astro ne livrera que le JavaScript réellement nécessaire.

    Il en va de même pour Vue, Svelte et Solid - vous pouvez les mélanger dans le même projet.

    Utilisez Astro pour la structure, le contenu et la base de performance. Utilisez React (ou le framework de votre choix) pour les parties véritablement interactives. Le meilleur des deux mondes.

  • Dois-je être développeur

    Pas forcément - mais une compréhension de base du fonctionnement d’un site web aide vraiment.

    Stardrive est conçu pour qu’un assistant de code IA puisse faire la plus grosse partie du travail. Si vous savez décrire ce que vous voulez et relire les changements faits par un agent, vous pouvez aller très loin sans écrire de code vous-même.

    Cela dit, des choses comme déployer sur Cloudflare, éditer des fichiers de configuration ou déboguer une erreur de build inattendue seront bien plus fluides si vous (ou quelqu’un dans votre équipe) êtes à l’aise avec les bases de Git, Node.js et de la ligne de commande.

    En bref : c’est un boilerplate de niveau développeur, suffisamment accessible pour des non-développeurs travaillant avec un assistant IA. Mais ce n’est pas un outil no-code !

  • Dois-je héberger sur Cloudflare

    Non, vous êtes libre d’héberger Stardrive où vous voulez.

    Nous recommandons Cloudflare parce qu’Astro et Stardrive sont optimisés pour leur plateforme Workers, et le wrangler.jsonc ainsi que le script de purge du cache que nous incluons rendent cette configuration particulièrement fluide.

    Comme Astro est un framework frontend qui compile vers des assets statiques (avec un rendu côté serveur à la demande en option), vous pouvez déployer sur Vercel, Netlify, Cloudflare, GitHub Pages, votre propre serveur, ou tout autre hébergeur statique.

    Si vous changez d’hébergeur, retirez simplement les parties spécifiques à Cloudflare - le reste du boilerplate continuera de fonctionner tel quel.

  • Est-ce vraiment gratuit

    Oui, ce boilerplate est entièrement gratuit.

    Il s’agit d’un projet open source sous licence MIT.

    Pour nous soutenir et nous permettre de continuer à pousser le projet, vous pouvez faire un don ou parrainer le projet, laisser un bon avis quelque part, et/ou jeter un œil à nos sponsors actuels.

  • J'ai trouvé un problème

    Merci de l’avoir repéré - signalez-le pour que nous puissions le corriger.

    Le plus rapide est d’ouvrir un rapport de bug sur notre tracker d’issues GitHub. Incluez les étapes pour le reproduire, ce que vous attendiez et ce qui s’est réellement passé. Un extrait de code minimal ou une capture aide énormément.

    Si vous n’êtes pas sûr qu’il s’agisse d’un bug ou d’un comportement voulu, le tableau des discussions est un bon endroit pour poser la question d’abord.

    Les pull requests avec un correctif sont toujours bienvenues - jetez un œil aux guides de contribution avant de commencer.

  • J'ai une demande de fonctionnalité

    Super - nous adorons savoir ce qui rendrait Stardrive plus utile.

    Ouvrez une demande de fonctionnalité sur notre tracker d’issues GitHub et décrivez le cas d’usage, le problème qu’elle résout et, idéalement, une idée approximative de comment elle pourrait fonctionner.

    Pour des idées plus larges ou des discussions ouvertes, le tableau des discussions est l’endroit le mieux adapté.

    Si vous voulez contribuer la fonctionnalité vous-même, c’est encore mieux - regardez les guides de contribution et ouvrez une pull request.

  • Pourquoi Astro

    Astro est actuellement l’un des frameworks frontend les plus performants et stables, tout en restant très flexible.

    Il ne livre aucun JavaScript par défaut, ce qui signifie que votre site reste ultra rapide, accessible et SEO-friendly sans effort supplémentaire.

    En plus, Astro vous permet de mélanger des composants venant de React, Vue, Svelte ou Solid - vous n’êtes donc jamais enfermé dans une seule techno et pouvez choisir le bon outil pour chaque besoin.

    Pour un site centré sur le contenu, qui doit être rapide, stable et facile à étendre, Astro est difficile à battre.

  • Pourquoi LLM-friendly

    Les LLMs et les assistants de code font désormais partie de la plupart des workflows de développement - et ils fonctionnent au mieux sur du code et du contenu qui suit des conventions claires et prévisibles.

    Stardrive est structuré exactement comme cela. De solides défauts pour le SEO, l’accessibilité, la sécurité et les métadonnées sont déjà en place, pour qu’un agent IA puisse se concentrer sur la création de fonctionnalités plutôt que de réinventer la roue.

    Nous avons également préparé tous les fichiers markdown de guidage pour un accès facile. Les agents de code les détectent généralement de façon automatique.

    Il génère aussi automatiquement les fichiers llms.txt et llms-full.txt, pour que les assistants externes disposent d’une vue claire et lisible par machine de votre site.

    Le résultat : une itération plus rapide avec des agents IA, moins de régressions et des sites web qui restent solides, même quand la majorité du code est écrite par un modèle.

  • Puis-je construire un SaaS avec

    Oui - Stardrive est un excellent point de départ pour la partie publique d’un produit SaaS.

    Site marketing, page de tarification, blog, docs, FAQ, annuaire d’intégrations et flux d’inscription sont déjà en place et prêts à être personnalisés.

    Pour le produit lui-même - authentification, facturation, l’application elle-même, la base de données - il vous faudra un service backend dédié. Stardrive lui parle via des APIs, tout en gardant la couche marketing rapide, stable et SEO-friendly.

    Pour l’application elle-même, il peut être plus simple de la construire avec un autre framework, davantage orienté vers les pures single-page applications. Astro penche plutôt vers la manière traditionnelle de construire des sites. Cela ne convient pas à tous les besoins. Mais même dans ce cas, ce serait un bon choix pour votre page marketing.

    Voyez-le comme la porte d’entrée de votre SaaS : optimisée pour la conversion, le contenu et le référencement, pendant que votre vrai backend gère le gros œuvre.

  • Puis-je construire une application dynamique avec

    Oui et non - cela dépend de ce que vous entendez par “dynamique”.

    Astro est un framework frontend. Il s’exécute côté client et, en option, avec du rendu côté serveur à la demande et du middleware par-dessus. Cela couvre beaucoup de cas dynamiques : formulaires, recherche, filtrage, composants d’UI interactifs, pages personnalisées, etc.

    Vous pouvez même inclure des composants écrits en React, Vue ou Svelte via ce qu’on appelle les “Dynamic Islands”.

    Ce qu’il n’est pas, c’est un backend. Tout ce qui touche aux données sensibles, à la logique métier authentifiée ou à une base de données doit vivre dans un véritable service backend, avec lequel Stardrive dialogue via une API.

    Donc : UI dynamique, contenu dynamique, rendu dynamique - oui. App full-stack avec base de données et auth dans le même projet - non, pas en autonomie, et c’est volontaire.