Gleam Practice

Use this when creating a new Gleam project, improving an existing one, or implementing with a wisp + mist + gleam_otp + just stack.

Default Workflow

• Start with gleam new and gleam add. Let the solver choose dependencies instead of hand-writing them.
• Proceed TDD-style: explore -> Red -> Green -> Refactor.
• Separate pure logic from state management. Split domain modules from actor/server modules.
• Keep the public API small. Prefer pub opaque type and avoid casually exposing internal constructors or protocol types.
• Treat @external as a last resort. When you do use it, contain it inside a thin adapter module.
• Keep the web layer thin. wisp handlers should focus on decode, call service, encode response.
• Centralize task execution in a justfile, and have CI invoke just ci too.

Project Setup

Use this as the starting point for new Erlang-target projects.