README.org

v3.12.3
hutch/README.org rendered · source · history · blame · raw

62 lines · 1746 bytes

hutch

what

ios client for sourcehut. native swiftui, iphone and ipad. uses sourcehut's graphql apis. stores your personal access token in the ios keychain.

does

  • home dashboard: assigned tickets, recent builds, projects
  • git and mercurial repo browsing
  • repo details: readme, refs, commits, diffs, files, artifacts, settings
  • artifact upload and deletion on release tags
  • trackers and tickets: browse, create, edit, delete, subscribe
  • builds: browse, detail, submit
  • inbox and mailing list reading
  • patchset review: cover letters, per-patch diffs, checks, version chains, status changes
  • mailing list create, settings, delete
  • pastes: browse, create, detail
  • profile and account settings: ssh keys, pgp keys, token management, audit log
  • email preferences for todo.sr.ht and lists.sr.ht
  • deep links for repos, tickets, build jobs

some sr.ht services are still browser-only and open in safari.

requires

xcode with a current ios sdk, a simulator or device, a sourcehut account, and a personal access token.

build

git clone https://github.com/krazywarez/hutch

open in xcode, build and run. on first launch paste a token. create one at https://meta.sr.ht/oauth2/personal-token.

the token is validated against meta.sr.ht before saving and stored in the keychain. Reset App Data clears the token, caches, cookies, and local web data.

develop

xcode app with tests under HutchTests. run the test plan in HutchTests.xctestplan.

mirrors

github:    https://github.com/krazywarez/hutch
krz.sh:    https://gitbay.org/krz/hutch
kept in sync. issues or patches on either.

security

see SECURITY.txt.

license

0bsd. see LICENSE.

contact

  • root@krz.sh