Introduction

Apollo iOS is a GraphQL client for iOS, written in Swift.

It allows you to execute queries and mutations against a GraphQL server, and returns results as query-specific Swift types.

This means you don’t have to deal with parsing JSON, or passing around dictionaries and making clients cast values to the right type manually. Instead, the structs returned allow you to access data and navigate relationships using the appropriate native types directly. This also gives you nice features like code completion.

Because the generated types are query-specific, you’re only able to access data you actually specify as part of a query. If you don’t ask for a field, you won’t be able to access the corresponding property. In effect, this means you can now rely on the Swift type checker to make sure errors in data access show up at compile time.

You can conveniently work with your UI code and corresponding GraphQL definitions side by side. Our Xcode integration will even validate your query documents and show errors inline.

Getting Started

Front Page is the iOS version of the simple “Hello World” app that lives on our developer site.

Apollo iOS Quickstart is a collection of sample Xcode projects that make it easy to get started with Apollo iOS.

Learn more

To learn more about Apollo and GraphQL, visit:

Apollo iOS is under active development, and there is plenty to work on, but we want to ensure we’re addressing real needs and prioritize features accordingly. If you’re using or planning to use GraphQL in an iOS app, please get in touch in the #ios channel on our Slack.

The Apollo team builds and maintains a collection of utilities designed to make it easier to use GraphQL across a range of front-end and server technologies. There are similar guides for React, Angular 2, and the core apollo-client JavaScript package that can be used anywhere JavaScript runs.

We’ve chosen to start with a native client for iOS, but we’re excited about bringing Apollo to more platforms in the future. There has been some interest from the community in helping to bring Apollo Android to life faster, so if you’d like to contribute to that effort, please let us know on the #android channel on Slack.

Although this guide focuses on the integration with native iOS apps, the React integration works with React Native on both iOS and Android without changes.

Edit on GitHub