krz/hutch

an ios client for sourcehut client ios sourcehut swift https://krz.sh/apps/hutch/

Commit 3032c00b1d

3032c00b1db732dae43a260027370ed4cd431c4a

parent: 4dd2bd319f

Unsigned ci/accessibility: success

cmc <hello@cleberg.net> · 2026-08-31 22:39 UTC 

Convert README.nfo to README.org (!5)

Section headings become org headings, indented command blocks become
src blocks, and column-aligned content stays in example blocks.
Also repoints the Xcode resource reference and the CI file check.

Layout: unified · split

Hutch.xcodeproj/project.pbxproj +4 −4
@@ -10,7 +10,7 @@
1010 5BCB2F8D3CB7523D13629488 /* Foundation.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 81B757B59FDC52273ADF0569 /* Foundation.framework */; };
1111 85EF08B88008A7861BC573CD /* AccessibilityUITests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 36512CB22293FDA01F42B239 /* AccessibilityUITests.swift */; };
1212 8B2F89662F69DEB900FC0253 /* LICENSE in Resources */ = {isa = PBXBuildFile; fileRef = 8B2F89632F69DEB900FC0253 /* LICENSE */; };
13 8B2F89672F69DEB900FC0253 /* README.nfo in Resources */ = {isa = PBXBuildFile; fileRef = 8B2F89642F69DEB900FC0253 /* README.nfo */; };
13 8B2F89672F69DEB900FC0253 /* README.org in Resources */ = {isa = PBXBuildFile; fileRef = 8B2F89642F69DEB900FC0253 /* README.org */; };
1414 8B2F89682F69DEB900FC0253 /* SECURITY.txt in Resources */ = {isa = PBXBuildFile; fileRef = 8B2F89652F69DEB900FC0253 /* SECURITY.txt */; };
1515 8B2FA9CD2F7E211800E609E2 /* meta.json in Resources */ = {isa = PBXBuildFile; fileRef = 8B2FA9C82F7E211800E609E2 /* meta.json */; };
1616 8B2FA9CE2F7E211800E609E2 /* hg.json in Resources */ = {isa = PBXBuildFile; fileRef = 8B2FA9C62F7E211800E609E2 /* hg.json */; };
@@ -78,7 +78,7 @@
7878 81B757B59FDC52273ADF0569 /* Foundation.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = Foundation.framework; path = Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS26.0.sdk/System/Library/Frameworks/Foundation.framework; sourceTree = DEVELOPER_DIR; };
7979 8B01C8012F955ACC00FCFB9A /* SyncedProducts.storekit */ = {isa = PBXFileReference; lastKnownFileType = text; path = SyncedProducts.storekit; sourceTree = "<group>"; };
8080 8B2F89632F69DEB900FC0253 /* LICENSE */ = {isa = PBXFileReference; lastKnownFileType = text; path = LICENSE; sourceTree = "<group>"; };
81 8B2F89642F69DEB900FC0253 /* README.nfo */ = {isa = PBXFileReference; lastKnownFileType = text; path = README.nfo; sourceTree = "<group>"; };
81 8B2F89642F69DEB900FC0253 /* README.org */ = {isa = PBXFileReference; lastKnownFileType = text; path = README.org; sourceTree = "<group>"; };
8282 8B2F89652F69DEB900FC0253 /* SECURITY.txt */ = {isa = PBXFileReference; lastKnownFileType = text; path = SECURITY.txt; sourceTree = "<group>"; };
8383 8B2FA9C42F7E211800E609E2 /* builds.json */ = {isa = PBXFileReference; lastKnownFileType = text.json; path = builds.json; sourceTree = "<group>"; };
8484 8B2FA9C52F7E211800E609E2 /* git.json */ = {isa = PBXFileReference; lastKnownFileType = text.json; path = git.json; sourceTree = "<group>"; };
@@ -251,7 +251,7 @@
251251 8BDCA5272F6B76B20066AA29 /* HutchTests.xctestplan */,
252252 8B8182C22F6B742B000AE049 /* HutchTests */,
253253 8B2F89632F69DEB900FC0253 /* LICENSE */,
254 8B2F89642F69DEB900FC0253 /* README.nfo */,
254 8B2F89642F69DEB900FC0253 /* README.org */,
255255 8B2F89652F69DEB900FC0253 /* SECURITY.txt */,
256256 8B4B28D32F6704280045FA19 /* Hutch */,
257257 8BE081F42F80000100000001 /* Shared */,
@@ -461,7 +461,7 @@
461461 buildActionMask = 2147483647;
462462 files = (
463463 8B2F89662F69DEB900FC0253 /* LICENSE in Resources */,
464 8B2F89672F69DEB900FC0253 /* README.nfo in Resources */,
464 8B2F89672F69DEB900FC0253 /* README.org in Resources */,
465465 8B2F89682F69DEB900FC0253 /* SECURITY.txt in Resources */,
466466 8B2FA9CD2F7E211800E609E2 /* meta.json in Resources */,
467467 8B2FA9CE2F7E211800E609E2 /* hg.json in Resources */,
README.nfo deleted −64
@@ -1,64 +0,0 @@
1┌──────────────────────────────────────────────────────────────┐
2│ H U T C H [ KRZ ] krz.sh │
3└──────────────────────────────────────────────────────────────┘
4
5WHAT
6 ios client for sourcehut. native swiftui, iphone and ipad. uses
7 sourcehut's graphql apis. stores your personal access token in the
8 ios keychain.
9
10DOES
11 - home dashboard: assigned tickets, recent builds, projects
12 - git and mercurial repo browsing
13 - repo details: readme, refs, commits, diffs, files, artifacts,
14 settings
15 - artifact upload and deletion on release tags
16 - trackers and tickets: browse, create, edit, delete, subscribe
17 - builds: browse, detail, submit
18 - inbox and mailing list reading
19 - patchset review: cover letters, per-patch diffs, checks, version
20 chains, status changes
21 - mailing list create, settings, delete
22 - pastes: browse, create, detail
23 - profile and account settings: ssh keys, pgp keys, token
24 management, audit log
25 - email preferences for todo.sr.ht and lists.sr.ht
26 - deep links for repos, tickets, build jobs
27
28 some sr.ht services are still browser-only and open in safari.
29
30REQUIRES
31 xcode with a current ios sdk, a simulator or device, a sourcehut
32 account, and a personal access token.
33
34BUILD
35 git clone https://github.com/krazywarez/hutch
36
37 open in xcode, build and run. on first launch paste a token. create
38 one at https://meta.sr.ht/oauth2/personal-token.
39
40 the token is validated against meta.sr.ht before saving and stored
41 in the keychain. Reset App Data clears the token, caches, cookies,
42 and local web data.
43
44DEVELOP
45 xcode app with tests under HutchTests. run the test plan in
46 HutchTests.xctestplan.
47
48MIRRORS
49 github: https://github.com/krazywarez/hutch
50 krz.sh: https://gitbay.org/krz/hutch
51 kept in sync. issues or patches on either.
52
53SECURITY
54 see SECURITY.txt.
55
56LICENSE
57 0bsd. see LICENSE.
58
59CONTACT
60 root@krz.sh
61
62┌──────────────────────────────────────────────────────────────┐
63│ krz.sh │
64└──────────────────────────────────────────────────────────────┘
README.org added +62
@@ -0,0 +1,62 @@
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
builds/swift-ci.yml +1 −1
@@ -71,7 +71,7 @@ tasks:
7171 cd "$HOME/hutch"
7272
7373 test -f "Hutch.xcodeproj/project.pbxproj"
74 test -f "README.nfo"
74 test -f "README.org"
7575
7676 - xcode-project-check: |
7777 set -euo pipefail