feat: add basic auth to todos, migrate examples to Sync() lifecycle

avatar-upload/main.go

@@ -128,7 +128,6 @@ func main() {
 	lt := livetemplate.Must(livetemplate.New("avatar-upload",
 		livetemplate.WithParseFiles("avatar-upload.tmpl"),
 		livetemplate.WithDevMode(true),
-		livetemplate.WithStatePersistence(),
 		// Configure upload using WithUpload option
 		livetemplate.WithUpload("avatar", livetemplate.UploadConfig{
 			Accept:      []string{"image/jpeg", "image/png", "image/gif"},

counter/main.go

@@ -86,7 +86,7 @@ func main() {
 		LastUpdated: formatTime(),
 	}
 
-	opts := append(envConfig.ToOptions(), livetemplate.WithStatePersistence())
+	opts := envConfig.ToOptions()
 	tmpl := livetemplate.Must(livetemplate.New("counter", opts...))
 	liveHandler := tmpl.Handle(controller, livetemplate.AsState(initialState))
 

flash-messages/main.go

@@ -130,7 +130,7 @@ func main() {
 	initialState := &FlashState{}
 
 	// Create template with environment-based configuration
-	opts := append(envConfig.ToOptions(), livetemplate.WithStatePersistence())
+	opts := envConfig.ToOptions()
 	tmpl := livetemplate.Must(livetemplate.New("flash", opts...))
 
 	// Mount handler

go.mod

@@ -8,7 +8,7 @@ require (
 	github.com/go-playground/validator/v10 v10.30.1
 	github.com/google/uuid v1.6.0
 	github.com/gorilla/websocket v1.5.3
-	github.com/livetemplate/livetemplate v0.8.9
+	github.com/livetemplate/livetemplate v0.8.10
 	github.com/livetemplate/lvt v0.0.0-20260327182801-53d6d40e692e
 	github.com/livetemplate/lvt/components v0.0.0-20260327182801-53d6d40e692e
 	modernc.org/sqlite v1.43.0
@@ -46,5 +46,3 @@ require (
 	modernc.org/mathutil v1.7.1 // indirect
 	modernc.org/memory v1.11.0 // indirect
 )
-
-replace github.com/livetemplate/livetemplate => ../livetemplate/.worktrees/per-connection-persist

go.sum

@@ -92,6 +92,8 @@ github.com/ledongthuc/pdf v0.0.0-20220302134840-0c2507a12d80 h1:6Yzfa6GP0rIo/kUL
 github.com/ledongthuc/pdf v0.0.0-20220302134840-0c2507a12d80/go.mod h1:imJHygn/1yfhB7XSJJKlFZKl/J+dCPAknuiaGOshXAs=
 github.com/leodido/go-urn v1.4.0 h1:WT9HwE9SGECu3lg4d/dIA+jxlljEa1/ffXKmRjqdmIQ=
 github.com/leodido/go-urn v1.4.0/go.mod h1:bvxc+MVxLKB4z00jd1z+Dvzr47oO32F/QSNjSBOlFxI=
+github.com/livetemplate/livetemplate v0.8.10 h1:Lg62gb297Iq3/EShPnEUyqDFN8aeyTYchbW3wUFU370=
+github.com/livetemplate/livetemplate v0.8.10/go.mod h1:GMvZKyPUq8LSGfgD3pftKOHa6v+I+RDYyff2mNjeAYs=
 github.com/livetemplate/lvt v0.0.0-20260327182801-53d6d40e692e h1:nAV7BaOatFcbSaP6m9CgLrRsGPeWtbjPDZ8dOI6Zb+c=
 github.com/livetemplate/lvt v0.0.0-20260327182801-53d6d40e692e/go.mod h1:17cFl500ntymD3gx8h+ZODnVnTictHgG8Wmz/By75sU=
 github.com/livetemplate/lvt/components v0.0.0-20260327182801-53d6d40e692e h1:vuR0pQtEQHZOD2/HvTJfHPKEdoD77XUs1mq1kdjgVig=

live-preview/main.go

@@ -53,7 +53,7 @@ func main() {
 	controller := &PreviewController{}
 	initialState := &PreviewState{Preview: preview("")}
 
-	opts := append(envConfig.ToOptions(), livetemplate.WithStatePersistence())
+	opts := envConfig.ToOptions()
 	tmpl := livetemplate.Must(livetemplate.New("preview", opts...))
 	http.Handle("/", tmpl.Handle(controller, livetemplate.AsState(initialState)))
 	http.HandleFunc("/livetemplate-client.js", e2etest.ServeClientLibrary)

login/main.go

@@ -165,7 +165,7 @@ func main() {
 	initialState := &AuthState{}
 
 	// Create template with environment-based configuration
-	opts := append(envConfig.ToOptions(), livetemplate.WithStatePersistence())
+	opts := envConfig.ToOptions()
 	tmpl := livetemplate.Must(livetemplate.New("auth", opts...))
 
 	// Set up handler with Controller+State pattern

profile-progressive/main.go

@@ -60,7 +60,7 @@ func main() {
 		log.Fatal(err)
 	}
 
-	opts := append(envConfig.ToOptions(), livetemplate.WithStatePersistence())
+	opts := envConfig.ToOptions()
 	tmpl, err := livetemplate.New("profile", opts...)
 	if err != nil {
 		log.Fatal(err)

progressive-enhancement/main.go

@@ -160,7 +160,7 @@ func main() {
 
 	// Create template with configuration
 	// Progressive enhancement is enabled by default
-	opts := append(envConfig.ToOptions(), livetemplate.WithStatePersistence())
+	opts := envConfig.ToOptions()
 	tmpl := livetemplate.Must(livetemplate.New("progressive-enhancement", opts...))
 
 	// Mount handler

shared-notepad/main.go

@@ -4,37 +4,57 @@ import (
 	"log"
 	"net/http"
 	"os"
+	"sync"
 	"time"
 
 	"github.com/livetemplate/livetemplate"
 	e2etest "github.com/livetemplate/lvt/testing"
 )
 
-// NotepadController is a stateless singleton — all state lives in NotepadState
-// and is shared across tabs via WithSharedState.
-type NotepadController struct{}
+type NotepadController struct {
+	mu    sync.RWMutex
+	notes map[string]NotepadState // userID -> latest state
+}
 
-// NotepadState is shared across all tabs of the same authenticated user.
-// WithSharedState means any change auto-broadcasts to all other tabs.
 type NotepadState struct {
 	Username  string `json:"username"`
 	Content   string `json:"content"`
 	SavedAt   string `json:"saved_at"`
 	CharCount int    `json:"char_count"`
 }
 
-// Mount initializes the notepad for a new session.
 func (c *NotepadController) Mount(state NotepadState, ctx *livetemplate.Context) (NotepadState, error) {
 	state.Username = ctx.UserID()
+	c.mu.RLock()
+	if saved, ok := c.notes[ctx.UserID()]; ok {
+		state.Content = saved.Content
+		state.CharCount = saved.CharCount
+		state.SavedAt = saved.SavedAt
+	}
+	c.mu.RUnlock()
 	return state, nil
 }
 
-// Save persists the note (triggered by the Save button).
-// WithSharedState auto-broadcasts to all other tabs of this user.
 func (c *NotepadController) Save(state NotepadState, ctx *livetemplate.Context) (NotepadState, error) {
 	state.Content = ctx.GetString("content")
 	state.CharCount = len([]rune(state.Content))
 	state.SavedAt = time.Now().Format("15:04:05")
+
+	c.mu.Lock()
+	c.notes[ctx.UserID()] = state
+	c.mu.Unlock()
+
+	return state, nil
+}
+
+func (c *NotepadController) Sync(state NotepadState, ctx *livetemplate.Context) (NotepadState, error) {
+	c.mu.RLock()
+	if saved, ok := c.notes[ctx.UserID()]; ok {
+		state.Content = saved.Content
+		state.CharCount = saved.CharCount
+		state.SavedAt = saved.SavedAt
+	}
+	c.mu.RUnlock()
 	return state, nil
 }
 
@@ -49,21 +69,16 @@ func main() {
 		log.Fatalf("Invalid configuration: %v", err)
 	}
 
-	// BasicAuth: each user gets their own isolated session group.
-	// The library's ChallengeAuthenticator sends WWW-Authenticate header
-	// automatically, triggering the browser's login dialog.
 	auth := livetemplate.NewBasicAuthenticator(func(username, password string) (bool, error) {
-		// Demo: accept any username with password "demo"
 		return password == "demo", nil
 	})
 
 	opts := envConfig.ToOptions()
-	opts = append(opts,
-		livetemplate.WithAuthenticator(auth),
-		livetemplate.WithSharedState(), // All tabs of the same user share state
-	)
+	opts = append(opts, livetemplate.WithAuthenticator(auth))
 
-	controller := &NotepadController{}
+	controller := &NotepadController{
+		notes: make(map[string]NotepadState),
+	}
 	initialState := &NotepadState{}
 
 	tmpl := livetemplate.Must(livetemplate.New("notepad", opts...))

shared-notepad/notepad.tmpl

@@ -34,7 +34,7 @@
             <header><strong>How it works</strong></header>
             <ul>
                 <li><strong>BasicAuth</strong> — each user gets an isolated session (alice's notes are separate from bob's)</li>
-                <li><strong>WithSharedState</strong> — all tabs of the same user share state (Save in one tab updates all)</li>
+                <li><strong>Sync()</strong> — all tabs of the same user auto-sync (Save in one tab updates all)</li>
                 <li>Notes persist across page refreshes within the same server session</li>
             </ul>
             <small>Demo credentials: any username, password <strong>demo</strong></small>

todos-components/main.go

@@ -246,7 +246,6 @@ func main() {
 		ltSets[i] = convertTemplateSet(set)
 	}
 	opts = append(opts, livetemplate.WithComponentTemplates(ltSets...))
-	opts = append(opts, livetemplate.WithStatePersistence())
 
 	// Create template with component templates registered
 	tmpl := livetemplate.Must(livetemplate.New("todos-components", opts...))

todos-progressive/main.go

@@ -118,7 +118,7 @@ func main() {
 		log.Fatal(err)
 	}
 
-	opts := append(envConfig.ToOptions(), livetemplate.WithStatePersistence())
+	opts := envConfig.ToOptions()
 	tmpl, err := livetemplate.New("todos", opts...)
 	if err != nil {
 		log.Fatal(err)