Inspecter, exécuter et auto-héberger

Éditeur de bâtiment 3D open source avec démo en direct et setup local

Commencez par la démo en direct, puis inspectez le dépôt et lancez l’app Next.js localement avec Bun si vous voulez un éditeur de bâtiment 3D open source auto-hébergeable.

Essayez l’éditeur de bâtiment 3D open source avant de toucher à l’infrastructure

Ouvrez d’abord l’éditeur en direct pour confirmer que cet éditeur de bâtiment 3D open source correspond à votre flux, puis passez à l’inspection du dépôt seulement si vous voulez le personnaliser ou l’auto-héberger.

Cette séquence vous permet de juger l’expérience d’édition avant de consacrer plus de temps au setup local ou au déploiement.

Démarrez localement avec le chemin Bun déjà documenté

Le dépôt documente déjà une configuration locale basée sur Bun, afin que les ingénieurs puissent installer les dépendances, lancer l’app Next.js et ouvrir l’éditeur sans deviner la structure du projet.

Vous avez ainsi un chemin direct entre l’essai de la démo en direct et l’exécution par vos propres moyens, sans devoir deviner comment le déploiement est câblé.

  • installer les dépendances avec bun
  • lancer l’app Next.js locale et visiter http://localhost:3000/editor
  • déployer la démo publique avec un flux Vercel standard

Comprendre le périmètre et les limites avant de s’engager

Aujourd’hui, l’éditeur couvre les premières tâches pratiques de bâtiment et d’intérieur : murs, toitures, dalles, plafonds, portes, fenêtres, niveaux, zones, placement d’objets, sauvegarde locale, annuler/rétablir et import/export JSON.

Il est tout aussi important de dire ce qui n’existe pas encore : pas de comptes, pas de synchronisation cloud et seulement une persistance locale navigateur. La meilleure expérience vient des navigateurs compatibles WebGPU, mais l’éditeur peut aussi basculer en mode de compatibilité WebGL avec effets réduits.

Sachez quoi configurer avant de déployer

Le README rend le déploiement concret. Définissez NEXT_PUBLIC_SITE_URL pour que les métadonnées canoniques, robots et sitemap pointent vers le bon domaine de production, puis déployez l’app Next.js via un flux Vercel standard.

Si vous voulez déplacer les assets publics lourds hors de l’hôte applicatif, utilisez NEXT_PUBLIC_ASSETS_CDN_URL pour un domaine d’assets adossé à R2. L’auto-hébergement devient ainsi plus actionnable qu’une simple promesse de cloner le dépôt.

Utilisez ce projet si vous voulez un éditeur navigateur inspectable et auto-hébergeable

Il convient aux équipes qui veulent essayer un éditeur de bâtiment 3D dans le navigateur via la démo publique, puis le faire tourner dans leur propre environnement.

Il n’est pas conçu pour la livraison BIM aval ni pour une collaboration cloud très riche. Cette limite explicite aide à décider vite si le flux correspond à vos besoins.

Exécutez le projet localement avant de l’auto-héberger

Utilisez ces notes de configuration pour voir comment le dépôt se comporte sur votre machine avant d’investir plus de temps dans l’auto-hébergement ou la personnalisation.

Quickstart
bun install
bun run dev
# puis visitez http://localhost:3000/editor et vérifiez si le navigateur utilise WebGPU ou le mode de compatibilité WebGL

Périmètre actuel

Démo publique gratuite, pas de comptes, pas de synchronisation cloud, persistance locale uniquement et mode de compatibilité WebGL lorsque WebGPU est indisponible.

Idéal pour

Les personnes qui veulent essayer maintenant un éditeur de bâtiment 3D navigateur tout en gardant l’option de l’exécuter elles-mêmes ensuite.

Pas adapté à

La livraison BIM en production, la collaboration cloud ou les équipes qui exigent que chaque ancien navigateur corresponde à l’expérience WebGPU complète.

Questions fréquentes

Puis-je exécuter cet éditeur de bâtiment 3D open source en local ?

Oui. Le dépôt public de la démo documente une configuration locale basée sur Bun, afin d’installer les dépendances, de lancer l’app Next.js et d’ouvrir l’éditeur localement sans devoir deviner la structure du projet.

Quel chemin de déploiement utilise la démo publique ?

La démo publique utilise un déploiement Next.js standard hébergé sur Vercel. Le dépôt documente aussi des variables comme NEXT_PUBLIC_SITE_URL et un CDN d’assets optionnel adossé à R2 lorsque vous voulez décharger les éléments publics lourds de l’hôte applicatif.

Que faut-il configurer avant un déploiement en production ?

Définissez NEXT_PUBLIC_SITE_URL pour que les métadonnées canoniques, robots et sitemap pointent vers le bon domaine de production. Pour placer les assets publics lourds hors de l’hôte, utilisez NEXT_PUBLIC_ASSETS_CDN_URL avec un domaine d’assets basé sur R2.

Le projet inclut-il comptes, synchronisation cloud ou collaboration aujourd’hui ?

Non. Le périmètre reste volontairement léger : pas de système de comptes, pas de synchronisation cloud et seulement une persistance locale dans le navigateur. Les équipes qui ont besoin de collaboration multi-utilisateur devront l’ajouter séparément.

Quels navigateurs fonctionnent le mieux avec l’éditeur en direct ?

L’éditeur en direct fonctionne le mieux dans les navigateurs et appareils compatibles WebGPU. Quand WebGPU n’est pas disponible, l’éditeur bascule vers un mode de compatibilité WebGL avec des effets visuels réduits, afin de pouvoir inspecter le flux dans davantage d’environnements.

Est-ce un remplacement complet de CAD ou BIM ?

Non. Le projet actuel convient surtout aux premières études d’agencement et à l’édition de bâtiment dans le navigateur. Ce n’est pas une plateforme BIM aval, un système de documentation ou une suite de collaboration cloud.

Inspecter, exécuter et auto-héberger

Essayez l’éditeur en direct, puis inspectez le dépôt

Ouvrez la démo publique pour vérifier le flux, puis consultez le setup local et le chemin de déploiement si vous avez besoin d’un éditeur de bâtiment 3D open source comme point de départ navigateur pour un travail auto-hébergé.