Phase 4: Local dev experience — vertz dev with Vite HMR

[viniciusdacal]

Description

vertz dev runs the full stack locally with HMR — one command, full stack.

Context

After SSR + hydration works on Cloudflare (Phase 3), we need the local dev story to be seamless. Developers should run one command and get SSR + HMR + API + SQLite.

Tasks

1. vertz dev with Vite HMR

• UI hot module replacement without page refresh
• Server restarts on entity/schema changes

2. SQLite local persistence

• Use better-sqlite3 (not D1) for local dev
• Data persists between server restarts
• Same schema, different adapter (SQLite vs D1)

Target workflow

cd examples/entity-todo
vertz dev
# → http://localhost:3000 (SSR + HMR + API + SQLite)

Open questions

• How much of vertz dev already works today?
• Does it support SSR + API + HMR simultaneously?

References

• Design doc: plans/entity-todo-cloudflare-deployment.md (Phase 4)
• Depends on: Phase 3 (Phase 3: SSR + Client Hydration for entity-todo #615)
• Can partially parallelize with Phase 3
• Estimate: 4-6 hours

Acceptance Criteria

• vertz dev starts everything with one command
• UI changes hot-reload without page refresh
• Entity changes trigger server restart
• Data persists in local SQLite between restarts

Progress

• 2026-02-22: Not started