Docs

Quick start

In a built project, run one command. No account needed: the site lasts 6 hours unless you log in and claim it.

~/my-site $ npx lobsite

The folder is the argument, dir in lobsite.toml, or the first of dist/, build/, out/, _site/, public/. Only files that changed upload.

Drag and drop

Sign in and drop a folder or a zip anywhere on the dashboard. The same checks run before anything uploads; secret files are always left out.

lobsite.toml

site = "quiet-fox-4821"
dir  = "dist"

[[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"

Unknown keys are an error, with the closest valid key suggested. The config travels with each deploy, so a rollback restores it.

Forms

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

Forms are found at deploy time. Spam protection (a honeypot, timing and rate limits) is added for you. Submissions land in your inbox and email.

Custom domains

lobsite domain add www.example.com prints the record to add: a CNAME to cname.lobsite.app. Certificates are issued and renewed for you. If another account has also added the domain, a TXT record proves it's yours.

Previews and rollback

Every deploy has its own URL, <id>--<site>.lobsite.app. lobsite deploy --preview leaves production alone; lobsite rollback and lobsite promote switch the live deploy without uploading.

CLI

Limits

Bandwidth is per month per account (per site lifetime for anonymous sites).