GraftQL Manual
Changelog

GalleonQL User Manual

This is the end-user manual for GalleonQL (a GraphQL-focused client). It covers terminology and how to use the app, and does not include developer-facing content (internal specifications or implementation steps).

(Topics are written up progressively. The table of contents follows.)

Table of Contents

  1. What GalleonQL Is (Overview) / Installation and Launch — An overview of GalleonQL and how to install and launch it on each OS (macOS / Windows / Linux), including how to open unsigned binaries.
  2. Key Terms — Environment (a switchable connection profile / orthogonal model) / Collection / Query / add Query · add Child / leaf and branch / environment variables {{...}} and GraphQL variables $id / header cascade / Schema
  3. Importing a Schema — Importing via HTTP introspection, and importing from local files
  4. Browsing the Schema Documentation — The type catalog of an imported schema (browsing and searching types and fields)
  5. Query Builder — Building a query step by step with add Query / add Child, and switching granularity
  6. Registering and Switching Environments — Registering, editing, and switching environments (connection profiles), and configuring environment variables, authentication, and headers
  7. Sending Queries and Reading Responses — Choosing the HTTP method, previewing the final headers, and the classification of results and errors (Network / Authentication / Client / Server / Partial errors)
  8. Exporting / Importing Projects — Exporting and importing on a per-project basis
  9. Project Slots and Plans — Available project slots, buying extra slots, and applying / removing a license
  10. Crash Reporting — Enabling crash / error reporting and using the pre-send confirmation
  11. Usage Analytics — Enabling / disabling anonymous usage analytics (a separate consent from crash reporting)
  12. Changelog — See the GitHub release notes for the changes in each version (this manual carries no body text for it, only an external link)