phoenixframework/phoenix_live_view
59.2
Adequate · 13 November 2026
30.6k
lines of production code
Elixir
with TypeScript
8
measurements over time
What this system is
Features
Add dedicated Phoenix LiveView compiler task for HEEx macro components
A new Mix compiler task, \Mix.Tasks.Compile.PhoenixLiveView\, has been introduced to handle HEEx macro components. This task is designed to process colocated assets, specifically \Phoenix.LiveView.ColocatedHook\, \Phoenix.LiveView.ColocatedJS\, and \Phoenix.LiveView.ColocatedCSS\. To enable this functionality, users must explicitly add \:phoenix\_live\_view\ to their \compilers\ list in \mix.exs\, ensuring it runs after the Elixir compiler to compile these specific assets.
lib/mix/tasks/compile · high confidence
Added Phoenix LiveView upgrade task for 1.0 to 1.1 migration
A new \phoenix\_live\_view.upgrade\ Mix task has been introduced to facilitate upgrading Phoenix LiveView from version 1.0 to 1.1. The task leverages the Igniter framework to automatically apply necessary code changes during the upgrade process. If Igniter is not installed, the task provides a clear error message directing users to install it before proceeding.
lib/mix/tasks · high confidence
Introduce Phoenix.Component for function components and HEEx templates
This change introduces the \Phoenix.Component\ module, providing a new API for defining reusable, stateless function components using the \\~H\ HEEx template sigil. It adds the \attr/3\ macro for declaring component attributes with types and defaults, and supports global attributes for dynamic HTML properties. Alongside this, the \Phoenix.LiveComponent\ module is updated to document the distinction between stateful LiveComponents and the new stateless function components, encouraging the latter for simpler UI parts. The diff also includes a new \Phoenix.LiveView.HTMLFormatter.TagFormatter\ behavior, allowing developers to customize how specific HTML tags are formatted by the Mix formatter (e.g., integrating with Prettier for script tags).
lib · high confidence
Introduce Phoenix.LiveViewTest for testing LiveViews and components
This change adds the \Phoenix.LiveViewTest\ module and its supporting internal modules (\ClientProxy\, \Diff\, \DOM\, \TreeDOM\, \UploadClient\, \Utils\, and \Structs\) to the \lib/phoenix\_live\_view/test\ directory. These files provide the foundational infrastructure for testing LiveViews, LiveComponents, and function components, including DOM parsing via \LazyHTML\, event simulation, upload handling, and diff merging logic. The addition establishes the core testing API and internal state management required to interact with LiveViews in a test environment.
_lib/phoenix\_live\view/test · high confidence
Introduce async assign operations and colocated asset support
Phoenix.LiveView now supports asynchronous state management via \start\_async\, \assign\_async\, and \stream\_async\, which allow background tasks to update the UI without blocking the main process. These operations are backed by the new \AsyncResult\ struct for tracking loading, success, and failure states, and include runtime warnings to prevent expensive socket copying. Additionally, the framework introduces a system for colocated assets (JS, CSS, and hooks), allowing developers to bundle frontend assets directly with their LiveView components, with automatic manifest generation and symlink handling for dependencies like \node\_modules\.
_lib/phoenix\_live\view · high confidence
LiveView JavaScript client rewritten in TypeScript
The LiveView JavaScript client source code in \assets/js\ has been rewritten from JavaScript to TypeScript. This migration introduces strict type definitions for public interfaces, hooks, and internal modules (such as DOM patching, JS commands, and upload handling), providing better IDE support and compile-time safety for advanced users integrating with the client API.
assets/js · high confidence
New CommonJS build artifact for Phoenix LiveView
A new CommonJS module build (\phoenix\_live\_view.cjs.js\) is now included in the \priv/static\ directory, providing a \module.exports\ interface for environments that do not support ES modules natively. This addition complements the existing ESM and IIFE builds, allowing CommonJS consumers to import the full LiveView client API (including \LiveSocket\, \ViewHook\, and \createHook\) directly.
priv · high confidence
New cheatsheet for phx-\* HTML attributes
Added a new reference guide (\guides/cheatsheets/html-attrs.cheatmd\) summarizing special \phx-\*\ HTML attributes used in Phoenix LiveView templates. The document organizes attributes by category—including event handlers (click, focus, keyboard, scroll), form event handlers (change, submit, auto-recover, trigger-action, no-unused-field), socket and DOM lifecycle events, client hooks, static asset tracking, and formatting options—and links each to its detailed documentation.
guides/cheatsheets · high confidence
New declarative component engine and macro component support
This release introduces a new declarative component engine in Phoenix.Component.Declarative, which handles global attributes, reserved assigns, and function definition annotations. It also adds support for macro components via Phoenix.Component.MacroComponent, allowing HEEx templates to define compile-time transformations (such as colocated hooks or JS) using a :type attribute and transform callbacks.
_lib/phoenix\component · high confidence
Project initialization and developer tooling setup
The repository has been initialized with essential configuration files to support development and testing workflows. This includes a new MIT license, a security policy defining support for minor branches, and a changelog structure for v1.3. Developer tooling is established with ESLint and Prettier configurations for code quality, TypeScript and Babel settings for JavaScript/TypeScript compilation, and Jest configuration for unit testing. The Elixir formatter is updated to use the Phoenix HTML formatter and Prettier for scripts, and the README is expanded with comprehensive documentation, feature highlights, and instructions for running tests.
(repo-wide) · high confidence
Behavioural changes
Automated upgrade path to Phoenix LiveView 1.1
The Igniter tooling now includes an automated upgrader for migrating projects from version 1.0 to 1.1. This update handles several configuration changes: it adds the \:lazy\_html\ dependency for tests, ensures \:phoenix\_live\_view\ is correctly prioritized in the project's compilers list and the dev endpoint's \:reloadable\_compilers\, and updates the \:esbuild\ configuration to support colocated hooks (including adding the \--alias:@=.\ argument and configuring \NODE\_PATH\). It also adds \debug\_attributes\ to the upgrade process to assist with development workflows.
_lib/phoenix\_live\view/igniter · high confidence
Introduce new HEEx Tag Engine with Compiler, Parser, and Tokenizer
Phoenix Live View now uses a new internal Tag Engine architecture for compiling HEEx templates, replacing the previous implementation. This change introduces three new modules—\Phoenix.LiveView.TagEngine.Compiler\, \Phoenix.LiveView.TagEngine.Parser\, and \Phoenix.LiveView.TagEngine.Tokenizer\—which handle the tokenization, parsing, and compilation of HEEx syntax into Elixir code. This refactor underpins recent template features such as root tag attributes, macro component directives, and improved whitespace handling, ensuring that template compilation is more robust and extensible.
_lib/phoenix\_live\_view/tag\engine · high confidence
Migrate to new config syntax and add environment-specific configuration files
The application configuration has been updated to use the modern \import Config\ syntax instead of the deprecated \use Mix.Config\. New environment-specific configuration files have been introduced: \dev.exs\ and \docs.exs\ now contain minimal setup, while \e2e.exs\ configures the logger to error level and sets a custom root tag attribute (\phx-r\). The \test.exs\ file enables expensive runtime checks and configures test warnings for missing form IDs. The main \config.exs\ now explicitly sets the JSON library to Jason, disables HTML EEX engine trimming, and configures esbuild to generate CommonJS, ESM, and IIFE bundles for the browser, targeting ES2016 for the CDN build.
config · high confidence
Test coverage
Add Playwright-based end-to-end test infrastructure; Added E2E support LiveViews for testing new LiveView features; Added E2E test support files for LiveView issues 2787–3647; Added comprehensive test coverage for LiveView file uploads; Added comprehensive test suite for Phoenix LiveView assets; Added comprehensive test suite for Phoenix.Component; Added integration tests for LiveView core behaviors; Added test support infrastructure for Phoenix LiveView; Added tests for LiveView core features and colocated assets; Added tests for LiveView test client internals; Added tests for the Igniter upgrade path to Phoenix LiveView 1.1; Added unit tests for Phoenix.Component and Phoenix.LiveView; Added unit tests for the HEEx Tag Engine parser and tokenizer; Expanded end-to-end test coverage for LiveView edge cases; Expanded test fixtures for LiveView testing scenarios; New Playwright end-to-end test suite for LiveView features; New integration test suite for Phoenix.LiveView.
Dependencies
Upgrade to Phoenix LiveView 1.3.0-dev with modernized build tooling and dependency requirements
The project has advanced to version 1.3.0-dev, introducing significant updates to both the Elixir and JavaScript ecosystems. The Elixir side now requires Elixir 1.15+ and supports Phoenix 1.6.15, 1.7, or 1.8, while adopting esbuild for asset compilation and adding optional support for the \lazy\_html\ library. On the JavaScript side, the build pipeline has been modernized with Babel 8, TypeScript 6, and ESLint 10, and the package now exports both ESM and CommonJS modules to support modern import patterns.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.
Score
- CAI 56 → 59 (+3.2)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.
Lenses
- Code Health 47 → 53 (+6.2)
- Architecture 82 → 86 (+4.6)
- Maturity 55 → 55 (-0.3)
- Readiness 59 → 68 (+8.8)
- Security 80 → 80 (-0.8)
Resolved (51)
- High secret: WD-SECRET-0005 (assets/package-lock.json)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- …and 31 more
New (29)
- Edited copies of one member (3 members, 17+ corresponding lines) (lib/phoenix_live_view/logger.ex)
- Edited copies of one member (5 members, 10+ corresponding lines) (lib/phoenix_live_view/js.ex)
- Edited copy of a member (10 corresponding lines) (lib/phoenix_live_view/upload_config.ex)
- Edited copy of a member (13 corresponding lines) (lib/phoenix_live_view/utils.ex)
- Edited copy of a member (14 corresponding lines) (lib/phoenix_live_view/logger.ex)
- Edited copy of a member (17 corresponding lines) (lib/phoenix_live_view/channel.ex)
- Edited copy of a member (2 corresponding lines) (lib/phoenix_live_view/html_engine.ex)
- Edited copy of a member (24 corresponding lines) (lib/phoenix_live_view/diff.ex)
- Edited copy of a member (26 corresponding lines) (lib/phoenix_live_view/tag_engine/compiler.ex)
- Edited copy of a member (31 corresponding lines) (lib/phoenix_live_view/tag_engine/compiler.ex)
- Edited copy of a member (6 corresponding lines) (lib/phoenix_live_view/tag_engine/parser.ex)
- Edited copy of a member (6 corresponding lines) (lib/phoenix_live_view/tag_engine/tokenizer.ex)
- Edited copy of a member (9 corresponding lines) (lib/phoenix_live_view/tag_engine/tokenizer.ex)
- Further sole-owners (lower concentration)
- High: security finding (details withheld)
- Low CVE: [GHSA redacted] (package-lock.json)
- Medium CVE: EEF-[CVE redacted] (mix.lock)
- Medium CVE: EEF-[CVE redacted] (mix.lock)
- Medium CVE: [GHSA redacted] (package-lock.json)
- Medium CVE: [GHSA redacted] (package-lock.json)
- …and 9 more
Changes since last survey
- 19 commits — 19 feature/other, 0 fixes
By area
- .github/workflows — 7 commits
- lib/phoenix_live_view — 4 commits
- priv/static — 3 commits
- test/e2e — 2 commits
- (root) — 1 commit
- .github/FUNDING.yml — 1 commit
- assets/js — 1 commit
Notable commits
- change: Bump actions/cache from 4.3.0 to 6.1.0 (#4495)
- change: Bump actions/download-artifact from 4.3.0 to 8.0.2 (#4497)
- change: Bump actions/setup-node from 4.4.0 to 7.1.0 (#4499)
- change: Bump actions/upload-artifact from 4.6.2 to 7.0.2 (#4496)
- change: Bump actions/upload-pages-artifact from 3.0.1 to 5.0.0 (#4498)
- change: Bump the minor-and-patch group with 16 updates (#4500)
- change: Create live navigation history entries within the click (#4492)
- change: Handle file selection when LV is not connected (#4485)
- change: Only call handle_params/3 on patch if it's defined, raising if nothing handles params (#4487)
- change: Refuse joins whose url has no host instead of crashing (#4490)
- change: Resolve comprehension statics once during iodata conversion (#4482)
- change: Store component call file relative to cwd (#4489)
- change: Update assets
- change: Update assets
- change: Update assets
- change: add FUNDING notice
- change: resolve relative links (#4491)
- change: set up workload identity publish job for hex (#4493)
- change: use ubuntu 24.04 in CI for now, OTP 25 does not run on 26.04
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
phoenixframework/phoenix_live_view was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 13 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit ce708ec855fe6b3c6b0cb8318dc489078b525b09 — the exact code this score is about.
- Scored under rubric-2026.11.3 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.57+preprod-8ebfb01cf4c0.