Dokumentasi

Mulai cepat

Di proyek hasil build, jalankan satu perintah. Tidak perlu akun: situs bertahan 6 jam kecuali Anda login dan mengklaimnya.

npx lobsite

Foldernya adalah argumen, dir di lobsite.toml, atau yang pertama dari dist/, build/, out/, _site/, public/. Hanya file yang berubah yang diunggah.

Agen AI

Agen coding (Claude Code, Cursor, Codex, dan lainnya) melakukan deploy dengan perintah yang sama. Di bawah agen, CLI tidak pernah bertanya, dan keluarannya diakhiri baris "Tell the user:" dengan URL dan, untuk situs tanpa akun, tautan klaim untuk menyimpannya.

npx -y lobsite --yes

Ada juga server MCP untuk agen coding, server jarak jauh untuk ChatGPT dan Claude.ai, dan perintah curl untuk sandbox tanpa Node. Siapkan agen Anda.

Seret dan lepas

Masuk dan letakkan folder atau zip di mana saja di dasbor. Pemeriksaan yang sama berjalan sebelum apa pun diunggah; file rahasia selalu dikecualikan.

lobsite.toml

site = "quiet-fox-4821"
dir  = "dist"
spa  = false            # true: paths that aren't files open index.html

[[redirects]]
from   = "/blog/:slug"
to     = "/posts/:slug"
status = 301            # 301 | 302 | 307 | 308

[[headers]]
for = "/assets/*"
[headers.values]
Cache-Control = "public, max-age=31536000, immutable"

[forms.contact]
required = ["email", "message"]
redirect = "/thanks"

Kunci yang tidak dikenal adalah error, dengan saran kunci valid terdekat. Konfigurasi ikut bersama setiap deploy, sehingga rollback memulihkannya.

Aplikasi satu halaman

Aplikasi dengan routing sisi klien, seperti React Router, Vue Router, atau TanStack Router, memiliki satu index.html dan menggambar setiap halaman di browser. Membuka /dashboard/settings langsung, atau memuat ulang, meminta file yang tidak ada kepada server. Mode satu halaman menjawab path itu dengan index.html Anda, sehingga router aplikasi mengambil alih. Ada tiga cara mengaktifkannya:

• spa = true di lobsite.toml. Ikut bersama setiap deploy, sehingga rollback memulihkannya. Memerlukan lobsite 0.1.8 atau lebih baru; versi lama berhenti dengan "Unknown key".
• Aplikasi satu halaman di pengaturan situs di dasbor. Ini cara untuk situs yang Anda seret dan lepas, karena folder yang diletakkan tidak mengirim lobsite.toml. Ini pengaturan situs, jadi tetap sama selama deploy dan rollback.
• 200.html di tingkat atas situs. Disajikan menggantikan index.html, dan berfungsi dengan versi CLI apa pun serta seret-lepas. Beginilah cara Surge melakukannya.

Dengan Vite (React, Vue, Svelte, atau Solid), tambahkan pengaturan dan deploy dist/ seperti biasa:

npm run build
npx lobsite

Hanya permintaan halaman yang mendapat aplikasi: path yang bagian terakhirnya tanpa ekstensi (/dashboard, /users/42), atau permintaan apa pun dari browser yang meminta HTML (/users/jane.doe). File yang hilang seperti /assets/index-3f9a.js mendapat 404 sungguhan. Itu penting tepat setelah deploy: pengunjung yang masih membuka versi lama mendapat error yang jelas untuk skrip lama, bukan HTML Anda menggantikannya.

Dari Netlify, aturan _redirects /* /index.html 200 adalah spa = true; dari Vercel, rewrite /(.*) ke /index.html adalah hal yang sama.

.lobsiteignore

File yang cocok dengan pola di .lobsiteignore tidak di-deploy. Sintaksnya sama dengan .gitignore:

drafts/
*.psd
/notes.txt
!keep.psd

File dibaca dari folder yang di-deploy dan dari root proyek (di samping lobsite.toml); pola di file root relatif terhadap root. .git, node_modules, .DS_Store, dan .lobsiteignore sendiri selalu dikecualikan.

File rahasia (.env*, kunci privat seperti *.pem dan id_rsa, .npmrc, .netrc, dan sejenisnya) menghentikan deploy sampai dihapus atau diabaikan. Di terminal, CLI menawarkan untuk menambahkannya ke .lobsiteignore dan melakukan deploy tanpanya.

Formulir

<form action="/_lobsite/forms/contact" method="POST">
  <input name="email" type="email" required>
  <textarea name="message" required></textarea>
  <button>Send</button>
</form>

Formulir ditemukan saat deploy. Perlindungan spam (honeypot, waktu, dan batas laju) ditambahkan untuk Anda. Kiriman masuk ke halaman Kiriman di dasbor dan ke email Anda. Selengkapnya tentang formulir: contoh, mengirim dengan JavaScript, framework, dan pengaturan.

Pada paket gratis, formulir berjalan dalam mode terbatas: kuota bulanan per situs, notifikasi hanya ke email akun Anda, dan tanpa webhook. Paket Standard menambahkan webhook, alamat notifikasi terverifikasi apa pun, dan kuota lebih tinggi.

Domain kustom

Domain kustom tersedia di setiap akun, termasuk paket gratis. lobsite domain add www.example.com mencetak data yang harus ditambahkan: CNAME ke cname.lobsite.app. Sertifikat diterbitkan dan diperpanjang untuk Anda. Jika akun lain juga menambahkan domain, data TXT membuktikan bahwa domain itu milik Anda.

Pratinjau dan rollback

Setiap deploy memiliki URL sendiri, <id>--<site>.lobsite.app. lobsite deploy --preview membiarkan produksi; lobsite rollback dan lobsite promote mengganti deploy aktif tanpa mengunggah.

CLI

Batas

Bandwidth is per month per account (per site lifetime for anonymous sites). At the limit, free and anonymous sites stop serving until the next month; on Standard there's no cap and sites keep serving: past 1 TB a month, we contact you.