# phoenixframework/phoenix architecture

> Architecture diagram of the GitHub repository phoenixframework/phoenix, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/phoenixframework/phoenix
- Repository: https://github.com/phoenixframework/phoenix

## Overview

Phoenix is an Elixir web framework, with an accompanying installer that generates Phoenix applications. A typical application request enters through an endpoint and router, then reaches controller behavior; real-time clients use the channel and transport facilities. The repository also provides project scaffolding, code reloading, verified routes, and generators for common application features. The README documents the installer workflow, while several runtime connections are not visible in the sampled excerpts, so those relationships are omitted rather than inferred.

Main entry points: [`installer/lib/mix/tasks/phx.new.ex`](https://github.com/phoenixframework/phoenix/blob/main/installer/lib/mix/tasks/phx.new.ex) (Project Task), [`lib/phoenix/socket/transport.ex`](https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/socket/transport.ex) (Socket Transport), [`priv/static/phoenix.js`](https://github.com/phoenixframework/phoenix/blob/main/priv/static/phoenix.js) (Browser Channels), [`lib/phoenix/endpoint.ex`](https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/endpoint.ex) (Endpoint)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["HTTP Application Runtime"]
  node_endpoint["Endpoint<br/>[endpoint.ex]"]
  node_router["Router<br/>[router.ex]"]
  node_controller["Controller<br/>[controller.ex]"]
  node_controller_pipeline["Controller Pipeline<br/>[pipeline.ex]"]
  node_verified_routes["Verified Routes<br/>[verified_routes.ex]"]
end

subgraph group_realtime["Real-Time Communication"]
  node_socket["Socket<br/>[socket.ex]"]
  node_transport["Socket Transport<br/>[transport.ex]"]
  node_channel_server["Channel Server<br/>[server.ex]"]
  node_presence["Presence<br/>[presence.ex]"]
  node_browser_channels["Browser Channels<br/>[phoenix.js]"]
end

subgraph group_scaffolding["Project Scaffolding"]
  node_installer_task["Project Task<br/>[phx.new.ex]"]
  node_generator["Project Generator<br/>[generator.ex]"]
  node_ecto_generator["Ecto Setup<br/>[phx.new.ecto.ex]"]
  node_web_generator["Web Setup<br/>[phx.new.web.ex]"]
end

subgraph group_developer["Developer Features"]
  node_auth_generator["Auth Generator<br/>[phx.gen.auth.ex]"]
  node_context_generator["Context Generator<br/>[phx.gen.context.ex]"]
  node_html_generator["HTML Generator<br/>[phx.gen.html.ex]"]
  node_json_generator["JSON Generator<br/>[phx.gen.json.ex]"]
  node_live_generator["Live Generator<br/>[phx.gen.live.ex]"]
  node_code_reloader["Code Reloader<br/>[server.ex]"]
  node_digest["Asset Digest<br/>[digester.ex]"]
end

node_user(("Application User"))

node_user -.->|"sends requests"| node_endpoint
node_user -.->|"uses channels"| node_browser_channels
node_browser_channels -.->|"opens transport"| node_transport
node_transport -.->|"dispatches messages"| node_channel_server
node_installer_task -.->|"generates project"| node_generator
node_installer_task -.->|"configures Ecto"| node_ecto_generator
node_installer_task -.->|"configures web"| node_web_generator

click node_endpoint "https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/endpoint.ex"
click node_router "https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/router.ex"
click node_controller "https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/controller.ex"
click node_controller_pipeline "https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/controller/pipeline.ex"
click node_verified_routes "https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/verified_routes.ex"
click node_socket "https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/socket.ex"
click node_transport "https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/socket/transport.ex"
click node_channel_server "https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/channel/server.ex"
click node_presence "https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/presence.ex"
click node_browser_channels "https://github.com/phoenixframework/phoenix/blob/main/priv/static/phoenix.js"
click node_installer_task "https://github.com/phoenixframework/phoenix/blob/main/installer/lib/mix/tasks/phx.new.ex"
click node_generator "https://github.com/phoenixframework/phoenix/blob/main/installer/lib/phx_new/generator.ex"
click node_ecto_generator "https://github.com/phoenixframework/phoenix/blob/main/installer/lib/mix/tasks/phx.new.ecto.ex"
click node_web_generator "https://github.com/phoenixframework/phoenix/blob/main/installer/lib/mix/tasks/phx.new.web.ex"
click node_auth_generator "https://github.com/phoenixframework/phoenix/blob/main/lib/mix/tasks/phx.gen.auth.ex"
click node_context_generator "https://github.com/phoenixframework/phoenix/blob/main/lib/mix/tasks/phx.gen.context.ex"
click node_html_generator "https://github.com/phoenixframework/phoenix/blob/main/lib/mix/tasks/phx.gen.html.ex"
click node_json_generator "https://github.com/phoenixframework/phoenix/blob/main/lib/mix/tasks/phx.gen.json.ex"
click node_live_generator "https://github.com/phoenixframework/phoenix/blob/main/lib/mix/tasks/phx.gen.live.ex"
click node_code_reloader "https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/code_reloader/server.ex"
click node_digest "https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/digester.ex"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_endpoint,node_router,node_controller,node_controller_pipeline,node_verified_routes,node_user toneBlue
class node_socket,node_transport,node_channel_server,node_presence,node_browser_channels toneAmber
class node_installer_task,node_generator,node_ecto_generator,node_web_generator toneMint
class node_auth_generator,node_context_generator,node_html_generator,node_json_generator,node_live_generator,node_code_reloader,node_digest toneRose
```

## Components

### HTTP Application Runtime

- [Endpoint](https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/endpoint.ex): `lib/phoenix/endpoint.ex`
- [Router](https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/router.ex): `lib/phoenix/router.ex`
- [Controller](https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/controller.ex): `lib/phoenix/controller.ex`
- [Controller Pipeline](https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/controller/pipeline.ex): `lib/phoenix/controller/pipeline.ex`
- [Verified Routes](https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/verified_routes.ex): `lib/phoenix/verified_routes.ex`

### Real-Time Communication

- [Socket](https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/socket.ex): `lib/phoenix/socket.ex`
- [Socket Transport](https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/socket/transport.ex): `lib/phoenix/socket/transport.ex`
- [Channel Server](https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/channel/server.ex): `lib/phoenix/channel/server.ex`
- [Presence](https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/presence.ex): `lib/phoenix/presence.ex`
- [Browser Channels](https://github.com/phoenixframework/phoenix/blob/main/priv/static/phoenix.js): `priv/static/phoenix.js`

### Project Scaffolding

- [Project Task](https://github.com/phoenixframework/phoenix/blob/main/installer/lib/mix/tasks/phx.new.ex): `installer/lib/mix/tasks/phx.new.ex`
- [Project Generator](https://github.com/phoenixframework/phoenix/blob/main/installer/lib/phx_new/generator.ex): `installer/lib/phx_new/generator.ex`
- [Ecto Setup](https://github.com/phoenixframework/phoenix/blob/main/installer/lib/mix/tasks/phx.new.ecto.ex): `installer/lib/mix/tasks/phx.new.ecto.ex`
- [Web Setup](https://github.com/phoenixframework/phoenix/blob/main/installer/lib/mix/tasks/phx.new.web.ex): `installer/lib/mix/tasks/phx.new.web.ex`

### Developer Features

- [Auth Generator](https://github.com/phoenixframework/phoenix/blob/main/lib/mix/tasks/phx.gen.auth.ex): `lib/mix/tasks/phx.gen.auth.ex`
- [Context Generator](https://github.com/phoenixframework/phoenix/blob/main/lib/mix/tasks/phx.gen.context.ex): `lib/mix/tasks/phx.gen.context.ex`
- [HTML Generator](https://github.com/phoenixframework/phoenix/blob/main/lib/mix/tasks/phx.gen.html.ex): `lib/mix/tasks/phx.gen.html.ex`
- [JSON Generator](https://github.com/phoenixframework/phoenix/blob/main/lib/mix/tasks/phx.gen.json.ex): `lib/mix/tasks/phx.gen.json.ex`
- [Live Generator](https://github.com/phoenixframework/phoenix/blob/main/lib/mix/tasks/phx.gen.live.ex): `lib/mix/tasks/phx.gen.live.ex`
- [Code Reloader](https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/code_reloader/server.ex): `lib/phoenix/code_reloader/server.ex`
- [Asset Digest](https://github.com/phoenixframework/phoenix/blob/main/lib/phoenix/digester.ex): `lib/phoenix/digester.ex`

### Other components

- **Application User**

## Connections

- Application User → Endpoint: sends requests
- Application User → Browser Channels: uses channels
- Browser Channels → Socket Transport: opens transport
- Socket Transport → Channel Server: dispatches messages
- Project Task → Project Generator: generates project
- Project Task → Ecto Setup: configures Ecto
- Project Task → Web Setup: configures web
