Kenali ekosistem Nex Editor. Framework. Satu alur kerja. ↗
NEX DOCUMENTATION / PANDUAN AWAL

Mulai dari pemahaman
yang tepat.

Panduan ringkas tentang NexSourceCode dan Nex MVC: perannya, bagian-bagiannya, dan cara membuat halaman pertama.

01 / KONSEP DASAR

Dua nama. Dua tanggung jawab.

NexSourceCode adalah aplikasi desktop untuk bekerja dengan source proyek Nex. Nex MVC adalah framework PHP yang memberi struktur dan API untuk aplikasi web.

Perbandingan peran produk
BagianNexSourceCodeNex MVC
PeranEditor & workspaceFramework aplikasi PHP
AnalogiSeperti VS Code pada sisi editorSeperti Laravel pada sisi framework
Yang dikelolaSheet, container, Blueprint, runtime lokalRequest, route, controller, model, view
HasilProyek yang tersusunAplikasi yang merespons pengguna

Analogi menjelaskan peran, bukan kesamaan implementasi. NexSourceCode tidak menjanjikan dukungan ekstensi VS Code. Nex MVC bukan Laravel dan tidak otomatis mendukung package Laravel.

02 / NEXSOURCECODE

Tempat Anda mengerjakan proyek.

Explorer menampilkan folder dan container. Editor menampilkan sheet kode di dalam container, sementara Blueprint menghubungkan bagian-bagiannya secara visual.

  • Client .nexcl: menampung sheet tampilan HTML/PHP serta CSS dan JavaScript.
  • Server .nexsv: menampung sheet PHP seperti controller, model, konfigurasi, dan definisi route.
  • Blueprint: hubungkan view ke asset melalui koneksi; pilih controller, action, dan view pada kartu route.
  • Terminal Nex: jalankan perintah runtime yang disediakan aplikasi.

File container disimpan terenkripsi. Sheet bukan file fisik PHP terpisah di folder proyek; runtime memetakan sheet menjadi path virtual saat dijalankan.

03 / NEX MVC

Ikuti perjalanan sebuah request.

Ketika pengunjung membuka URL, route memilih controller dan action. Controller menyiapkan data, model menangani akses data saat dibutuhkan, lalu view menghasilkan halaman HTML.

Contoh definisi route PHP
<?php
use Nex\Route;
use App\Http\Controllers\HomeController;

Route::get('/', [HomeController::class, 'index'])
    ->name('home');

// Atau hubungkan route dan view
// melalui kartu visual Blueprint.
Contoh HomeController
<?php
namespace App\Http\Controllers;

use Nex\Controller;

class HomeController extends Controller {
    public function index(): array {
        return ['title' => 'Halo dari Nex.'];
    }
}
Contoh sheet view home
<!doctype html>
<html lang="id">
  <head><title>Website pertama</title></head>
  <body>
    <h1><?= e($title) ?></h1>
    <p>Dibangun dengan Nex MVC.</p>
  </body>
</html>

<!-- Hubungkan CSS & JS melalui Blueprint. -->

Contoh di atas adalah alternatif definisi route melalui PHP. Pada proyek dengan route Blueprint, ubah kartu route yang ada dan pilih view home; jangan mendefinisikan GET / dua kali. Kartu Blueprint memasangkan data controller dengan view.

04 / MULAI MEMBANGUN

Halaman pertama Anda, langkah demi langkah.

  1. Buka NexSourceCode dan pilih folder workspace. Gunakan folder proyek yang memang ingin Anda kerjakan.
  2. Siapkan fondasi lewat Install. Baca dokumentasi bawaan dan periksa proyek yang sudah ada sebelum melakukan instalasi ulang.
  3. Buka container Client. Temukan sheet view home, lalu isi markup halaman.
  4. Tambahkan CSS dan JavaScript. Hubungkan view ke kedua sheet lewat Blueprint. Runtime menyisipkan asset; jangan menggandakannya dengan tag manual.
  5. Periksa route GET /. Pastikan kartu route mengarah ke controller/action yang tepat serta view home.
  6. Periksa dan jalankan. Masukkan perintah berikut satu per satu di terminal NexSourceCode, lalu buka URL lokal yang ditampilkan.
Periksa prasyarat
nex doctor
Jalankan pengembangan lokal
nex dev

Halaman konten sederhana dapat berjalan tanpa tabel database. Untuk halaman yang membaca atau menulis data, siapkan koneksi NexSQL terlebih dahulu.

05 / ORGANISASI SOURCE

Satu proyek, bagian yang terarah.

Contoh struktur proyek
my-project/
├── client/views/app.nexcl   # view dan asset sheet
├── server/controllers.nexsv # controller PHP
├── server/routes.nexsv      # route Blueprint / PHP
├── server/models.nexsv      # model
├── app/                    # service, policy, middleware
├── public/                 # asset publik
├── private/                # konfigurasi privat
├── database/app.nexsql      # data NexSQL
└── nexsh                    # environment terenkripsi

Struktur dapat bertambah sesuai kebutuhan. Nama sheet, role PHP, dan hubungan Blueprint menentukan bagaimana runtime mengenali source—bukan sekadar nama folder.

06 / DATA & KEAMANAN

NexSQL punya alurnya sendiri.

NexSQL adalah penyimpanan database terenkripsi yang terintegrasi dalam ekosistem Nex. Atur schema dan data melalui Database/Blueprint; model PHP dapat mengaksesnya melalui koneksi backend yang dikonfigurasi.

  • Admin database dan akun pengguna website adalah dua jenis akun yang berbeda.
  • Koneksi backend seperti main memiliki izin reader atau writer sesuai kebutuhan.
  • Isi kredensial lewat input aman aplikasi. Jangan menaruh password, token, atau kunci enkripsi di source atau percakapan AI.
  • NexSQL tidak mendukung raw SQL, SQL JOIN, atau migrasi Nex\Schema seperti backend SQL/PDO.
  • Batas file terenkripsi NexSQL saat ini 32 MB. Siapkan cadangan dan rencana pemulihan kunci.

Enkripsi container bukan DRM. Source HTML/CSS/JavaScript yang dikirim ke browser tetap terlihat. NexSQL belum diaudit keamanan secara independen; jangan menganggap enkripsi sebagai jaminan keamanan mutlak.

07 / INTEGRASI AI

Bekerja bersama AI, dengan batas yang jelas.

MCP menghubungkan klien AI dengan workspace NexSourceCode yang sedang dipilih. Aktifkan melalui File → MCP, lalu gunakan konfigurasi koneksi dari aplikasi pada klien yang mendukungnya.

  1. Mulai dengan nex_project_guide, nex_framework_guide, dan nex_workspace.
  2. Temukan container dengan nex_list_containers, lalu baca source menggunakan nex_read_container.
  3. Gunakan revisi terbaru saat memanggil nex_upsert_sheet atau nex_update_blueprint.
  4. Perubahan source memerlukan izin tulis. Menjalankan runtime memerlukan izin runtime terpisah.

Workspace berubah atau akses dicabut berarti operasi harus diperiksa ulang. Perubahan database destruktif memerlukan konfirmasi manusia di aplikasi. Password, token, dan kunci enkripsi tidak boleh menjadi input atau keluaran AI.

Website ini hanya menjelaskan MCP. Situs tidak menghubungkan pengunjung ke editor, meminta token, atau menjalankan kode mereka. Menu, tab contoh, pencarian topik, salin kode, dan FAQ berjalan di browser.

08 / DARI LOKAL KE HOSTING

Jalankan dengan runtime yang sesuai.

Gunakan nex dev untuk pengembangan, nex play untuk mode play, nex status untuk memeriksa runtime, dan nex stop untuk menghentikannya. PHP yang didukung tetap dibutuhkan untuk aplikasi PHP/MVC.

Buka tutorial hosting & cPanel →

Untuk deployment, tinjau rencana hosting lalu gunakan File → Export hosting ZIP. Target native memakai Node.js 22+ dengan app.js/npm start; source PHP/MVC tetap membutuhkan PHP-CGI yang didukung penyedia hosting. Ada target kompatibilitas PHP/Apache.

Paket native Nex bukan situs untuk hosting statis saja. Source, environment, dan kunci runtime privat harus tetap ditempatkan sesuai panduan hosting bawaan. Ekspor ZIP dan pemilihan tujuan dilakukan melalui UI aplikasi.

← Kembali ke beranda