https://github.com/gichukipaul/worldexplorer
WorldExplorer is an iOS app built with UIKit and MVVM architecture, integrated with GraphQL using ApolloGraphql. It allows users to explore continents, countries, and country details fetched from the Countries GraphQL API. The app provides a seamless and intuitive user experience for discovering and learning about different countries worldwide.
https://github.com/gichukipaul/worldexplorer
apollographql ci-cd graphql mvvm-architecture swift uikit-framework
Last synced: 3 months ago
JSON representation
WorldExplorer is an iOS app built with UIKit and MVVM architecture, integrated with GraphQL using ApolloGraphql. It allows users to explore continents, countries, and country details fetched from the Countries GraphQL API. The app provides a seamless and intuitive user experience for discovering and learning about different countries worldwide.
- Host: GitHub
- URL: https://github.com/gichukipaul/worldexplorer
- Owner: gichukipaul
- License: mit
- Created: 2023-06-24T21:29:09.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-09-10T19:53:59.000Z (10 months ago)
- Last Synced: 2025-03-24T03:11:33.819Z (3 months ago)
- Topics: apollographql, ci-cd, graphql, mvvm-architecture, swift, uikit-framework
- Language: Swift
- Homepage:
- Size: 1.06 MB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# World Explorer
World Explorer is an iOS app designed with simplicity in mind. It uses UIKit for the UI and follows the MVVM architectural pattern, making it easy to maintain and add features. The app connects to a `GraphQL` API using the `ApolloGraphql` client, enabling users to explore continents, countries, and detailed country information effortlessly. It offers a user-friendly experience, making learning about different countries worldwide fun.
## Features
- View the continents and their information.
- Select a continent to see a list of countries within it.
- Select a country to view detailed information, including its capital, currency, and more.
- It supports both light and dark modes for accessibility and a visually appealing experience.
## Technologies Used
- GraphQL: A query language for APIs that enables efficient data retrieval.
- Apollo GraphQL: A powerful GraphQL client that simplifies network requests and data management.
- UIKit: Apple's native framework for building iOS apps, providing a robust set of UI components.
- MVVM (Model-View-ViewModel) Architecture: A design pattern that separates data management (ViewModel) from the UI (View) and the underlying data structures (Model).
## Getting Started
To run the app locally and explore the continents, countries, and their details, follow these steps:
1. Clone the repository: ` git clone https://github.com/gichukipaul/WorldExplorer.git `
2. Open the project in Xcode.
3. Install any necessary dependencies using Cocoapods or your preferred dependency manager.
4. Build and run the app on the iOS Simulator or a connected iOS device.
## Configuration
The app is configured to fetch data from the following GraphQL endpoint:
- API Endpoint: [https://countries.trevorblades.com/graphql](https://countries.trevorblades.com/graphql)
## Contributing
Contributions are welcome! If you have any suggestions, bug reports, and/or feature requests, please open an issue or submit a pull request.
## License
This project is licensed under the [MIT License](LICENSE).