phoenix changelog

Welcome to the latest update! We've got some exciting new features, improvements, and a few bug fixes to make your experience even better. Let's dive into what's new and shiny! 🎉

  • New Feature: Enhanced Routing with Phoenix.VerifiedRoutes 🚀
    We've introduced the Phoenix.VerifiedRoutes behavior, which supercharges routing in Phoenix apps. This allows custom plugs like AshJsonApiRouter to automatically expand their routes with mix phx.routes, supporting verified routes at compile time. This makes it a breeze to manage and display complex routes, ensuring your application's routing is both flexible and robust.

  • New Feature: Route Prefix Option for Scopes 🛣️
    Say hello to the new route_prefix option for scopes! This nifty feature helps you manage routes more effectively by adding test_context_scope only when a route prefix is specified. It also improves scope assignment messages and optimizes broadcast generation, making your routing system more efficient and easier to handle.

  • Improvement: Case-Insensitive Token Type 🔑
    We've aligned with HTTP/1.1 Authentication specs by introducing support for case-insensitive token types. Now, the "Bearer" token in authorization headers can be recognized regardless of its casing, making your authentication process more robust and compliant.

  • Improvement: Tailwind CSS Update to v4 🎨
    We've updated our Tailwind CSS framework to version 4.0.9, ensuring compatibility with the Heroicons plugin. This update includes new utilities and adjustments to the brand color, enhancing your project's styling capabilities with fresh, modern features.

  • New Feature: Automated Asset Updates 🔄
    We've rolled out an automated workflow for updating assets, targeting the main and versioned branches. This GitHub Actions workflow ensures that your latest assets are always up-to-date without manual intervention, streamlining asset management and improving build efficiency.

  • Improvement: Console Formatter Optimization 🖥️
    By using iodata for binary formatting in the Phoenix.Router.ConsoleFormatter, we've optimized console output performance and readability. This change streamlines helper printing and reduces code complexity, ensuring a smooth and efficient developer experience.

  • Bugfix: Subprotocols Without AuthToken 🐞
    We've tackled issues with subprotocols missing an authentication token in the Phoenix framework's JavaScript implementation. The LongPoll class now handles undefined or empty protocols gracefully, enhancing error handling and connection flexibility.

  • Chore: Reorganize CSS Script 🗂️
    We've moved the recreate_default_css.exs script to the installer folder, tidying up the project structure. This reorganization ensures users are directed to the correct location for recreating default CSS files, keeping things neat and organized.

We hope these updates make your development journey smoother and more enjoyable. Happy coding! 🎉

Included Commits

2025-03-15T20:33:09 See commit

This commit modifies the Phoenix.Router.ConsoleFormatter to enhance the performance and readability of the console output by using iodata for formatting binary data. The changes involve refactoring how routes and endpoints are formatted, transitioning from using Enum.map_join to IO.iodata_to_binary, which combines the formatted elements into a single binary output more efficiently. Additionally, the helper printing for endpoints has been streamlined, eliminating unnecessary parameters in function definitions and reducing overall code complexity.

In the accompanying test file, adjustments were made to ensure that the output remains consistent with the new formatting logic. The test cases were updated to reflect the changes in the output structure, ensuring that routes and endpoints are displayed correctly without altering the intended functionality. Overall, this commit not only optimizes the code but also maintains the clarity and accuracy of the console output for developers using the Phoenix framework.

Files changed

  • lib/phoenix/router/console_formatter.ex
  • test/phoenix/router/console_formatter_test.exs
2025-03-18T13:38:40 See commit

This commit introduces a new route_prefix option for scopes in the project, enhancing the ability to manage routes effectively. The changes ensure that the test_context_scope is only added when a route prefix is specified, and it generates an unused _scope parameter for the return_to functionality. Additionally, the commit includes various updates to ensure format checks pass and improves the scope assignment message, alongside several bug fixes and optimizations to avoid generating broadcasts multiple times.

Numerous files across the guides, integration tests, and various templates were modified to accommodate this new feature, including updates to context generation tasks, controller templates, and HTML files. The commit also includes adjustments to tests to ensure all changes are thoroughly validated, reflecting a comprehensive enhancement to the handling of scopes within the application's routing system.

Files changed

  • guides/authn_authz/scopes.md
  • integration_test/test/code_generation/app_with_scopes_test.exs
  • lib/mix/phoenix/schema.ex
  • lib/mix/phoenix/scope.ex
  • lib/mix/tasks/phx.gen.context.ex
  • lib/mix/tasks/phx.gen.html.ex
  • lib/mix/tasks/phx.gen.json.ex
  • lib/mix/tasks/phx.gen.live.ex
  • priv/templates/phx.gen.auth/auth.ex
  • priv/templates/phx.gen.auth/auth_test.exs
  • priv/templates/phx.gen.auth/routes.ex
  • priv/templates/phx.gen.auth/settings_live.ex
  • priv/templates/phx.gen.context/schema_access_scope.ex
  • priv/templates/phx.gen.html/controller.ex
  • priv/templates/phx.gen.html/controller_test.exs
  • priv/templates/phx.gen.html/edit.html.heex
  • priv/templates/phx.gen.html/index.html.heex
  • priv/templates/phx.gen.html/new.html.heex
  • priv/templates/phx.gen.html/show.html.heex
  • priv/templates/phx.gen.json/controller.ex
  • priv/templates/phx.gen.json/controller_test.exs
  • priv/templates/phx.gen.live/form.ex
  • priv/templates/phx.gen.live/index.ex
  • priv/templates/phx.gen.live/live_test.exs
  • priv/templates/phx.gen.live/show.ex
  • test/mix/tasks/phx.gen.auth_test.exs
  • test/mix/tasks/phx.gen.html_test.exs
  • test/mix/tasks/phx.gen.json_test.exs
  • test/mix/tasks/phx.gen.live_test.exs
2025-03-18T14:27:02 See commit

This commit introduces support for case-insensitive token types in the authentication process, aligning with the specifications outlined in HTTP/1.1 Authentication. Specifically, it modifies the code to ensure that the "Bearer" token in the authorization header can be recognized regardless of its casing, thus improving the robustness of the authentication mechanism.

Additionally, the commit includes updates to the documentation in guides/authn_authz/api_authentication.md, reflecting these changes and providing clarity on the new implementation. The modifications consist of a few additions and minor deletions to enhance the code's readability and functionality, ensuring that the authentication process remains compliant with established standards. The commit was co-authored by Steffen Deusch.

Files changed

  • guides/authn_authz/api_authentication.md
2025-03-18T22:02:28 See commit

This commit updates the project's Tailwind CSS framework from version 3.4.3 to 4.0.9, ensuring compatibility with the Heroicons plugin. Key changes include the introduction of a new JavaScript file, tailwind_heroicons.js, which integrates Heroicons into the Tailwind setup, allowing for the use of icon classes in the application. Additionally, the commit modifies various CSS utilities, such as updating the rounded-table-corner utility and adjusting the brand color to utilize the oklch color space.

The commit also includes updates to configuration files and tests to reflect these changes, ensuring that the application maintains functionality and compatibility with the new Tailwind version. Several files were modified, including the main CSS file, configuration files, and test scripts to ensure proper integration and testing of the new features. The commit was co-authored by Leif Metcalf, highlighting collaborative efforts in enhancing the project's styling capabilities.

Files changed

  • guides/mix_tasks.md
  • installer/lib/phx_new/single.ex
  • installer/templates/phx_assets/app.css
  • installer/templates/phx_assets/tailwind_heroicons.js
  • installer/templates/phx_single/config/config.exs
  • installer/templates/phx_umbrella/apps/app_name_web/config/config.exs
  • installer/templates/phx_web/components/core_components.ex
  • installer/test/phx_new_test.exs
  • installer/test/phx_new_umbrella_test.exs
  • installer/test/phx_new_web_test.exs
  • integration_test/config/config.exs
2025-03-19T10:28:19 See commit

This commit addresses issues related to handling subprotocols without an authentication token in the Phoenix framework's JavaScript implementation. Key modifications include updates in the ajax.js, constants.js, longpoll.js, and socket.js files to ensure that the LongPoll class can function properly even when protocols are undefined or empty. Specifically, it modifies the constructor of the LongPoll class to handle cases where the protocols are either null, undefined, or an empty array, allowing it to initialize without throwing errors. Additionally, it ensures that the authentication token is only extracted when valid protocols are provided, enhancing the robustness of the connection setup.

The commit also introduces a comprehensive suite of tests for the LongPoll class and its interaction with the Socket class using Jest, ensuring that the modifications are validated. These tests cover scenarios such as handling undefined protocols, correctly extracting the authentication token when available, and verifying that the appropriate headers are sent during requests. The overall changes improve the error handling and flexibility of the LongPoll connection mechanism, making it more resilient in various usage contexts.

Files changed

  • assets/js/phoenix/ajax.js
  • assets/js/phoenix/constants.js
  • assets/js/phoenix/longpoll.js
  • assets/js/phoenix/socket.js
  • assets/test/longpoll_test.js
2025-03-19T10:54:46 See commit

This commit introduces an automated workflow for updating assets in the project, specifically targeting the main branch and versioned branches. The new GitHub Actions workflow, defined in .github/workflows/assets.yml, is designed to run on Ubuntu 24.04 and sets up the necessary environments for Elixir and Node.js. It includes steps for checking out the code, restoring dependencies, building assets, and automatically committing and pushing updated assets back to the repository. This process streamlines the asset management and ensures that the latest assets are always available without manual intervention.

Additionally, the commit updates the existing CI configuration in .github/workflows/ci.yml, changing the Elixir version to 1.18.3 and updating the environment to run on Ubuntu 24.04. These modifications reflect a commitment to keeping the development environment up-to-date and improving the overall efficiency of the build process. The changes help maintain compatibility with the latest versions of dependencies and enhance the project's automated workflows.

Files changed

  • .github/workflows/assets.yml
  • .github/workflows/ci.yml
2025-03-20T10:08:16 See commit

This commit introduces the Phoenix.VerifiedRoutes behavior, which enhances the routing capabilities in Phoenix applications by allowing custom plugs like AshJsonApiRouter to automatically expand their routes when using the mix phx.routes command. The changes involve modifications to several files, including lib/phoenix/router.ex, lib/phoenix/router/console_formatter.ex, and lib/phoenix/verified_routes.ex, to implement functionalities for formatted routes and route verification. The new behavior enables dynamic routers to support verified routes at compile time, making it easier to manage and display routes.

Key features added include the ability for custom routers to define their own formatted_routes and verified_route? functions, which provide essential information for route display and verification processes. The commit also refines the existing routing logic, ensuring that the router can handle nested routes more effectively. Overall, this enhancement improves the flexibility and usability of routing in Phoenix applications, paving the way for more complex routing scenarios.

Files changed

  • lib/phoenix/router.ex
  • lib/phoenix/router/console_formatter.ex
  • lib/phoenix/verified_routes.ex
2025-03-20T12:25:05 See commit

This commit involves the relocation of the recreate_default_css.exs script from the project root to the installer folder. The changes were made in the installer/lib/phx_new/single.ex file, where the comment was updated to reflect the new path for running the script, now indicating that it should be executed from the installer directory rather than the project root.

Additionally, the script itself has been renamed to its new location in the installer folder, but no content changes were made to the script itself. This modification streamlines the organization of scripts related to the installation process, ensuring that users are directed to the correct location for recreating the default CSS files.

Files changed

  • installer/lib/phx_new/single.ex
  • installer/recreate_default_css.exs