Zlog Deployment Guide (3/3): One-Click Deploy to Vercel

The final post: publish your blog as a public website. The only prerequisite is Turso sync from part 2 (the deploy writes your sync credentials into the production environment automatically) plus a Vercel account.

Why Vercel

• Free: the Hobby plan covers a personal blog (100GB bandwidth/month, unlimited static requests).
• Fully automatic: posts, images, and comments all live in the same cloud DB — the admin and the site stay identical.
• No terminal: no Git, no shell, no manual environment variables.

Step 1: Sign Up for Vercel and Create a Token

1. Open Vercel and sign up (one-click with GitHub / Google).
2. Avatar (top-right) → Settings → Tokens → Create Token:
   • Name it anything (e.g. zlog-deploy)
   • Scope: your account
   • Click Create and copy the token immediately (shown once), it looks like vcp_...

Step 2: One-Click Deploy in the Desktop App

1. Open Zlog → Settings → Go Live panel.

2. Paste the token; project name can stay empty (auto-generated, e.g. zlog-blog-xxx) or be customized.

3. Click Deploy — the app automatically:

   plaintext

   复制代码

   validate token → create Vercel project → set environment variables
   → upload code → cloud build (2–5 min) → return the public URL

4. When done, the panel shows the public URL (e.g. https://your-project.vercel.app) — copy and share it.

After Deployment

• Writing: posts written in the desktop app or the online admin (/admin) go to the same Turso DB; they're live on the site within ~60s, no redeploy needed.
• Code updates: click Deploy again to overwrite the live version; environment variables are reused.
• Images: media is handled automatically — with a GitHub image-repo token it's served via CDN; without one, images come straight from the database. Functionality is unaffected.

Optional: Comment Spam Protection (Cloudflare Turnstile)

Comments work out of the box (guests, no login). To add human verification against spam, you need two keys from Cloudflare Turnstile:

1. Sign up for Cloudflare (free): open dash.cloudflare.com.
2. Create a Turnstile site: in the console go to Turnstile → Add site:
   • Widget name: anything (e.g. my-blog-comments)
   • Hostname: your domain — use localhost for local use, your xxx.vercel.app for the deployed site (separate multiple domains with commas). Keys only work on whitelisted domains — a missing domain errors with 110200 "domain is not allowed"
3. Grab the two keys: after creation you get the Site Key (public, e.g. 0x4AAAAAA...) and the Secret Key (private, shown in full only once — copy it immediately).
4. Fill them into the desktop app: Zlog Settings → Comments → paste both keys → Save.
5. It takes effect: local comments get the verification widget immediately; one-click Vercel deploys carry the keys over automatically, so the live site is protected the same way.

Notes

• Without keys, comments still work — just no captcha (no spam protection).
• Cloudflare provides test keys: 1x000... (always passes) / 2x000... (always blocks) — for local debugging only, never deploy them (they silently disable the gate).
• Changed domain? Update the Hostname list in the Turnstile site settings.

FAQ

Q: The deploy says the token is invalid? A: Make sure you pasted the full token (starts with vcp_) and copied it before closing the creation page.

Q: How long does a deploy take? A: Upload ~1 minute, cloud build 2–5 minutes. You can cancel mid-way.

Q: Can I change the password on the live admin? A: Yes, identical to local. Forgot it? Reset via Settings → Account in the desktop app.

Q: How do I enable comment spam protection? A: In the desktop app, open Settings → Comments and paste the Cloudflare Turnstile Site Key and Secret Key (create a site in the Turnstile console to get both). Local comments get human verification immediately, and one-click deploys carry the keys over automatically — the live site is protected the same way.

Q: Want your own domain? A: Vercel console → project → Settings → Domains, add your domain and follow the DNS prompts — live within minutes.

---

Series recap:

• Part 1: Which mode should you choose?
• Part 2: Turso cloud sync
• Part 3: One-click Vercel deploy ← you are here

That's it — a blog you can write from any device and share with anyone. Happy writing!