Graphile Engine enables you to build high-performance easily-extensible GraphQL schemas by combining plugins. PostGraphile builds on Graphile Engine to helps you craft a best practices GraphQL API backed primarily by your PostgreSQL database in record time.
This monorepo contains the main packages that make up the PostGraphile / Graphile Engine suite.
IMPORTANT: this master
branch shows the in-progress development on version
5 of the Graphile suite.
For PostGraphile version 4, see the v4 branch.
Version 4 is still alive and well.
To help us develop this software sustainably under the MIT license, we ask all individuals and businesses that use it to help support its ongoing maintenance and development via sponsorship.
And please give some love to our featured sponsors ๐คฉ:
Chad Furman * |
Storyscript * |
Postlight * |
* Sponsors the entire Graphile suite
Instant lightning-fast GraphQL API backed primarily by your PostgreSQL database. Highly customizable and extensible thanks to incredibly powerful plugin system.
The core of Graphile Engine: a plugin system that enables you to build a GraphQL schema out of plugins with advanced performance capabilities enabled via GraphQL look-ahead functionality.
A selection of graphile-build plugins related to PostgreSQL: schema introspection, generation of fields and types for all tables, computed columns, query procedures, etc - if there's certain features you don't want, simply don't use that plugin!
A collection of helper utilities to make writing graphile-build plugins easier.
Contains the GraphQL schema functionality of PostGraphile, does not contain the web layer.
Parses a GraphQLResolveInfo
object into a tree of the fields that are being
requested to enable optimizations to your GraphQL schema (e.g. we use it in
graphile-build-pg
to determine which fields are required from the SQL
database).
Create highly dynamic SQL in a powerful and flexible manner without opening yourself to SQL injection attacks. (High performance.)
Below is a quick-start, for more detailed instructions, please see the CONTRIBUTING.md documentation in PostGraphile.
yarn
yarn watch
yarn watch
will keep monitoring and compiling the babel files, so open another
terminal to run the tests (Note: your PostgreSQL server must be
configured for logical decoding):
createdb graphileengine_test
export TEST_DATABASE_URL="postgres:///graphileengine_test"
createdb lds_test
export LDS_TEST_DATABASE_URL="postgres:///lds_test"
yarn test
If the above succeeds, you're good to go! If not, please try again after running
yarn install --force
and always feel free to reach out via
our discord chat on the #core-development channel.
If you want to work in a Docker environment you can follow the instructions on the wiki.