gleam-lang/gleam

have `gleam check`, `gleam build` validate the gleam.toml schema

Open

#5,301 opened on Jan 19, 2026

View on GitHub
 (13 comments) (0 reactions) (0 assignees)Rust (960 forks)batch import
help wanted

Repository metrics

Stars
 (21,417 stars)
PR merge metrics
 (Avg merge 10d 19h) (69 merged PRs in 30d)

Description

Currently the inclusion of a spurious field in gleam.toml goes silently unremarked upon.

This caused me some grief just now as I didn't spot that a local dependency list should appear under [dependencies] not above it.

The proposal would be for gleam build to report the presence of unrecognized/unsupported fields in gleam.toml before it tries to build anything, i.e., for gleam build to validate the gleam.toml schema. (As versioned by the Gleam version.)

Contributor guide

Research direction
Investigate how gleam.toml is currently parsed and where schema validation could be added in the gleam build and gleam check commands.
Tech stack
rust
Domain
clitoolingbuild system
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
gleamrusttoml
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
75