# epam-graphql

**Repository Path**: mirrors_epam/epam-graphql

## Basic Information

- **Project Name**: epam-graphql
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-12-14
- **Last Updated**: 2026-01-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Epam.GraphQL
![Licence](https://img.shields.io/github/license/epam/epam-graphql.svg)

[![codecov](https://codecov.io/gh/epam/epam-graphql/branch/main/graph/badge.svg?token=AD2OM1HLZ4)](https://codecov.io/gh/epam/epam-graphql)
[![Build artifacts](https://github.com/epam/epam-graphql/actions/workflows/build.yml/badge.svg)](https://github.com/epam/epam-graphql/actions/workflows/build.yml)
[![Publish code](https://github.com/epam/epam-graphql/actions/workflows/publish.yml/badge.svg)](https://github.com/epam/epam-graphql/actions/workflows/publish.yml)

![Size](https://img.shields.io/github/repo-size/epam/epam-graphql.svg)
![Activity](https://img.shields.io/github/commit-activity/w/epam/epam-graphql)
![Activity](https://img.shields.io/github/commit-activity/m/epam/epam-graphql)
![Activity](https://img.shields.io/github/commit-activity/y/epam/epam-graphql)

## Overview

**Epam.GraphQL** is a set of .NET libraries which provides a high-level way for building GraphQL APIs with a few lines of code, including (but not limited to) CRUD, batching, complex sorting and filtering, pagination.
We have built **Epam.GraphQL** on top of [GraphQL.NET](https://github.com/graphql-dotnet/graphql-dotnet/) to simplify developing GraphQL API layer:
  * It is used by a dozen internal EPAM applications, battle-tested on complex tasks
  * Highly declarative; can be seen as Low-Code platform done right
  * Serves as architecture backbone for the whole app
  * Makes APIs aligned and metadata-rich – allowing future features like admin UI generation
 
## Features

* Supports EntityFrameworkCore (e.g. querying only necessary fields from the database, disable change tracking when needed)
* Declarative CRUD (but you can write your own manual mutations as well)
* Gracefully solves [N+1 problem](https://medium.com/the-marcy-lab-school/what-is-the-n-1-problem-in-graphql-dd4921cb3c1a) by nested entities query batching with zero boilerplate code (but you can write your batches by yourself)
* [Relay connections](https://relay.dev/graphql/connections.htm) out-of-the-box
* Declarative filtering and search
* Declarative sorting
* Entity auto-mapping
* Master-details relationship between entities with a few lines of code
* Security
* ... and many more

## Documentation

* [Get Started](docs/01-get-started.md)
* [Core Concepts](docs/02-core-concepts.md)
* Querying Data
	* [Resolving Fields](docs/querying/01-resolvers.md)
	* [`FromIQueryable`](docs/querying/02-fromiqueryable.md)
	* [Loaders](docs/querying/03-loaders.md)
	* [Filtering](docs/querying/04-filtering.md)
	* [Sorting](docs/querying/05-sorting.md)
	* [Pagination](docs/querying/06-pagination.md)
	* [N+1 Problem](docs/querying/07-n+1-problem.md)
		* [`FromIQueryable`](docs/querying/07-n+1-problem/01-fromiqueryable.md)
		* [`FromLoader`](docs/querying/07-n+1-problem/02-fromloader.md)
		* [`FromBatch`](docs/querying/07-n+1-problem/03-frombatch.md)
	* [Grouping](docs/querying/08-grouping.md)
* Entity Framework Core Usage
  * [Auto-mapping](docs/ef-core/01-automapping.md)

## Packages

| Package                          | Downloads                                                                                                                                     | NuGet Latest                                                                                                                                 |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Epam.GraphQL                     | [![Nuget](https://img.shields.io/nuget/dt/Epam.GraphQL)](https://www.nuget.org/packages/Epam.GraphQL)                                         | [![Nuget](https://img.shields.io/nuget/v/Epam.GraphQL)](https://www.nuget.org/packages/Epam.GraphQL)                                         |
| Epam.GraphQL.EntityFrameworkCore | [![Nuget](https://img.shields.io/nuget/dt/Epam.GraphQL.EntityFrameworkCore)](https://www.nuget.org/packages/Epam.GraphQL.EntityFrameworkCore) | [![Nuget](https://img.shields.io/nuget/v/Epam.GraphQL.EntityFrameworkCore)](https://www.nuget.org/packages/Epam.GraphQL.EntityFrameworkCore) |
| Epam.GraphQL.MiniProfiler        | [![Nuget](https://img.shields.io/nuget/dt/Epam.GraphQL.MiniProfiler)](https://www.nuget.org/packages/Epam.GraphQL.MiniProfiler)               | [![Nuget](https://img.shields.io/nuget/v/Epam.GraphQL.MiniProfiler)](https://www.nuget.org/packages/Epam.GraphQL.MiniProfiler)               |
| Epam.GraphQL.SystemTextJson      | [![Nuget](https://img.shields.io/nuget/dt/Epam.GraphQL.SystemTextJson)](https://www.nuget.org/packages/Epam.GraphQL.SystemTextJson)           | [![Nuget](https://img.shields.io/nuget/v/Epam.GraphQL.SystemTextJson)](https://www.nuget.org/packages/Epam.GraphQL.SystemTextJson)           |
| Epam.GraphQL.NewtonsoftJson      | [![Nuget](https://img.shields.io/nuget/dt/Epam.GraphQL.NewtonsoftJson)](https://www.nuget.org/packages/Epam.GraphQL.NewtonsoftJson)           | [![Nuget](https://img.shields.io/nuget/v/Epam.GraphQL.NewtonsoftJson)](https://www.nuget.org/packages/Epam.GraphQL.NewtonsoftJson)           |


## License
[MIT](LICENSE.md)