From fbcb4113f110a7db9cf21d18510cb59c2e90ba23 Mon Sep 17 00:00:00 2001 From: Christian Cleberg Date: Sun, 2 Aug 2026 15:29:33 -0500 Subject: convert readme to nfo; convert docs to txt; relicense to 0bsd --- README.md | 99 --------------------------------------------------------------- 1 file changed, 99 deletions(-) delete mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md deleted file mode 100644 index 20a912d..0000000 --- a/README.md +++ /dev/null @@ -1,99 +0,0 @@ -# Hutch -iOS client for SourceHut. - -[![builds.sr.ht status](https://builds.sr.ht/~ccleberg/Hutch.svg)](https://builds.sr.ht/~ccleberg/Hutch?) -[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=krazywarez_hutch&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=krazywarez_hutch) -[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=krazywarez_hutch&metric=reliability_rating)](https://sonarcloud.io/summary/new_code?id=krazywarez_hutch) - -[![App Store Badge](https://krz.sh/storebutton.svg)](https://apps.apple.com/us/app/hutch-for-sourcehut/id6760742299) - -## Overview - -Hutch is a native SwiftUI app for browsing and managing SourceHut services on iPhone and iPad. It uses SourceHut's GraphQL APIs and stores your personal access token in the iOS keychain. - -The app currently includes: - -- Home dashboard with assigned tickets, recent builds, and projects -- Repository browsing for Git and Mercurial repositories -- Repository details including README, references, commits, diffs, files, artifacts, and settings -- Artifact upload and deletion on release tags -- Tracker and ticket browsing, ticket detail views, and tracker creation -- Ticket editing and deletion, with subscriptions for tickets and trackers -- Build job browsing, build detail views, and build submission -- Inbox and mailing list reading flows -- Patchset review: cover letters, per-patch diffs, checks, version chains, and status changes -- Mailing list creation, settings, and deletion -- Paste browsing, creation, and detail views -- Profile and account settings, including SSH keys, PGP keys, personal access token management, and the audit log -- Email preferences for todo.sr.ht and lists.sr.ht -- Deep links for repositories, tickets, and build jobs - -Some SourceHut services are still browser-only from within Hutch. Unsupported areas currently open in Safari instead of rendering in-app. - -## Requirements - -- Xcode with current iOS SDK support -- iOS Simulator or physical iOS device -- A SourceHut account -- A SourceHut personal access token - -## Getting Started - -1. Clone the repository: - - ```sh - git clone https://git.sr.ht/~ccleberg/Hutch - ``` - -2. Open the project in Xcode. -3. Build and run the app on a simulator or device. -4. On first launch, create or paste a SourceHut personal access token. - -You can create a token at: - -- `https://meta.sr.ht/oauth2/personal-token` - -## Using Hutch - -After signing in with a valid token, Hutch presents five primary areas: - -- `Home`: dashboard for projects, assigned tickets, recent builds, and inbox access -- `Repositories`: browse, search, create, and manage repositories -- `Tickets`: browse trackers, create trackers, and view ticket details -- `Builds`: inspect build jobs and submit new builds -- `More`: lists, pastes, settings, and external links for unsupported services - -Authentication notes: - -- Hutch validates the token against `meta.sr.ht` before saving it -- The token is stored in the iOS keychain -- `Reset App Data` removes saved token data, caches, cookies, and local web data from the device - -## Development - -The project is an Xcode app with tests under `HutchTests`. - -Typical workflow: - -1. Open the workspace or project in Xcode. -2. Select the Hutch app scheme. -3. Build the app. -4. Run the test plan in `Hutch/HutchTests.xctestplan`. - -## Contributing - -Contributions are welcome. Keep changes scoped, include tests when behavior changes, and open a pull request with a clear summary of the user-facing impact. - -Hutch is hosted on both [GitHub](https://github.com/krazywarez/hutch) and [sourcehut](https://sr.ht/~ccleberg/Hutch), which are kept in sync. Report issues or send patches on whichever you prefer — GitHub issues and pull requests, or the [todo.sr.ht tracker](https://todo.sr.ht/~ccleberg/hutch) and [`git send-email`](https://git-send-email.io/). - -## Security - -If you discover a security issue, see [SECURITY.md](SECURITY.md). - -## License - -This project is licensed under the GPL 3.0 or later. See [LICENSE](LICENSE). - -## Contact - -Questions or feedback: root@krz.sh -- cgit v1.2.3