Inspeksi, jalankan, dan self-host

Editor Bangunan 3D Open Source Dengan Demo Live dan Setup Lokal

Mulai dari demo live, lalu inspeksi repo dan boot app Next.js secara lokal dengan Bun jika Anda menginginkan editor bangunan 3D open source yang bisa self-host.

Coba Editor Bangunan 3D Open Source Sebelum Menyentuh Infrastruktur

Buka editor live terlebih dahulu untuk memastikan editor bangunan 3D open source ini cocok dengan alur kerja Anda, lalu lanjutkan ke inspeksi repo hanya jika Anda ingin menyesuaikan atau self-host.

Urutan ini membantu Anda menilai pengalaman pengeditan sebelum menghabiskan lebih banyak waktu untuk setup lokal atau deployment.

Mulai Secara Lokal Dengan Jalur Setup Bun Yang Sudah Didokumentasikan

Repositori sudah mendokumentasikan setup lokal berbasis Bun, sehingga engineer dapat memasang dependensi, menjalankan app Next.js, dan membuka editor live tanpa menebak struktur proyek terlebih dahulu.

Ini memberi Anda jalur langsung dari mencoba demo live ke menjalankannya sendiri, tanpa harus menebak bagaimana deployment disusun.

  • pasang dependensi dengan bun
  • jalankan app Next.js lokal dan kunjungi http://localhost:3000/editor
  • deploy demo publik melalui alur Vercel standar

Pahami Cakupan dan Batasan Sebelum Berkomitmen

Hari ini editor mencakup tugas pengeditan bangunan dan interior tahap awal seperti dinding, atap, slab, plafon, pintu, jendela, level, zona, penempatan item, autosave lokal, undo dan redo, serta impor atau ekspor JSON.

Sama pentingnya untuk menyebutkan apa yang belum ada: tidak ada sistem akun, tidak ada cloud sync, dan hanya persistensi browser lokal. Pengalaman terbaik berasal dari browser berkemampuan WebGPU, tetapi editor saat ini juga fallback ke mode kompatibilitas WebGL dengan efek yang lebih terbatas saat diperlukan.

Ketahui Yang Perlu Dikonfigurasi Sebelum Deployment

README membuat deployment tetap konkret. Atur NEXT_PUBLIC_SITE_URL agar metadata canonical, robots, dan entri sitemap mengarah ke domain produksi yang tepat, lalu deploy app Next.js melalui alur Vercel standar.

Jika Anda ingin memindahkan item publik berat dari host app, gunakan NEXT_PUBLIC_ASSETS_CDN_URL opsional untuk domain aset berbasis R2. Ini membuat cerita self-hosting lebih dapat dijalankan daripada sekadar janji samar untuk clone repo suatu hari nanti.

Gunakan Proyek Ini Saat Anda Membutuhkan Editor Berbasis Browser Yang Bisa Diinspeksi dan Self-Host

Ini cocok untuk tim yang menginginkan editor bangunan 3D berbasis browser yang dapat dicoba di demo publik dan kemudian dijalankan di lingkungan mereka sendiri.

Ini tidak dibangun untuk delivery BIM hilir atau kolaborasi cloud yang sangat kaya fitur. Menyatakan batasan itu secara eksplisit membantu Anda cepat memutuskan apakah alur kerja ini sesuai kebutuhan.

Jalankan proyek secara lokal sebelum Anda self-host

Gunakan catatan setup di bawah ini untuk melihat bagaimana repo berjalan di mesin Anda sebelum menghabiskan lebih banyak waktu untuk self-hosting atau kustomisasi.

Quickstart
bun install
bun run dev
# lalu kunjungi http://localhost:3000/editor dan periksa apakah browser memakai WebGPU atau mode kompatibilitas WebGL

Cakupan saat ini

Demo publik gratis, tidak ada sistem akun, tidak ada cloud sync, hanya persistensi browser lokal, dan mode kompatibilitas WebGL saat WebGPU tidak tersedia.

Paling cocok untuk

Orang yang ingin mencoba editor bangunan 3D berbasis browser sekarang dan tetap memiliki opsi untuk menjalankannya sendiri nanti.

Bukan untuk

Delivery BIM produksi, kolaborasi cloud, atau tim yang membutuhkan setiap browser lama menyamai pengalaman WebGPU penuh.

Pertanyaan umum

Bisakah saya menjalankan editor bangunan 3D open source ini secara lokal?

Ya. Repositori demo publik mendokumentasikan setup lokal berbasis Bun, sehingga Anda dapat memasang dependensi, menjalankan app Next.js, dan membuka editor live secara lokal tanpa menebak struktur workspace terlebih dahulu.

Jalur deployment apa yang digunakan demo publik?

Demo publik menggunakan deployment Next.js standar yang di-host di Vercel. Repo juga mendokumentasikan variabel lingkungan seperti NEXT_PUBLIC_SITE_URL dan opsi CDN aset berbasis R2 jika Anda ingin memindahkan item publik berukuran besar dari host app.

Apa yang perlu dikonfigurasi sebelum deployment produksi?

Atur NEXT_PUBLIC_SITE_URL agar metadata canonical, robots, dan output sitemap mengarah ke domain produksi yang benar. Jika item publik berat ingin dipisahkan dari host app, gunakan NEXT_PUBLIC_ASSETS_CDN_URL opsional untuk domain aset berbasis R2.

Apakah proyek ini sudah mencakup akun, cloud sync, atau kolaborasi?

Tidak. Cakupannya sengaja lebih ringan: tidak ada sistem akun, tidak ada cloud sync, dan hanya persistensi browser lokal. Tim yang membutuhkan kolaborasi multi-user perlu menambahkan kemampuan itu secara terpisah.

Browser apa yang paling cocok untuk editor live?

Editor live bekerja paling baik di browser dan perangkat dengan dukungan WebGPU. Saat WebGPU tidak tersedia, editor fallback ke mode kompatibilitas WebGL dengan efek visual yang lebih terbatas, sehingga alur kerja tetap bisa diperiksa di lebih banyak lingkungan.

Apakah ini pengganti CAD atau BIM penuh?

Tidak. Proyek saat ini paling cocok untuk pekerjaan layout awal dan pengeditan bangunan berbasis browser. Ini bukan platform BIM hilir, sistem dokumentasi, atau suite kolaborasi cloud penuh.

Inspeksi, jalankan, dan self-host

Coba editor live, lalu inspeksi repo

Buka demo publik untuk memverifikasi alur kerja, lalu tinjau setup lokal dan jalur deployment jika Anda membutuhkan editor bangunan 3D open source sebagai titik awal berbasis browser untuk pekerjaan self-hosted.