https://github.com/zerolabsco/hutch
an ios client for sourcehut
https://github.com/zerolabsco/hutch
app ios sourcehut
Last synced: about 1 month ago
JSON representation
an ios client for sourcehut
- Host: GitHub
- URL: https://github.com/zerolabsco/hutch
- Owner: zerolabsco
- License: gpl-3.0
- Created: 2026-03-16T18:07:02.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-07T02:04:37.000Z (about 1 month ago)
- Last Synced: 2026-05-07T03:31:37.231Z (about 1 month ago)
- Topics: app, ios, sourcehut
- Language: Swift
- Homepage: https://zerolabs.sh/hutch/
- Size: 1.11 MB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- open-source-ios-apps - Hutch
- fucking-open-source-ios-apps - Hutch
README
# Hutch
iOS client for SourceHut.
[](https://builds.sr.ht/~ccleberg/Hutch?)
[](https://sonarcloud.io/summary/new_code?id=zerolabsco_hutch)
[](https://sonarcloud.io/summary/new_code?id=zerolabsco_hutch)
## 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
- Tracker and ticket browsing, ticket detail views, and tracker creation
- Build job browsing, build detail views, and build submission
- Inbox and mailing list reading flows
- Paste browsing, creation, and detail views
- Profile and account settings, including SSH keys, PGP keys, and personal access token management
- 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.
## 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: hello@cleberg.net