Exigences du paquet#

Votre soumission est un zip d’application web statique. Voici les règles appliquées au moment du téléversement.

Contenu du zip#

• Un fichier index.html à la racine du zip. Si le zip contient un seul dossier d’enveloppe (par exemple dist/), il est retiré pour vous.
• Uniquement des fichiers statiques : HTML, JavaScript, CSS, images, polices, JSON, WebAssembly, etc. Il n’y a pas de code côté serveur.

Limites#

Chemins refusés#

Un paquet est refusé s’il contient :

• des chemins avec .., des chemins absolus ou des barres obliques inverses dans les noms de fichiers ;
• un dossier _next, _vercel ou _dg à la racine. Ces chemins appartiennent à la plateforme sur chaque adresse : votre application ne pourrait jamais les charger (_dg héberge la connexion et la base de données). Si votre framework place ses ressources dans _next/, configurez-le pour utiliser un autre dossier, comme assets/.

Les fichiers comme __MACOSX/ et .DS_Store sont ignorés.

Choisir un sous-domaine#

Le sous-domaine est l’adresse de votre application et il est figé une fois réservé. Pour le changer, supprimez l’application et soumettez-la à nouveau.

• De 3 à 30 caractères : lettres minuscules a-z, chiffres et tirets.
• Il ne peut ni commencer ni finir par un tiret, ni contenir deux tirets de suite.
• Certains noms sont réservés, comme www, api, admin, docs et login.
• Il ne doit pas déjà être pris.

Comment vos fichiers sont servis#

• Seules les requêtes GET et HEAD reçoivent une réponse. Votre application est statique.
• Un chemin sans extension qui ne correspond à aucun fichier renvoie index.html, ce qui permet le routage côté client.
• Les fichiers d’un dossier assets/ sont mis en cache un an comme immuables. Utilisez-y des noms de fichiers hachés, ce que font par défaut les bundlers comme Vite.
• Tous les autres fichiers, y compris index.html, sw.js et le manifeste, sont revalidés à chaque chargement pour que les mises à jour parviennent à vos utilisateurs.

Votre application tourne à la racine de sa propre adresse#

Chaque application est servie à la racine de son sous-domaine, jamais depuis un sous-chemin. Définissez le chemin de base de votre build sur / (avec Vite, base: '/') et utilisez des chemins absolus comme /assets/app.js ou des chemins relatifs.