phoenix-conventions/README.md

Phoenix Patterns

Idiomatic Phoenix patterns extracted from the Phoenix source code with verified file:line citations.

Structure

• patterns/ — Phoenix-specific patterns (Endpoint, Router, Controller, Channel, Plug pipeline, Telemetry)
• patterns/deviations.md — Where Phoenix deliberately differs from Elixir core conventions and why
• patterns/comparison.md — Side-by-side Elixir core vs Phoenix patterns
• changelog/ — Daily digest of merged Phoenix PRs with discussion summaries

Philosophy

These rules are derived from what the Phoenix source code actually does, not opinions or blog posts. Every pattern cites specific files and line numbers.

When unsure how to do something in Phoenix, look at how Phoenix itself does it.