summaryrefslogtreecommitdiff
path: root/README.nfo
diff options
context:
space:
mode:
authorChristian Cleberg <[email protected]>2026-08-02 15:29:33 -0500
committerChristian Cleberg <[email protected]>2026-08-02 15:35:23 -0500
commitfbcb4113f110a7db9cf21d18510cb59c2e90ba23 (patch)
tree5a4afda3920f88f61698329c89771bda75fb8ced /README.nfo
parent04fae8d7fb3726b4d1b4c2576ece04766d2afe74 (diff)
downloadhutch-main.tar.gz
hutch-main.tar.bz2
hutch-main.zip
convert readme to nfo; convert docs to txt; relicense to 0bsdHEADmain
Diffstat (limited to 'README.nfo')
-rw-r--r--README.nfo64
1 files changed, 64 insertions, 0 deletions
diff --git a/README.nfo b/README.nfo
new file mode 100644
index 0000000..6534569
--- /dev/null
+++ b/README.nfo
@@ -0,0 +1,64 @@
+┌──────────────────────────────────────────────────────────────┐
+│ H U T C H [ KRZ ] krz.sh │
+└──────────────────────────────────────────────────────────────┘
+
+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://git.sr.ht/~ccleberg/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
+ Hutch/HutchTests.xctestplan.
+
+MIRRORS
+ github: https://github.com/krazywarez/hutch
+ sourcehut: https://sr.ht/~ccleberg/Hutch
+ kept in sync. issues or patches on either.
+
+SECURITY
+ see SECURITY.txt.
+
+LICENSE
+ 0bsd. see LICENSE.
+
+CONTACT
+
+┌──────────────────────────────────────────────────────────────┐
+│ krz.sh │
+└──────────────────────────────────────────────────────────────┘