https://notes.burelli.xyz/tags/ecto/Recent content in Ecto on Buro notesHugoen-usSun, 25 Oct 2026 03:36:31 +0100https://notes.burelli.xyz/posts/engineering/elixir/project-setup/Sun, 25 Oct 2026 03:26:27 +0100https://notes.burelli.xyz/posts/engineering/elixir/project-setup/<h1 id="how-i-set-up-an-elixir-project">How I set up an Elixir project</h1> <p>A short checklist for every new Elixir project: the libraries I use and the rules I apply.</p> <h2 id="libraries">Libraries</h2> <ul> <li><strong><a href="https://hexdocs.pm/ecto/Ecto.html" target="_blank" rel="noopener noreferrer">Ecto</a></strong>: database (PostgreSQL).</li> <li><strong><a href="https://hexdocs.pm/phoenix/overview.html" target="_blank" rel="noopener noreferrer">Phoenix</a></strong>: web layer and APIs.</li> <li><strong><a href="https://hexdocs.pm/phoenix_live_view/welcome.html" target="_blank" rel="noopener noreferrer">LiveView</a></strong>: the UI, when possible.</li> <li><strong><a href="https://daisyui.com/components/" target="_blank" rel="noopener noreferrer">daisyUI</a></strong>: UI components on top of Tailwind, when I build the frontend.</li> <li><strong><a href="https://hexdocs.pm/req/readme.html" target="_blank" rel="noopener noreferrer">Req</a> + <a href="https://hexdocs.pm/finch/Finch.html" target="_blank" rel="noopener noreferrer">Finch</a></strong>: HTTP requests. Easy to test: <code>Req.Test</code> mocks the responses.</li> <li><strong><a href="https://hexdocs.pm/swoosh/Swoosh.html" target="_blank" rel="noopener noreferrer">Swoosh</a></strong>: emails, with HTML templates rendered by Phoenix. Easy to test with its test adapter.</li> <li><strong><a href="https://hexdocs.pm/guardian/readme.html" target="_blank" rel="noopener noreferrer">Guardian</a></strong>: authentication.</li> <li><strong><a href="https://hexdocs.pm/open_api_spex/readme.html" target="_blank" rel="noopener noreferrer">OpenApiSpex</a></strong>: OpenAPI spec of the APIs, request validation, Swagger UI.</li> <li><strong><a href="https://hexdocs.pm/oban/Oban.html" target="_blank" rel="noopener noreferrer">Oban</a></strong>: background jobs.</li> <li><strong><a href="https://prom-ex.hexdocs.pm/readme.html" target="_blank" rel="noopener noreferrer">PromEx</a></strong>: Prometheus metrics.</li> </ul> <h2 id="rules">Rules</h2> <ul> <li><strong>Folders by feature</strong>: <a href="https://notes.burelli.xyz/posts/engineering/code-design-and-architecture/organize-by-feature/">Organize code by feature, not by type</a>.</li> <li><strong>Errors</strong>: one <code>Error</code> struct, caught only where you can handle them: <a href="https://notes.burelli.xyz/posts/engineering/code-design-and-architecture/errors/">Errors: model them once, catch them once</a>.</li> <li><strong>Docker</strong>: always containerized. <ul> <li>A Mix release in a multi-stage image (<code>mix phx.gen.release --docker</code>).</li> <li>A health route (e.g. <code>GET /health</code>) for the container health check.</li> <li>Built and labeled in CI following <a href="https://notes.burelli.xyz/posts/engineering/docker-containers/#build-phase">Docker containers management</a>.</li> </ul> </li> </ul>