/gitlab-viewer

An iOS client for gitlab built with SwiftUI

Primary LanguageSwiftMIT LicenseMIT

Gitlab Viewer

An iOS app which lists the groups, projects and merge requests for a gitlab instance by accepting a configurable base url and auth token.

I wanted to try out SwiftUI on a demo project, and I have to use Gitlab everyday at my day job. So I thought let's try building a Gitlab client.

And I have to say, it's a lot of fun building with SwiftUI, the views are so composable.

The current flow of the app is as follows:

  • List all Groups you have access to
    • Show all Projects in that group with pagination support
      • Show All the Merge Requests in that project

Why host a gitlab client on github 😅?

This GitHub profile contains most of my public code, so it made sense to me to open source on GitHub instead of Gitlab.

Configuration

  • Do a git clone of this repo

  • Create a .gitlab-configs.yml file in the root of this project, with these keys

    BASE_URL: <insert_your_gitlab_instance_base_url_with_api_v4_appended> AUTH_TOKEN: <insert_your_personal_access_token>

    A run script in the Gitlab Viewer target will try to read from .gitlab-configs.yml file and copy the credentials to the build directory's Gitlab_configs.plist

  • Build and run the app

Requirements

  • Built with Xcode 11.4
  • Minimum deployment target is iOS 13.0