Dokümanlar

Hızlı başlangıç

Derlenmiş bir projede tek bir komut çalıştırın. Hesap gerekmez: siz giriş yapıp sahiplenmezseniz site 6 saat yaşar.

npx lobsite

Klasör, komutun argümanı, lobsite.toml içindeki dir ya da dist/, build/, out/, _site/, public/ klasörlerinden var olan ilkidir. Yalnızca değişen dosyalar yüklenir.

Yapay zekâ ajanları

Kodlama ajanları (Claude Code, Cursor, Codex ve diğerleri) aynı komutla deploy eder. Bir ajan altında CLI asla soru sormaz ve çıktısı URL'yi ve hesapsız bir site için onu koruyan sahiplenme bağlantısını içeren bir "Tell the user:" satırıyla biter.

npx -y lobsite --yes

Ayrıca kodlama ajanları için bir MCP sunucusu, ChatGPT ve Claude.ai için uzak bir sunucu ve Node olmayan sanal alanlar için bir curl komutu vardır. Ajanınızı kurun.

Sürükle-bırak

Giriş yapın ve bir klasörü ya da zip'i panelin herhangi bir yerine bırakın. Bir şey yüklenmeden önce aynı kontroller çalışır; gizli dosyalar her zaman dışarıda kalır.

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"

Bilinmeyen anahtarlar hatadır; en yakın geçerli anahtar önerilir. Yapılandırma her deploy ile birlikte gider, böylece bir geri alma onu da geri getirir.

Tek sayfalı uygulamalar

React Router, Vue Router veya TanStack Router gibi istemci tarafı yönlendirme kullanan uygulamaların tek bir index.html dosyası vardır ve her sayfayı tarayıcıda çizerler. /dashboard/settings adresini doğrudan açmak ya da yenilemek, sunucudan var olmayan bir dosya ister. Tek sayfa modu bu yolları index.html dosyanızla yanıtlar ve uygulamanın yönlendiricisi devreye girer. Açmanın üç yolu vardır:

• lobsite.toml içinde spa = true. Her deploy ile birlikte gider, böylece bir geri alma onu geri getirir. lobsite 0.1.8 veya daha yenisini gerektirir; eski sürümler "Unknown key" hatasıyla durur.
• Paneldeki sitenin ayarlarında Tek sayfalı uygulama. Sürükle-bırakla yüklediğiniz siteler için yol budur, çünkü bırakılan bir klasör lobsite.toml göndermez. Bir site ayarıdır; deploy'lar ve geri almalar boyunca olduğu gibi kalır.
• Sitenin en üstünde bir 200.html. index.html yerine sunulur ve her CLI sürümüyle ve sürükle-bırakla çalışır. Surge böyle yapar.

Vite ile (React, Vue, Svelte veya Solid) ayarı ekleyin ve dist/ klasörünü her zamanki gibi deploy edin:

npm run build
npx lobsite

Uygulamayı yalnızca sayfa istekleri alır: son bölümünde uzantı olmayan bir yol (/dashboard, /users/42) ya da HTML isteyen bir tarayıcıdan gelen herhangi bir istek (/users/jane.doe). /assets/index-3f9a.js gibi eksik bir dosya gerçek bir 404 alır. Bu, bir deploy'dan hemen sonra önemlidir: eski sürümü hâlâ açık olan bir ziyaretçi, eski betik için yerine HTML'inizi değil, net bir hata alır.

Netlify'dan geliyorsanız, _redirects kuralı /* /index.html 200, spa = true ile aynıdır; Vercel'den geliyorsanız /(.*) yolunun /index.html adresine rewrite edilmesi de aynıdır.

.lobsiteignore

.lobsiteignore içindeki bir kalıpla eşleşen dosyalar deploy edilmez. Sözdizimi .gitignore ile aynıdır:

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

Dosya, deploy edilen klasörden ve proje kökünden (lobsite.toml dosyasının yanından) okunur; kökteki dosyadaki kalıplar köke göredir. .git, node_modules, .DS_Store ve .lobsiteignore dosyasının kendisi her zaman dışarıda kalır.

Gizli dosyalar (.env*, *.pem ve id_rsa gibi özel anahtarlar, .npmrc, .netrc ve benzerleri) kaldırılana veya yok sayılana kadar bir deploy'u durdurur. Bir terminalde CLI, onları .lobsiteignore dosyasına eklemeyi ve onlarsız deploy etmeyi önerir.

Formlar

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

Formlar deploy sırasında bulunur. Spam koruması (bir tuzak alanı, zamanlama ve hız sınırları) sizin için eklenir. Gönderimler panelinizdeki Gönderimler sayfasına ve e-postanıza düşer. Formlar hakkında daha fazlası: örnekler, JavaScript ile gönderme, framework'ler ve ayarlar.

Ücretsiz planda formlar sınırlı modda çalışır: site başına aylık bir kota, yalnızca hesap e-postanıza bildirim ve webhook yok. Standard planı webhook'ları, doğrulanmış herhangi bir bildirim adresini ve daha yüksek bir kotayı ekler.

Özel alan adları

Özel alan adları, ücretsiz plan dahil her hesapla gelir. lobsite domain add www.example.com eklenecek kaydı yazdırır: cname.lobsite.app adresine bir CNAME. Sertifikalar sizin için verilir ve yenilenir. Başka bir hesap da alan adını eklediyse, bir TXT kaydı onun size ait olduğunu kanıtlar.

Önizlemeler ve geri alma

Her deploy'un kendi URL'si vardır: <id>--<site>.lobsite.app. lobsite deploy --preview üretime dokunmaz; lobsite rollback ve lobsite promote hiçbir şey yüklemeden yayındaki deploy'u değiştirir.

CLI

Sınırlar

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.