Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/muhammedelsami/swiftui_githubdevelopersapp

Github Developers App is a SwiftUI application that fetches and displays detailed information about GitHub users. Built using MVVM architecture, it allows users to search for developers by username and view their avatar, bio, repositories, and more. The app provides a clean, user-friendly interface with a focus on simplicity and performance.
https://github.com/muhammedelsami/swiftui_githubdevelopersapp

githubapi ios mvvm-architecture rest-api swift swiftui viewmodel

Last synced: about 1 month ago
JSON representation

Host: GitHub
URL: https://github.com/muhammedelsami/swiftui_githubdevelopersapp
Owner: muhammedelsami
License: mit
Created: 2024-08-24T18:29:33.000Z (3 months ago)
Default Branch: main
Last Pushed: 2024-08-24T18:51:56.000Z (3 months ago)
Last Synced: 2024-10-10T22:42:00.478Z (about 1 month ago)
Topics: githubapi, ios, mvvm-architecture, rest-api, swift, swiftui, viewmodel
Language: Swift
Homepage: https://muhammedelsami.com
Size: 71.3 KB
Stars: 3
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# Github Developers App

Github Developers App is a SwiftUI-based application that allows users to search for and view detailed information about GitHub developers. This app is designed with a clean, user-friendly interface and follows the MVVM (Model-View-ViewModel) architecture for better code organization and maintainability.

## Features

- **Search GitHub Users:** Enter a GitHub username to fetch and display detailed information.
- **Developer Details:** View developer details, including avatar, name, bio, location, company, repositories, followers, and more.
- **Responsive UI:** The app features a responsive design that adapts to different screen sizes.
- **Asynchronous Data Loading:** Data is fetched asynchronously to ensure a smooth user experience.

## Screenshots

Screen1 | Screen2 | Screen3
:-------------------------|:-------------------------:|:-------------------------:
![](https://github.com/muhammedelsami/SwiftUI_GithubDevelopersApp/blob/main/Screens/home.jpg) | ![](https://github.com/muhammedelsami/SwiftUI_GithubDevelopersApp/blob/main/Screens/list.jpg) | ![](https://github.com/muhammedelsami/SwiftUI_GithubDevelopersApp/blob/main/Screens/detail.jpg)|

---------------------------------------------------------

## Installation

1. Clone the repository:
```bash
git clone https://github.com/yourusername/github-developers-app.git
```
2. Open the project in Xcode:
```bash
cd github-developers-app
open GithubDevelopers.xcodeproj
```
3. Build and run the app on your simulator or device.

## Usage

- On the home screen, enter a GitHub username.
- Tap on the search button to fetch the developer's details.
- View detailed information, including the developer's avatar, bio, location, repositories, and more.

## Architecture

This app is built using the MVVM (Model-View-ViewModel) architecture, which separates the business logic from the UI components. The `DeveloperDetailViewModel` handles data fetching and formatting, while `DeveloperDetailView` manages the UI presentation.

## Technologies Used

- **SwiftUI:** For building the user interface.
- **Combine:** For reactive data binding.
- **URLSession:** For making network requests to the GitHub API.

## Contributing

Contributions are welcome! Please open an issue or submit a pull request for any improvements or features you'd like to add.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.