Project

coldbox-graphql

A schema-agnostic ColdBox module that wraps graphql-java to serve a GraphQL API from SDL files you supply. Ships with zero domain schema of its own — it parses your .graphqls files, wires resolvers by convention, and exposes a standard POST /graphql endpoint. Verified end-to-end on both Lucee and BoxLang.

Schema-first

Drop .graphqls files in a directory, point schemaPaths at it — every file is parsed and merged into one schema automatically.

Convention over config

A resolver CFC is only needed for fields with custom logic — everything else falls back to PropertyDataFetcher against a plain struct.

Dual-engine

Fully tested on both Lucee (5.4.8.2) and BoxLang (1.16.0) — schema build, resolver wiring, and a real HTTP round-trip on each.

Custom scalars

Bring your own GraphQLScalarType instances via a customScalarProvider mapping — nothing built in, nothing forced on you.

bashbox install coldbox-graphql

Full installation and engine-specific setup →