brminnick / dotnetgraphql

A sample demonstrating how to create a GraphQL Backend in .NET using `GraphQL-Dotnet` and consume it from a .NET mobile app created using Xamarin

GraphQL in .NET

If you're new to GraphQL, check out these videos featured in the Learn More section, below

• Learning GraphQL Series
• Xamarin + GraphQL
• On .NET Show, Channel 9
  • Introduction to GraphQL
  • Creating a GraphQL Backend in C#
  • Consuming GraphQL in C#

To run this sample, follow the Getting Started Instructions, below.

This app was featured at GraphQL Summit 2019.

Video Recordings

Consuming GraphQL in C#

This session on GraphQL + C# was delivered at GraphQL Summit 2019. It demonstrates how to create a GraphQL Backend in C# and connect it to a client-side mobile app written in C# using Xamarin.

Xamarin + GraphQL

The session on Xamarin + GraphQL was delivered at Xamarin Developer Summit 2019. It demonstrates how to create a Xamarin app in C# and connect it to an existing GraphQL Backend.

Learning GraphQL Series

This special series teaches the basics of GraphQL, how to interact with an existing GraphQL endpoint, how to create your first GraphQL Server, and how to deploy your GraphQL Server to the cloud using Azure!

On .NET Show

In this series, we cover how to create an end-to-end soolution, creating GraphQL Backend in C# and connecting to it from a C# client.

• Introduction to GraphQL
• Creating a GraphQL Backend in C#
• Consuming GraphQL in C#

App Architecture

GraphQL Backend

The GraphQL backend is created in C# using the GraphQL NuGet Package.

GraphiQL

Mobile

The mobile app is created in C# using Xamarin and the GraphQL.Client NuGet Package.

Xamarin.iOS	Xamarin.Android

Getting Started

This app requires us to run the GraphQL API using the terminal while using Visual Studio to build/deploy the Xamarin.iOS and/or Xamarin.Android app.

1. Run the GraphQL API

1. Open the terminal
2. In the terminal, clone this solution by entering the following command:
   • Note: If you have already downloaded the solution, skip this step

git clone https://github.com/brminnick/dotnetgraphql.git

3. In the terminal, navigate to the DotNetGraphQL.API folder by entering the following command:

• On Windows

cd [path to DotNetGraphQL folder]\Source\DotNetGraphQL.API\

• On macOS

cd [path to DotNetGraphQL folder]/Source/DotNetGraphQL.API/

4. In the terminal, run DotNetGraphQL.API.csproj by entering the following command:

dotnet run

5. Open a web browser
6. In the web browser, navgiate to http://localhost:4000
7. Confirm GraphiQL

2. Run the Xamarin.Android App

1. In Visual Studio, open DotNetGraphQL/Source/DotNetGraphQL.sln
2. In Visual Studio, in the Solution Explorer, right-click on DotNetGraphQL.Android
3. In the right-click menu, select Set as Startup Project
4. In Visual Studio, build/deploy DotNetGraphQL.Android to an Android device
5. Confirm the list of dogs from the GraphQL API appears

Learn More

Learn more about Xamarin + GraphQL

Docs

Xamarin Resources

• Getting Started with Xamarin
• Getting Started with Xamarin.Forms
• Install Visual Studio (PC) + Xamarin
• Install Visual Studio for Mac + Xamarin
• Microsoft Learn: Build Mobile Apps With Xamarin.Forms
• Xamarin Source Code
  • Xamarin.iOS
  • Xamarin.Android
  • Xamarin.Forms
  • Mono

GraphQL Resources

• GraphQL.org
• Using Postman with GraphQL API
• GraphQL for .NET
• GraphQL vs REST
• GraphQL vs OData
• Awesome GraphQL

dotnetgraphql's Issues

Screenshots