Claude-elixir-phoenix lv:assigns

Audit LiveView socket assigns — memory estimates, missing temporary_assigns, unused assigns, unbounded lists needing streams. Use when investigating LiveView memory bloat.

install
source · Clone the upstream repo
git clone https://github.com/oliver-kriska/claude-elixir-phoenix
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/oliver-kriska/claude-elixir-phoenix "$T" && mkdir -p ~/.claude/skills && cp -r "$T/plugins/elixir-phoenix/skills/assigns-audit" ~/.claude/skills/oliver-kriska-claude-elixir-phoenix-lv-assigns && rm -rf "$T"
manifest: plugins/elixir-phoenix/skills/assigns-audit/SKILL.md
source content

LiveView Assigns Audit

Analyze LiveView socket assigns for memory efficiency, clarity, and best practices.

Iron Laws - Never Violate These

  1. Use streams for lists > 100 items - Never store large lists directly in assigns
  2. Use temporary_assigns for transient data - Flash messages, temp errors, notifications
  3. Preload only needed fields - Don't store full Ecto schemas when only needing subset
  4. Initialize all assigns in mount - Never access assigns that might not exist
  5. NEVER modify assigns or code during audit — this is a read-only diagnostic; report findings only

Quick Audit Commands

Extract All Assigns

Use Grep to find all

assign(
and
assign_new(
calls in the target LiveView file.

Find Large Data Patterns

Use Grep to find large data patterns: lists stored in assigns (

assign.*\[\]
,
assign.*Repo\.all
) and full schema storage (
assign.*Repo\.get
) in the target file.

Audit Checklist

1. Memory Issues

PatternProblemSolution
assign(:items, Repo.all(...))
Unbounded listUse
stream/3
assign(:user, Repo.get!(...))
Full schemaSelect only needed fields
assign(:file_data, binary)
Large binaryStore reference, not data
Nested preloadsExcessive dataPreload only what's rendered

2. Missing temporary_assigns

Should use

temporary_assigns
:

  • Flash messages
  • Form errors after submission
  • One-time notifications
  • Upload progress
def mount(_params, _session, socket) do
  {:ok, socket, temporary_assigns: [flash_message: nil]}
end

3. Unused Assigns

Search for assigns defined but never used in templates:

Use Grep to extract all assign names (

assign\(:(\w+)
) from the LiveView file, then use Grep to find all
@\w+
references in the corresponding
.heex
template. Compare to find unused assigns.

4. Missing Initialization

# BAD: @items might not exist
def render(assigns) do
  ~H"<%= for item <- @items do %>"
end

# GOOD: Initialize in mount
def mount(_params, _session, socket) do
  {:ok, assign(socket, items: [])}
end

Memory Estimation

For each assign, estimate memory footprint:

Data TypeApprox SizeConcern Level
Integer8 bytesLow
String (100 chars)~200 bytesLow
List of 100 maps~10-50 KBMedium
List of 1000 items~100-500 KBHigh
Binary (image)VariesCritical
Full Ecto schema~1-5 KB eachMedium

Usage

Run

/lv:assigns path/to/live_view.ex
to generate an assigns inventory with memory estimates and optimization recommendations.