Ispeziona, esegui e self-host

Editor 3D open source per edifici con demo live e setup locale

Inizia dalla demo live, poi ispeziona il repository e avvia localmente l’app Next.js con Bun se vuoi un editor 3D open source per edifici che puoi ospitare in autonomia.

Prova l’editor 3D open source prima di toccare l’infrastruttura

Apri prima l’editor live per confermare che questo editor 3D open source per edifici sia adatto al tuo flusso, poi passa all’ispezione del repository solo se vuoi personalizzarlo o self-hostarlo.

Questa sequenza ti permette di giudicare l’esperienza di editing prima di spendere più tempo in setup locale o deployment.

Parti in locale con il percorso Bun già documentato

Il repository documenta già una configurazione locale basata su Bun, quindi gli ingegneri possono installare le dipendenze, avviare l’app Next.js e aprire l’editor live senza dover prima interpretare da zero la struttura del progetto.

Questo offre un percorso diretto dal provare la demo live all’eseguirla in autonomia, senza costringerti a indovinare come è collegato il deployment.

  • installa le dipendenze con bun
  • avvia l’app Next.js locale e visita http://localhost:3000/editor
  • distribuisci la demo pubblica con un flusso Vercel standard

Conosci scope e limiti prima di impegnarti

Oggi l’editor copre attività pratiche iniziali di modifica edilizia e d’interni come muri, tetti, solai, soffitti, porte, finestre, livelli, zone, posizionamento oggetti, salvataggio locale, annulla e ripeti, e importazione o esportazione JSON.

È altrettanto importante dire cosa non c’è ancora: nessun sistema di account, nessuna sincronizzazione cloud e solo persistenza locale nel browser. La migliore esperienza arriva da browser compatibili con WebGPU, ma l’editor attuale passa anche a una modalità WebGL con effetti ridotti quando serve.

Sapere cosa configurare prima del deployment

Il README rende concreto il deployment. Imposta NEXT_PUBLIC_SITE_URL così metadata canonici, robots e voci sitemap puntano al dominio di produzione corretto, poi distribuisci l’app Next.js con un flusso Vercel standard.

Se vuoi tenere asset pubblici pesanti fuori dall’host dell’app, usa l’opzione NEXT_PUBLIC_ASSETS_CDN_URL per un dominio asset basato su R2. Questo rende il self-hosting più operativo di una promessa vaga di clonare il repository un giorno.

Usa questo progetto quando ti serve un editor nel browser ispezionabile e self-hosted

È adatto a team che vogliono provare nella demo pubblica un editor 3D per edifici basato su browser e, più avanti, eseguirlo nel proprio ambiente.

Non è costruito per consegna BIM downstream o collaborazione cloud ricca di funzioni. Rendere esplicito questo confine ti aiuta a decidere rapidamente se il flusso corrisponde alle tue esigenze.

Esegui il progetto in locale prima del self-hosting

Usa le note di setup qui sotto per vedere come si comporta il repository sulla tua macchina prima di investire più tempo in self-hosting o personalizzazione.

Quickstart
bun install
bun run dev
# poi visita http://localhost:3000/editor e controlla se il browser usa WebGPU o la modalità WebGL compatibile

Scope attuale

Demo pubblica gratuita, nessun sistema di account, nessuna sincronizzazione cloud, solo persistenza locale nel browser e modalità WebGL compatibile quando WebGPU non è disponibile.

Ideale per

Chi vuole provare ora un editor 3D per edifici basato su browser e mantenere l’opzione di eseguirlo in autonomia più avanti.

Non adatto a

Consegna BIM di produzione, collaborazione cloud o team che hanno bisogno che ogni browser legacy replichi l’esperienza WebGPU completa.

Domande frequenti

Posso eseguire localmente questo editor 3D open source per edifici?

Sì. Il repository della demo pubblica documenta una configurazione locale basata su Bun, così puoi installare le dipendenze, avviare l’app Next.js e aprire l’editor live localmente senza dover ricostruire prima lo spazio di lavoro.

Quale percorso di deployment usa la demo pubblica?

La demo pubblica usa un deployment Next.js standard ospitato su Vercel. Il repository documenta anche variabili d’ambiente come NEXT_PUBLIC_SITE_URL e un percorso CDN opzionale basato su R2 per tenere asset pubblici pesanti fuori dall’host dell’app.

Cosa devo configurare prima di un deployment in produzione?

Imposta NEXT_PUBLIC_SITE_URL così metadata canonici, robots e sitemap puntano al dominio distribuito corretto. Se vuoi spostare asset pubblici pesanti fuori dall’host dell’app, usa l’opzione NEXT_PUBLIC_ASSETS_CDN_URL per un dominio asset basato su R2.

Il progetto include account, sincronizzazione cloud o collaborazione oggi?

No. Lo scope è volutamente più leggero: nessun sistema di account, nessuna sincronizzazione cloud e solo persistenza locale nel browser. I team che hanno bisogno di collaborazione multiutente dovranno aggiungere queste capacità separatamente.

Quali browser funzionano meglio con l’editor live?

L’editor live funziona meglio su browser e dispositivi con supporto WebGPU. Quando WebGPU non è disponibile, l’editor passa a una modalità di compatibilità WebGL con effetti visivi ridotti, così puoi comunque ispezionare il flusso in più ambienti.

È un sostituto completo di CAD o BIM?

No. Il progetto attuale è più adatto al lavoro iniziale di layout e alla modifica di edifici nel browser. Non è una piattaforma BIM completa downstream, un sistema di documentazione o una suite di collaborazione cloud.

Ispeziona, esegui e self-host

Prova l’editor live, poi ispeziona il repository

Apri la demo pubblica per verificare il flusso, poi rivedi setup locale e percorso di deployment se ti serve un editor 3D open source per edifici come base browser-based per lavoro self-hosted.