Skip to main content

Vue d’ensemble

Kit’Asso utilise Nhost Storage pour gérer les fichiers statiques (logos d’outils, assets du site). Nhost Storage offre un service de fichiers intégré avec CDN, permissions par rôle et URLs publiques. Avantages :
  • Intégré au backend Nhost (pas de service externe)
  • Permissions automatiques via les rôles Hasura
  • URLs publiques permanentes
  • Validation de type et taille de fichiers

Configuration

URL de base

L’URL de stockage est construite à partir du subdomain et de la région Nhost :

Fichier : src/lib/storage.ts

Ce fichier centralise toutes les opérations de stockage :

Upload de fichiers

Fonction d’upload

Utilisation dans l’admin


Récupération de fichiers

Affichage dans un composant

Composant avec fallback


Permissions Storage

Les permissions de Nhost Storage sont gérées via la console Nhost :
  • Upload : uniquement les utilisateurs authentifiés (admin)
  • Lecture : publique (les URLs de fichiers sont accessibles à tous)
  • Suppression : uniquement les utilisateurs authentifiés

Bonnes pratiques

✅ À faire

  • Valider les fichiers avant upload (type + taille)
  • Utiliser des IDs uniques (générés par Nhost) plutôt que des noms de fichiers
  • Nettoyer les fichiers orphelins (logos non référencés dans la DB)
  • Gérer les erreurs d’upload gracieusement (ne pas bloquer l’utilisateur)

❌ À éviter

  • Ne pas stocker de fichiers sensibles (les URLs sont publiques)
  • Ne pas uploader sans validation côté client
  • Ne pas oublier de mettre à jour la DB quand un logo change

Ressources

Database Schema

Table site_assets pour références centralisées

Admin Dashboard

Interface d’upload dans le panel Tools

Nhost & GraphQL

Architecture backend

Nhost Storage Docs

Documentation officielle