README.org

 1#+title: hutch
 2
 3* what
 4ios client for sourcehut. native swiftui, iphone and ipad. uses
 5sourcehut's graphql apis. stores your personal access token in the
 6ios keychain.
 7
 8* does
 9- home dashboard: assigned tickets, recent builds, projects
10- git and mercurial repo browsing
11- repo details: readme, refs, commits, diffs, files, artifacts,
12  settings
13- artifact upload and deletion on release tags
14- trackers and tickets: browse, create, edit, delete, subscribe
15- builds: browse, detail, submit
16- inbox and mailing list reading
17- patchset review: cover letters, per-patch diffs, checks, version
18  chains, status changes
19- mailing list create, settings, delete
20- pastes: browse, create, detail
21- profile and account settings: ssh keys, pgp keys, token
22  management, audit log
23- email preferences for todo.sr.ht and lists.sr.ht
24- deep links for repos, tickets, build jobs
25
26some sr.ht services are still browser-only and open in safari.
27
28* requires
29xcode with a current ios sdk, a simulator or device, a sourcehut
30account, and a personal access token.
31
32* build
33#+begin_src sh
34git clone https://github.com/krazywarez/hutch
35#+end_src
36
37open in xcode, build and run. on first launch paste a token. create
38one at https://meta.sr.ht/oauth2/personal-token.
39
40the token is validated against meta.sr.ht before saving and stored
41in the keychain. Reset App Data clears the token, caches, cookies,
42and local web data.
43
44* develop
45xcode app with tests under HutchTests. run the test plan in
46HutchTests.xctestplan.
47
48* mirrors
49#+begin_example
50github:    https://github.com/krazywarez/hutch
51krz.sh:    https://gitbay.org/krz/hutch
52kept in sync. issues or patches on either.
53#+end_example
54
55* security
56see SECURITY.txt.
57
58* license
590bsd. see LICENSE.
60
61* contact
62- root@krz.sh