A step-by-step path from a fresh checkout to a working GraphQL query against the example schema. Each page builds on the last; reach the end with a query like customers { firstName address { address district } } returning real Sakila rows over HTTP.
The tutorial anchors on graphitron-sakila-example, the rewrite’s runnable reference application. You do not write a new project from scratch; you build, run, and query the example, then read the schema to see how each query was made possible by a directive.
Pages
-
Prerequisites: tools, repository checkout, PostgreSQL with the example data, and starting the Quarkus dev server.
-
The starter schema: how
@tableand@fieldmap a GraphQL type to a PostgreSQL table. -
Running your first query: send a GraphQL query and see PostgreSQL rows in the response.
-
Joining tables with
@reference: add a relatedAddressto eachCustomerwith a foreign-key path. -
A first mutation: insert a new row with
@mutation, and read back the columns the GraphQL response asks for. -
Going further: four how-to recipes most relevant after this tutorial, plus the reference and explanation chapters.
Time budget: about an hour, mostly waiting for the first Maven build to finish.
Before you start
If you are evaluating Graphitron rather than learning it, the Quick start page covers the same ground in one screen. The tutorial is for the case where you want to type the commands yourself, see real responses, and build up the directive vocabulary one page at a time.