Dokumentasjon

Hurtigstart

I et bygd prosjekt kjører du én kommando. Ingen konto trengs: nettstedet varer i 6 timer med mindre du logger inn og krever det.

npx lobsite

Mappen er argumentet, dir i lobsite.toml, eller den første som finnes av dist/, build/, out/, _site/, public/. Bare endrede filer lastes opp.

KI-agenter

Kodeagenter (Claude Code, Cursor, Codex og andre) deployer med den samme kommandoen. Under en agent stiller CLI-en aldri spørsmål, og utdataene slutter med en «Tell the user:»-linje med URL-en og, for et nettsted uten konto, krav-lenken som beholder det.

npx -y lobsite --yes

Det finnes også en MCP-server for kodeagenter, en ekstern for ChatGPT og Claude.ai, og en curl-kommando for sandkasser uten Node. Sett opp agenten din.

Dra og slipp

Logg inn og slipp en mappe eller en zip hvor som helst i dashbordet. De samme kontrollene kjøres før noe lastes opp; hemmelige filer utelates alltid.

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"

Ukjente nøkler er en feil, med forslag til den nærmeste gyldige nøkkelen. Konfigurasjonen følger med hver deploy, så en tilbakerulling gjenoppretter den.

Single-page-apper

Apper med ruting på klientsiden, som React Router, Vue Router eller TanStack Router, har én index.html og tegner hver side i nettleseren. Å åpne /dashboard/settings direkte, eller laste den på nytt, ber serveren om en fil som ikke finnes. Single-page-modus svarer på disse stiene med index.html, og appens ruter tar over. Det finnes tre måter å slå den på:

• spa = true i lobsite.toml. Den følger med hver deploy, så en tilbakerulling gjenoppretter den. Krever lobsite 0.1.8 eller nyere; eldre versjoner stopper med «Unknown key».
• Single-page-app i nettstedets innstillinger i dashbordet. Det er måten for nettsteder du drar og slipper, siden en sluppet mappe ikke sender lobsite.toml. Det er en innstilling for nettstedet, så den forblir som den er gjennom deployer og tilbakerullinger.
• En 200.html øverst i nettstedet. Den leveres i stedet for index.html og fungerer med alle CLI-versjoner og med dra og slipp. Det er slik Surge gjør det.

Med Vite (React, Vue, Svelte eller Solid) legger du til innstillingen og deployer dist/ som vanlig:

npm run build
npx lobsite

Bare sideforespørsler får appen: en sti der siste del ikke har filendelse (/dashboard, /users/42), eller enhver forespørsel fra en nettleser som ber om HTML (/users/jane.doe). En manglende fil som /assets/index-3f9a.js får en ekte 404. Det betyr noe rett etter en deploy: en besøkende som fortsatt har den gamle versjonen åpen, får en tydelig feil for det gamle skriptet, ikke HTML-en din i stedet.

Kommer du fra Netlify, tilsvarer _redirects-regelen /* /index.html 200 spa = true; fra Vercel er en rewrite av /(.*) til /index.html det samme.

.lobsiteignore

Filer som treffer et mønster i .lobsiteignore, deployes ikke. Syntaksen er den samme som for .gitignore:

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

Filen leses fra mappen som deployes og fra prosjektroten (ved siden av lobsite.toml); mønstre i rotfilen er relative til roten. .git, node_modules, .DS_Store og selve .lobsiteignore utelates alltid.

Hemmelige filer (.env*, private nøkler som *.pem og id_rsa, .npmrc, .netrc og lignende) stopper en deploy til de er fjernet eller ignorert. I en terminal tilbyr CLI-en å legge dem til i .lobsiteignore og deploye uten dem.

Skjemaer

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

Skjemaer oppdages ved deploy. Spambeskyttelse (et honeypot-felt, tidskontroll og frekvensgrenser) legges til for deg. Innsendinger havner på siden Innsendinger i dashbordet og i e-posten din. Mer om skjemaer: eksempler, sending med JavaScript, rammeverk og innstillinger.

På gratisplanen kjører skjemaer i begrenset modus: en månedlig kvote per nettsted, varsler bare til kontoens e-postadresse og ingen webhooker. Standard-planen legger til webhooker, enhver bekreftet varslingsadresse og en høyere kvote.

Egne domener

Egne domener følger med alle kontoer, også gratisplanen. lobsite domain add www.example.com skriver ut posten du skal legge til: en CNAME til cname.lobsite.app. Sertifikater utstedes og fornyes for deg. Hvis en annen konto også har lagt til domenet, beviser en TXT-post at det er ditt.

Forhåndsvisninger og tilbakerulling

Hver deploy har sin egen URL, <id>--<site>.lobsite.app. lobsite deploy --preview lar produksjonen være i fred; lobsite rollback og lobsite promote bytter live-deployen uten å laste opp noe.

CLI

Grenser

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.