Astro construit par défaut un site statique : chaque page devient un fichier HTML dans dist/, avec seulement le JavaScript dont vos îlots ont besoin. Ce dossier est tout ce qu’il faut à Lobsite. Lancez npm run build, puis npx lobsite dans le projet, et le site est en ligne à une adresse *.lobsite.app en HTTPS. Vous pouvez aussi déposer dist/ dans la zone ci-dessus.
Comment ça marche
- Buildez le site avec
npm run build(c’est-à-direastro build). Les pages, images et scripts arrivent dansdist/. - Lancez
npx lobsitedans le projet. Il déploiedist/, paspublic/, qu’Astro a déjà copié dans le build. Le premier déploiement ne demande pas de compte et dure 6 heures. - Gardez-le grâce au lien de récupération, dans un compte gratuit. Le dossier est enregistré dans
lobsite.toml, donc le build suivant se déploie avec le mêmenpx lobsite.
Réglages à vérifier dans astro.config.mjs
import { defineConfig } from "astro/config";
export default defineConfig({
site: "https://my-site.lobsite.app",
trailingSlash: "ignore",
});
siteest votre adresse complète. Astro l’utilise pour les URL canoniques,Astro.siteet le sitemap de@astrojs/sitemap. Mettez votre adresse*.lobsite.app, et changez-la quand vous passez à votre propre domaine.basereste vide : le site est servi depuis la racine de son adresse, pas depuis un sous-dossier comme un site de projet GitHub Pages.build.formatpeut garder sa valeur par défaut.about/index.htmls’ouvre à/about/, et un fichierabout.htmlà/about.
Ce qui marche, et ce qui demande un serveur
Tout ce qu’Astro rend au moment du build fonctionne : content collections, Markdown et MDX, images astro:assets (optimisées pendant le build), et îlots React, Vue, Svelte ou Solid, qui s’exécutent dans le navigateur. Ce qui s’exécute à chaque requête ne fonctionne pas : pages avec export const prerender = false, output: "server", Astro Actions et points d’API non prérendus. Ils demandent un adaptateur serveur, et Lobsite ne sert que des fichiers. Pour un formulaire de contact, faites-le pointer vers /_lobsite/forms/contact plutôt que vers une Astro Action ; voir formulaires.
Les fichiers sont stockés selon leur hash. Redéployer un site inchangé envoie 0 octet.
Prévisualisez avant la mise en ligne. Revenez en arrière en un clic, redirections comprises.
Chaque site reçoit une adresse *.lobsite.app en HTTPS dès le premier déploiement.
Faites pointer un formulaire vers /_lobsite/forms/contact. Filtrage du spam inclus.
Redirections, en-têtes et formulaires vivent dans lobsite.toml et accompagnent chaque déploiement.
Un déploiement sans compte reste en ligne 6 heures. Le lien de récupération le conserve, gratuitement.
Hébergeurs Astro comparés
| Lobsite | Netlify | Vercel | GitHub Pages | |
|---|---|---|---|---|
| Sites Astro statiques | Oui | Oui | Oui | Oui, avec la GitHub Action d’Astro |
| Rendu serveur (adaptateur) | Non | Oui | Oui | Non |
| Build sur le serveur | Non : vous déployez dist/ |
Oui | Oui | Dans GitHub Actions |
| Compte avant le premier déploiement | Non : en ligne 6 heures, puis à garder gratuitement | Oui | Oui | Oui, et un dépôt |
| Formulaires sans backend | Oui, une fois le site dans un compte | Oui | Non | Non |
| Domaine personnalisé | Oui, gratuit | Oui | Oui | Oui |
Si des parties de votre site sont rendues à la requête, choisissez un hébergeur avec un adaptateur Astro. Si le site est statique, ce qui est le défaut d’Astro, Lobsite le déploie en quelques secondes depuis votre machine, votre CI ou un agent IA, en n’envoyant que les fichiers modifiés par le build.
Questions fréquentes
Ai-je besoin d’un adaptateur pour héberger Astro sur Lobsite ?
Non. Les adaptateurs servent au rendu serveur. Un site Astro statique, le cas par défaut, n’a pas besoin d’adaptateur : déployez le dossier dist/.
Pourquoi npx lobsite déploie-t-il dist/ et pas public/ ?
Dans un projet Astro, public/ contient des fichiers que le build copie tels quels, comme favicon.svg. Le site buildé, c’est dist/. Lobsite repère astro dans package.json et ignore public/ pour vous.
Puis-je ajouter une page 404 personnalisée à mon site Astro ?
Oui. Créez src/pages/404.astro ; Astro le builde en 404.html, et Lobsite le sert avec un statut 404 pour toute adresse inexistante.
L’optimisation d’images d’Astro fonctionne-t-elle ?
Oui. astro:assets redimensionne et convertit les images pendant astro build, donc les fichiers optimisés sont déjà dans dist/ au déploiement. Seuls les services d’images qui s’exécutent à chaque requête demandent un serveur.