Free tool, no signup
Paste a public GitHub repo. Get its releases as a readable changelog and a CHANGELOG.md you can copy.
Try phoenixframework/phoenix. Public repos only, newest 30 releases.
27 releases from GitHub, newest first.
# Changelog
Releases of phoenixframework/phoenix, newest first.
## v1.8.16 (2026-10-20)
### Bug fixes
* [phoenix.js] Fix a lot of connection handling races ([#6867](https://github.com/phoenixframework/phoenix/pull/6867))
* [phoenix.js] Don't treat WebSocket close code 1000 as special ([#6880](https://github.com/phoenixframework/phoenix/pull/6880))
### Enhancements
* Allow setting `max_channels_per_transport` in `Phoenix.Endpoint.socket/3`
## v1.8.15 (2026-09-25)
### Bug fixes
* [phx.gen.cert] Fix certificate not being accepted by Chromium ([#6847](https://github.com/phoenixframework/phoenix/issues/6847))
* [phoenix.js] Fix asynchronous transport close tearing down the replacement transport ([#6852](https://github.com/phoenixframework/phoenix/issues/6852))
### Enhancements
* [phx.new] Update Tailwind version to 4.3.3
## v1.8.14 (2026-09-14)
### Bug fixes
* Fix timer leak in LongPoll fetch requests (only used in service or web workers) ([#6811](https://github.com/phoenixframework/phoenix/pull/6811))
### Enhancements
* Raise when `:router` given to `use Phoenix.VerifiedRoutes` is not a compile time literal ([#6806](https://github.com/phoenixframework/phoenix/pull/6806))
* Align `nil` host handling in endpoint configuration and transport
* Unify path validation for static paths, verified routes and redirects
## v1.8.13 (2026-08-25)
### Bug fixes
* Workaround issue where Mobile Chrome 149+ would not reconnect after tab is resumed ([#6804](https://github.com/phoenixframework/phoenix/issues/6804))
## v1.8.12 (2026-08-20)
### Bug fixes
* [phx.gen.auth] Fix return_to session key not being cleared after logging in ([#6798](https://github.com/phoenixframework/phoenix/issues/6798))
* [Channels] Fix channel messages being invalidly dropped when receiving messages without a join_ref (introduced in 1.8.3) ([#6800](https://github.com/phoenixframework/phoenix/pull/6800))
## v1.8.11 (2026-08-12)
### Bug fixes
* Fix Phoenix crashing on boot if Mix is available, but not started ([#6789](https://github.com/phoenixframework/phoenix/issues/6789))
## v1.8.10 (2026-08-10)
### Bug fixes
* [Phoenix.CodeReloader] Fix "must restart your server" messages from code reloader when compile.lock mtime changes without a content change ([#6753](https://github.com/phoenixframework/phoenix/issues/6753))
* [Phoenix.Endpoint] add missing websocket options ([#6758](https://github.com/phoenixframework/phoenix/pull/6758))
* [phoenix.js] Close and retry the longpoll transport when a batch POST times out ([#6769](https://github.com/phoenixframework/phoenix/pull/6769))
* [phoenix.js] Release the stale reply binding of a buffered push ([#6788](https://github.com/phoenixframework/phoenix/pull/6788))
### Enhancements
* [phx.gen.release] Use Bob API to find Docker images in `phx.gen.release --docker`
* [Channels] Allow LongPoll transport token to be sent in header (this will change in 1.9)
* [Phoenix.Router] Support plugs with options in `pipe_throught` ([#6755](https://github.com/phoenixframework/phoenix/pull/6755))
* [Phoenix.Token] document encode options (see [the change in plug_crypto](https://github.com/elixir-plug/plug_crypto/commit/35dd3d3da1b8b2e0009e3efc40bc67d3822f7210))
* [phoenix.js] Ensure transport errors are identifiable ([#6763](https://github.com/phoenixframework/phoenix/pull/6763))
## v1.5.3 (2020-06-26)
_No release notes._
## v1.2.1 (2016-08-11)
- Enhancements
- [Router] Improve errors for invalid route paths
- [Plug] Include new development error pages
- Bug Fixes
- [Endpoint] Fixed issue where endpoint would fail to code reload on next request after an endpoint compilation error
## v1.2.0 (2016-06-23)
## 1.2.0 (2016-6-23)
See these [`1.1.x` to `1.2.x` upgrade instructions](https://gist.github.com/chrismccord/29100e16d3990469c47f851e3142f766) to bring your existing apps up to speed.
- Enhancements
- [CodeReloader] The `lib/` directory is now code reloaded by default along with `web/` in development
- [Channel] Add `:phoenix_channel_join` instrumentation hook
- [View] Generate private `render_template/2` clauses for views to allow overriding `render/2` clauses before rendering templates
- [View] Add `:path` and `:pattern` options to allow wildcard template inclusion as well as customized template directory locations
- Deprecations
- [Endpoint] Generated `subscribe/3` and `unsubscribe/2` clauses have been deprecated in favor of `subscribe/2` and `unsubscribe/1` which uses the caller's pid
- [PubSub] `Phoenix.PubSub.subscribe/3` and `Phoenix.PubSub.unsubscribe/2` have been deprecated in favor of `subscribe/2` and `unsubscribe/1` which uses the caller's pid
- [Watcher] Using the `:root` endpoint configuration for watchers is deprecated. Pass the :cd option at the end of your watcher argument list in config/dev.exs. For example:
``` elixir
watchers: [node: ["node_modules/brunch/bin/brunch", "watch", "--stdin",
cd: Path.expand("../", __DIR__)]]
```
- Bug Fixes
- [Template] Prevent infinite call stack when rendering a non-existent template from `template_not_found`
- JavaScript client enhancements
- Add Presence object for syncing presence state between client and server
- Use return value of channel onMessage callback for specialized message transformations before dispatching to the channel
- JavaScript client backward incompatible changes
- `Presence.syncState` and `Presence.syncDiff` now return a copy of the state instead of mutating it
## v1.2.0-rc.1 (2016-06-03)
## 1.2.0-rc.1 (2016-05-25)
See these [`1.1.x` to `1.2.x` upgrade instructions](https://gist.github.com/chrismccord/29100e16d3990469c47f851e3142f766) to bring your existing apps up to speed.
- Enhancements
- [View] Add `:path` and `:pattern` options to allow wildcard template inclusion as well as customized template directory locations
- Deprecations
- [Watcher] Using the `:root` endpoint configuration for watchers is deprecated. Pass the :cd option at the end of your watcher argument list in config/dev.exs. For example:
``` elixir
watchers: [node: ["node_modules/brunch/bin/brunch", "watch", "--stdin",
cd: Path.expand("../", __DIR__)]]
```
## v1.2.0-rc.0 (2016-05-01)
See these [`1.1.x` to `1.2.0` upgrade instructions](https://gist.github.com/chrismccord/29100e16d3990469c47f851e3142f766) to bring your existing apps up to speed.
- Enhancements
- [CodeReloader] The `lib/` directory is now code reloaded by default along with `web/` in development
- [Channel] Add `subscribe/2` and `unsubscribe/2` to handle external topic subscriptions for a socket
- [View] Generate private `render_template/2` clauses for views to allow overriding `render/2` clauses before rendering templates
- [Channel] Add `:phoenix_channel_join` instrumentation hook
- JavaScript client enhancements
- Add Presence object for syncing presence state between client and server
- Deprecations
- [Endpoint] Generated `subscribe/3` and `unsubscribe/2` clauses have been deprecated in favor of `subscribe/2` and `unsubscribe/1` which uses the caller's pid
- [PubSub] `Phoenix.PubSub.subscribe/3` and `Phoenix.PubSub.unsubscribe/2` have been deprecated in favor of `subscribe/2` and `unsubscribe/1` which uses the caller's pid
## v1.1.3 (2016-01-20)
- Enhancements
- [phoenix.gen] Support `--binary-id` option when generating scaffold
- [phoenix.new] Don't include Ecto gettext translations if `--no-ecto` is passed
- JavaScript client bug fixes
- Ensure exports variable does not leak
- Fix `setTimeout` scoping issue for Babel
## v1.1.2 (2016-01-08)
See these _optional_ [`1.1.1` to `1.1.2` upgrade instructions](https://gist.github.com/chrismccord/d5bc5f8e38c8f76cad33) to bring your existing apps up to speed.
- Enhancements
- [Cowboy] Improve log report for errors from the UserSocket
- [ChannelTest] Add `refute_push` and `refute_reply`
- [Router] Improve error messages when calling Router helpers without matching clauses
- [phoenix.new] Use brunch 2.1.1 npm integration to load `phoenix` and `phoenix_html` js deps
## v1.1.1 (2015-12-26)
- Bug fixes
- Fix `--no-html` flag on `phoenix.new` task failing to generate ErrorHelpers module
## v1.1.0 (2015-12-16)
See these [`1.0.x` to `1.1.0` upgrade instructions](https://gist.github.com/chrismccord/557ef22e2a03a7992624) to bring your existing apps up to speed.
- Enhancements
- [Router] Enable defining routes for custom http methods with a new `match` macro
- [CodeReloader] The socket transports now trigger the code reloader when enabled for external clients that only connect to channels without trigger a recompile through the normal page request.
- [phoenix.digest] The `phoenix.digest` task now digests asset urls in stylesheets automatically
- [Channel] Add `Phoenix.Channel.reply/3` to reply asynchronously to a channel push
- [Channel] `code_change/3` is now supported to upgrade channel servers
- [Endpoint] `check_origin` now supports wildcard hosts, ie `check_origin: ["//*.example.com"]`
- [Endpoint] `check_origin` treats invalid origin hosts as missing for misbehaving clients
- [Endpoint] Add `Phoenix.Endpoint.server?/2` to check if webserver has been configured to start
- [ConnTest] Add `assert_error_sent` to assert an error was wrapped and sent with a given status
- Backward incompatible changes
- [View] The `@inner` assign has been removed in favor of explicit rendering with `render/3` and the new `@view_module` and `view_template` assigns, for example: `<%= @inner %>` is replaced by `<%= render @view_module, @view_template, assigns %>`
## v1.0.4 (2015-11-30)
- Enhancements
- [ConnTest] Add `bypass_through` to pass a connection through a Router and pipelines while bypassing route dispatch.
- Bug fixes
- [LongPoll] force application/json content-type to fix blank JSON bodies on older IE clients using xdomain
## v1.0.3 (2015-09-28)
## 1.0.3 (2015-9-28)
- Enhancements
- [Controller] Transform FunctionClauseError's from controller actions into ActionClauseError, and send 400 response
- [Router] Allow plugs to be passed to `pipe_through`
- [Channel] WebSocket transport now sends server heartbeats and shutdowns if client heartbeats stop. Fixes timeout issues when clients keep connection open, but hang with suspended js runtimes
- JavaScript client deprecations
- Passing params to socket.connect() has been deprecated in favor of the `:params` option of the Socket constructor
## v1.0.2 (2015-09-06)
- Enhancements
- [Installer] Support `--database mongodb` when generating new apps
- [Installer] Support `binary_id` and `migration` configuration for models
- Bug fixes
- [Digest] Ensure Phoenix app is loaded before digesting
- [Generator] Ensure proper keys are generated in JSON views and tests
- [Generator] Ensure proper titles are generated in HTML views and tests
- [Mix] Ensure app is compiled before showing routes with `mix phoenix.routes`
- [Token] Ensure max age is counted in seconds and not in miliseconds
## v1.0.1 (2015-09-03)
_No release notes._
## v1.0.0 (2015-08-28)
_No release notes._
## v0.17.1 (2015-08-26)
- Enhancements
- [ChannelTest] Add `connect/2` helper for test UserSocket handlers
- [Endpoint] Expose `struct_url/0` in the endpoint that returns the URL as struct for further manipulation
- [Router] Allow `URI` structs to be given to generated `url/1` and `path/2` helpers
- Bug fixes
- [Endpoint] Pass port configuration when configuring force_ssl
- [Mix] By default include all attributes in generated JSON views
- [Router] Fix `pipe_through` not respecting halting when piping through mulitple pipelines
## v0.17.0 (2015-08-19)
See these [`0.16.x` to `0.17.0` upgrade instructions](https://gist.github.com/chrismccord/ee5ae90b949a9768b871) to bring your existing apps up to speed.
- Enhancements
- [Endpoint] Allow `check_origin` and `force_ssl` to be config in transports and fallback to endpoint config
- [Transport] Log when `check_origin` fails
- Bug fixes
- [Mix] Properly humanize names in the generator
- Deprecations
- [Endpoint] `render_errors: [default_format: "html"]` is deprecated in favor of `render_errors: [accepts: ["html"]]`
- Backward incompatible changes
- [Controller] The "format" param for overriding the accept header has been renamed to "_format" and is no longer injected into the params when parsing the Accept headers. Use `get_format/1` to access the negotiated format.
- [ChannelTest] In order to test channels, one must now explicitly create a socket and pass it to `subscribe_and_join`. For example, `subscribe_and_join(MyChannel, "my_topic")` should now become `socket() |> subscribe_and_join(MyChannel, "my_topic")` or `socket("user:id", %{user_id: 13}) |> subscribe_and_join(MyChannel, "my_topic")`.
## v0.16.1 (2015-08-06)
- JavaScript client bug fixes
- Pass socket params on reconnect
## v0.16.0 (2015-08-05)
See these [`0.15.x` to `0.16.0` upgrade instructions](https://gist.github.com/chrismccord/969d75d1562979a3ae37) to bring your existing apps up to speed.
- Enhancements
- [Brunch] No longer ship with `sass-brunch` dependency
- [Endpoint] Add `force_ssl` support
- [Mix] Allow `phoenix.gen.*` tasks templates to be customized by the target application by placing copies at `priv/template/phoenix.gen.*`
- [Mix] Support `mix phoenix.gen.model Comment comment post_id:references:posts`
- [Mix] Add `mix phoenix.gen.secret`
- [Router] Provide `put_secure_browser_headers/2` and use it by default in the browser pipeline
- [Socket] Automatically check origins on socket transports
- [Token] Add `Phoenix.Token` for easy signing and verification of tokens
- Bug fixes
- [Cowboy] Ensure we print proper URL when starting the server with both http and https
- [Digest] Do not gzip binary files like png and jpg. Default only to known text files and make them configurable via `config :phoenix, :gzippable_exts, ~w(.txt .html .js .css)` and so on
- Backward incompatible changes
- [Controller] `jsonp/3` function has been removed in favor of the `plug :allow_jsonp`
- [Controller] `controller_template/1` has been renamed to `view_template/1`
- [HTML] Use `phoenix_html ~> 2.0` which includes its own `phoenix_html.js` version
- [Socket] `:origins` transport option has been renamed to `:check_origin`
- [View] `render_one` and `render_many` no longer inflect the view module from the model in favor of explicitly passing the view
- JavaScript client backwards incompatible changes
- Socket params are now passed to `socket.connect()` instead of an option on the constructor.
- Socket params are no longer merged as default params for channel params. Use `connect/2` on the server to wire up default channel assigns.
- Socket `chan` has been renamed to `channel`, for example `socket.channel("some:topic")`
## v0.15.0 (2015-07-27)
See these [`0.14.x` to `0.15.0` upgrade instructions](https://gist.github.com/chrismccord/931373940f320bf41a50) to bring your existing apps up to speed.
- Enhancements
- [Socket] Introduce `Phoenix.Socket` behaviour that allows socket authentication, termination, and default channel socket assigns
- [PubSub] Use ETS dispatch table for increased broadcast performance
- [Channel] Use event intercept for increased broadcast performance
- Backward incompatible changes
- [Router] channel routes are now defined on a socket handler module instead of the Router
- [Router] `socket` mounts have been moved from the Router to the Endpoint
- [Channel] `handle_out` callbacks now require explicit event intercept for callback to be invoked, with `Phoenix.Channel.intercept/1`
- [Transports] WebSocket and LongPoll transport configuration has been moved from mix config to the UserSocket
- JavaScript client backwards incompatible changes
- `Phoenix.LongPoller` has been renamed to `Phoenix.LongPoll`
- A new client version is required to accommodate server changes
## v0.14.0 (2015-06-29)
See these [`0.13.x` to `0.14.0` upgrade instructions](https://gist.github.com/chrismccord/57805158f463d3369103) to bring your existing apps up to speed.
- Enhancements
- [Phoenix.HTML] Update to phoenix_html 1.1.0 which raises on missing assigns
- [Controller] Add `jsonp/2` for handling JSONP responses
- [Channel] Enhance logging with join information
- [Router] Add `forward` macro to forward a requests to a Plug, invoking the pipeline
- Javascript client enhancements
- Add socket params to apply default, overridable params to all channel params.
- Enchance logging
- Bug fixes
- [Channel] Fix xdomain content type not being treated as JSON requests
- Javascript client backwords incompatible changes
- `logger` option to `Phoenix.Socket`, now uses three arguments, ie: `logger: (kind, msg, data) => { console.log(`${kind}: ${msg}`, data) }`
- Backward incompatible changes
- [Controller] `plug :action` is now called automatically
- [Endpoint] The `:format` option in `:render_errors` has been renamed to `:default_format`
- [PubSub.Redis] The Redis PubSub adapter has been extracted into its own project. If using redis, see the [project's readme](https://github.com/phoenixframework/phoenix_pubsub_redis) for instructions
- [View] The default template `web/templates/layout/application.html.eex` has been renamed to `app.html.eex`
ShipLog gives you a hosted changelog page with RSS, an in-app widget and a feedback board. After you sign up and create a project, we offer to import these releases. Free for one project with 10 changelog entries.
Create your free account:router given to use Phoenix.VerifiedRoutes is not a compile time literal (#6806) nil host handling in endpoint configuration and transport phx.gen.release --docker pipe_throught (#6755) No release notes.
See these 1.1.x to 1.2.x upgrade instructions to bring your existing apps up to speed.
Enhancements
lib/ directory is now code reloaded by default along with web/ in development :phoenix_channel_join instrumentation hook render_template/2 clauses for views to allow overriding render/2 clauses before rendering templates :path and :pattern options to allow wildcard template inclusion as well as customized template directory locations Deprecations
[Endpoint] Generated subscribe/3 and unsubscribe/2 clauses have been deprecated in favor of subscribe/2 and unsubscribe/1 which uses the caller's pid
[PubSub] Phoenix.PubSub.subscribe/3 and Phoenix.PubSub.unsubscribe/2 have been deprecated in favor of subscribe/2 and unsubscribe/1 which uses the caller's pid
[Watcher] Using the :root endpoint configuration for watchers is deprecated. Pass the :cd option at the end of your watcher argument list in config/dev.exs. For example:
watchers: [node: ["node_modules/brunch/bin/brunch", "watch", "--stdin",
cd: Path.expand("../", __DIR__)]]
Bug Fixes
template_not_found JavaScript client enhancements
JavaScript client backward incompatible changes
Presence.syncState and Presence.syncDiff now return a copy of the state instead of mutating it
See these 1.1.x to 1.2.x upgrade instructions to bring your existing apps up to speed.
Enhancements
:path and :pattern options to allow wildcard template inclusion as well as customized template directory locations Deprecations
[Watcher] Using the :root endpoint configuration for watchers is deprecated. Pass the :cd option at the end of your watcher argument list in config/dev.exs. For example:
watchers: [node: ["node_modules/brunch/bin/brunch", "watch", "--stdin",
cd: Path.expand("../", __DIR__)]]
See these 1.1.x to 1.2.0 upgrade instructions to bring your existing apps up to speed.
lib/ directory is now code reloaded by default along with web/ in development subscribe/2 and unsubscribe/2 to handle external topic subscriptions for a socket render_template/2 clauses for views to allow overriding render/2 clauses before rendering templates :phoenix_channel_join instrumentation hook subscribe/3 and unsubscribe/2 clauses have been deprecated in favor of subscribe/2 and unsubscribe/1 which uses the caller's pid Phoenix.PubSub.subscribe/3 and Phoenix.PubSub.unsubscribe/2 have been deprecated in favor of subscribe/2 and unsubscribe/1 which uses the caller's pid --binary-id option when generating scaffold --no-ecto is passed setTimeout scoping issue for Babel
See these optional 1.1.1 to 1.1.2 upgrade instructions to bring your existing apps up to speed.
refute_push and refute_reply phoenix and phoenix_html js deps --no-html flag on phoenix.new task failing to generate ErrorHelpers module
See these 1.0.x to 1.1.0 upgrade instructions to bring your existing apps up to speed.
match macro phoenix.digest task now digests asset urls in stylesheets automatically Phoenix.Channel.reply/3 to reply asynchronously to a channel push code_change/3 is now supported to upgrade channel servers check_origin now supports wildcard hosts, ie check_origin: ["//*.example.com"] check_origin treats invalid origin hosts as missing for misbehaving clients Phoenix.Endpoint.server?/2 to check if webserver has been configured to start assert_error_sent to assert an error was wrapped and sent with a given status @inner assign has been removed in favor of explicit rendering with render/3 and the new @view_module and view_template assigns, for example: <%= @inner %> is replaced by <%= render @view_module, @view_template, assigns %> bypass_through to pass a connection through a Router and pipelines while bypassing route dispatch. pipe_through :params option of the Socket constructor --database mongodb when generating new apps binary_id and migration configuration for models mix phoenix.routes No release notes.
No release notes.
connect/2 helper for test UserSocket handlers struct_url/0 in the endpoint that returns the URL as struct for further manipulation URI structs to be given to generated url/1 and path/2 helpers pipe_through not respecting halting when piping through mulitple pipelines
See these 0.16.x to 0.17.0 upgrade instructions to bring your existing apps up to speed.
check_origin and force_ssl to be config in transports and fallback to endpoint config check_origin fails render_errors: [default_format: "html"] is deprecated in favor of render_errors: [accepts: ["html"]] get_format/1 to access the negotiated format. subscribe_and_join. For example, subscribe_and_join(MyChannel, "my_topic") should now become socket() |> subscribe_and_join(MyChannel, "my_topic") or socket("user:id", %{user_id: 13}) |> subscribe_and_join(MyChannel, "my_topic").
See these 0.15.x to 0.16.0 upgrade instructions to bring your existing apps up to speed.
sass-brunch dependency force_ssl support phoenix.gen.* tasks templates to be customized by the target application by placing copies at priv/template/phoenix.gen.* mix phoenix.gen.model Comment comment post_id:references:posts mix phoenix.gen.secret put_secure_browser_headers/2 and use it by default in the browser pipeline Phoenix.Token for easy signing and verification of tokens config :phoenix, :gzippable_exts, ~w(.txt .html .js .css) and so on jsonp/3 function has been removed in favor of the plug :allow_jsonp controller_template/1 has been renamed to view_template/1 phoenix_html ~> 2.0 which includes its own phoenix_html.js version :origins transport option has been renamed to :check_origin render_one and render_many no longer inflect the view module from the model in favor of explicitly passing the view socket.connect() instead of an option on the constructor. connect/2 on the server to wire up default channel assigns. chan has been renamed to channel, for example socket.channel("some:topic")
See these 0.14.x to 0.15.0 upgrade instructions to bring your existing apps up to speed.
Phoenix.Socket behaviour that allows socket authentication, termination, and default channel socket assigns socket mounts have been moved from the Router to the Endpoint handle_out callbacks now require explicit event intercept for callback to be invoked, with Phoenix.Channel.intercept/1 Phoenix.LongPoller has been renamed to Phoenix.LongPoll
See these 0.13.x to 0.14.0 upgrade instructions to bring your existing apps up to speed.
jsonp/2 for handling JSONP responses forward macro to forward a requests to a Plug, invoking the pipeline logger option to Phoenix.Socket, now uses three arguments, ie: logger: (kind, msg, data) => { console.log(${kind}: ${msg}, data) } plug :action is now called automatically :format option in :render_errors has been renamed to :default_format web/templates/layout/application.html.eex has been renamed to app.html.eex