Build a simple mobile app with Graphql and Flutter

Photo by Claudio Schwarz | @purzlbaum on Unsplash

Graphql is a query language for APIs that gives clients the power to ask for exactly what they need and nothing more, makes it easier to evolve APIs over time, and enables powerful developer tools. It uses one endpoint, and users can structure their query such that they only fetch exactly what they need at a time.

In this article, I have built a mobile app that queries a graphql API and returns a list of continents and countries in the world. You can find the API here =>

For this project, we will utilize the following packages in our app



Create a new flutter project and add these packages to your pubspec.yaml file in the root directory.

Next, create the following folders/files in your lib folder; Models, Queries, Services, UI, Utils, config.dart.

Your lib folder should look like this;

- Models
- Queries
- Services
- UI
- Utils
- config.dart
- main.dart

The next step after creating your folders is to set up graphql, open your config.dart, and paste the following code


Our single endpoint/uri for the project is ‘’, as I said earlier graphql has only one endpoint where all requests are made, unlike rest API which utilizes different uri for different calls.

GraphqlConfiguration class is where our graphql connection is being made, and it has a single method, clientToQuery().

Next is to write your graphql query, if you’re just starting with graphql, you can visit their official site to learn how to write queries and mutations

The query for this project should be in your Queries folder, create a file called queries.dart, and paste the following code.


This is the only query in our app, and it fetches all the continents as well as the countries under them.

After writing your query, paste it on the playground — and run.

Query and response in the graphql playground

You should get a response on the second panel. Create a JSON to dart model class manually from the response under Models/continent_models.dart or use It automatically creates a model class for you in different languages, paste the query response, select dart and copy the result.

Now that you have your model and query file ready, you can now write your service class. Create a file under services called continent_service.dart and paste the following code


The class name is ApiService, and it creates a Graphql client using the clientToQuery method in the GraphQLConfiguration class. Gql is used to parse GraphQL query strings into the standard GraphQL AST. The response returned is a map and your model is mapped from it.

Lastly, we can get to work on our UI, as most of the work is out of the way. I use a future provider to call the endpoint to the ui.


The other views include home.dart where the continents in the world are displayed and countries.dart where countries under each continent are displayed. You can find their files here.

And that’s the end! we have a working app that should look like this.

The finished look of the app

If your app doesn’t look the same, don’t forget to check out the Github repository for the project files to see where you might have gone wrong.

Thank you for taking your time to read it, please feel free to leave comments/questions if any.

Mobile app developer (Flutter and Kotlin), Technical Writer

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store