Tentang
sitelo tidak dimulai sebagai framework. Ia dimulai dari keinginan untuk menulis markup dengan cara yang terasa wajar di JavaScript — dan terus tumbuh sampai seluruh jalur dari berkas halaman ke situs yang terbit tercakup.
javascript-to-html
Mula-mula datang javascript-to-html (dikenal juga sebagai ht.js): cara sederhana dan intuitif untuk menghasilkan HTML di JavaScript, tanpa mesin templat atau framework yang rumit.
Mengingat betapa lazimnya framework serba lengkap seperti React, menemukan solusi templat sederhana yang tidak membawa serta segalanya ternyata sulit. Dengan hanya berfokus pada mengubah JavaScript menjadi HTML — pada dasarnya fungsi yang mengembalikan string — ht.js tetap ringan, mudah dipakai, luwes, dan dapat diperluas.
Permukaan yang kecil itu membuatnya cocok di banyak tempat: langsung di frontend (gaya SPA), dalam proses build untuk membuat situs statis (SSG), atau bahkan untuk perenderan sisi server (SSR).
Mengajari Vite menghasilkan HTML
Itu menyelesaikan soal penulisan. Masalah berikutnya adalah build: Vite memperlakukan .js / .ts sebagai skrip, bukan halaman. Saya butuh konvensi yang menandai modul tertentu memang dimaksudkan menjadi HTML.
Gagasannya lugas: berkas bernama *.ht.js, *.html.js, *.ht.ts, dan sejenisnya harus diproses menjadi HTML alih-alih dibundel sebagai JavaScript klien. Konvensi itu menjadi vite-plugin-html-pages — perutean berbasis berkas, pemuatan data, aset, dan pembuatan statis di atas Vite.
sitelo
sitelo membungkus Vite dan plugin itu menjadi satu pemasangan dan satu CLI. Anda mendapat pengalaman pengembang yang utuh dan kelas satu: sitelo untuk server langsung, sitelo build untuk produksi, nilai bawaan yang masuk akal, dan model halaman milik plugin tanpa perlu merakit rantai perkakasnya sendiri.
Gagasan yang sama sampai ke bawah: halaman adalah modul yang mengembalikan HTML. sitelo adalah lapisan yang membuat gagasan itu terasa rampung.
Komponen dan island server
Fungsi yang mengembalikan HTML ternyata bisa disusun sampai ke atas. sitelo-ui adalah pustaka komponen yang dibangun dengan cara yang sama — tombol, kartu, formulir, tabel, modal, dan bagian halaman, masing-masing sebuah fungsi yang mengembalikan string. Tanpa kompiler, tanpa runtime, tanpa hidrasi: apa yang Anda bangun itulah yang masuk ke dist/.
Meski begitu, tidak setiap bagian halaman bisa statis. Island server menjaga halaman tetap statis dan hanya merender bagian yang butuh data segar per permintaan — komentar di bawah artikel yang di-cache, stok di halaman produk — di server saat halaman dibuka. Sebuah island lagi-lagi hanyalah fungsi yang mengembalikan HTML: build mengirim fallback-nya, lalu loader mungil menukarnya dengan fragmen yang sudah dirender.
Keduanya tidak mengubah modelnya. Tetap tanpa framework di klien — hanya HTML dari fungsi, saat build atau saat permintaan.
Perbandingannya
Sudah banyak perkakas bagus yang menerbitkan situs statis. Ceruk sitelo sengaja sempit: fungsi JavaScript (atau TypeScript) yang mengembalikan HTML, dengan pengalaman pengembangan Vite, dan sesedikit mungkin framework.
| Perkakas | Model | Pilih saat |
|---|---|---|
| sitelo | Fungsi JS/TS → HTML di atas Vite, plus komponen dan island server | Anda ingin HTML dari JavaScript dengan alur kerja Vite sungguhan — komponen dan bagian per permintaan sudah termasuk, tanpa framework klien atau hidrasi |
| Astro | Komponen framework + island klien dan server, kompiler sendiri | Anda ingin menghidrasi komponen React, Vue, atau Svelte di peramban, dengan ekosistem lebih besar |
| Next.js | Aplikasi React penuh (SSR / SSG / ISR) | Anda membangun aplikasi di ekosistem React |
| Hugo | Templat Go, build sangat cepat | Situs konten raksasa dan Anda nyaman dengan rantai perkakas Go |
| Eleventy | Bahasa templat → HTML | Anda ingin templat yang luwes (Nunjucks, Liquid, …) tanpa framework SPA |
Jika Anda ingin komponen di sisi klien dan hidrasi — pakailah framework. Jika Anda ingin HTML dari fungsi JavaScript dengan pengalaman Vite — komponen dan bagian yang dirender di server sudah termasuk — sitelo adalah perkakas terkecil yang menuntaskan seluruh pekerjaannya.