phoenix-liveview-essentials

Phoenix LiveView Essentials

Keep the LiveView as the UI edge. Parse events and params, call domain/context functions, then assign results or show errors. Keep business rules out of callbacks.

Lifecycle and data

• mount/3 may run for the disconnected HTTP render and again for the connected socket. Keep it safe to repeat; subscribe or start live work only when connected?/1 is true.
• Put route-dependent loading in handle_params/3. Use push_patch for same-LiveView state and push_navigate for a new LiveView.
• Keep assigns limited to data needed by the render. Use streams for large or frequently updated collections.
• Load records through the application's authorization boundary; a guessed ID is not proof of access.

Events and forms

• Treat all event params as untrusted strings/maps. Validate with a changeset or domain parser before writing.
• handle_event/3 should coordinate work and update the socket. Move multi-step rules into a context or pure module.
• For forms, use to_form/1 and the project's current form conventions. Preserve changeset errors and keep validation behavior in the changeset.
• Use tagged results to render expected failures. Let unexpected failures surface to normal error reporting.

Tests

Cover initial render, relevant events, invalid input, authorization, and navigation that changes behavior. Use Phoenix.LiveViewTest and the existing ConnCase/DataCase setup. Avoid duplicating assertions already covered by component or context tests.

For large lists use liveview-streams; for auth flows use phoenix-authentication and phoenix-authorization-patterns.