Repository navigation
Chio — Beautiful terminal interfaces for Swift.
The first experimental source release of Chio: an opinionated, declarative design and interaction layer over SwiftTUI. Chio means attractive or pretty in Singlish.
Built with Codex assistance and human curation, primarily for personal use. We cannot vouch for production stability. APIs and behavior may change without notice.
This release includes:
- Default, light and btop themes; coherent styles for native SwiftTUI controls, keyboard hints and status bars.
- Searchable lists and checklists, form-field validation presentation, file selection, contextual help, pagination and feedback.
- Markdown with tables, Swift syntax highlighting and opt-in interactive links; passive sparklines with application-supplied samples.
- Runnable dashboard, metrics and review-inbox compositions, a bounded diff-reader prototype, and focused component examples. The showcase includes recordings and three-theme previews.
Install with SwiftPM
Requires Swift 6.4+, with macOS 15+ or Linux. This release retains commit-pinned upstream dependencies. SwiftPM therefore requires a revision dependency for Chio; from: "0.1.0" and exact: "0.1.0" are not supported for this release.
Add these entries to your package's dependencies:
.package(
url: "https://github.com/echoz/Chio.git",
revision: "1bcc08ce23747c8c8b1121e3add3c37951f7b09e" // v0.1.0
),
.package(
url: "https://github.com/SwiftTUI/swift-tui.git",
revision: "2d84ac7083993da2ef52e9d3d30255467efb9553"
),For an application target, add:
.product(name: "Chio", package: "chio"),
.product(name: "SwiftTUI", package: "swift-tui"),Then use import SwiftTUI and import Chio. See the API guide and example commands.
Verification and limits
The release commit passed macOS and Linux CI, including debug/release tests, snapshot captures and all 15 terminal workflows. The published gallery passed browser playback and mobile-layout checks. A separate macOS consumer also resolved, compiled, linked and ran against this revision.
Linux verification covers ordinary glibc builds. Fully static Linux builds remain blocked by upstream dependencies. Some native focus and table styling limits remain; the diff reader is an example prototype, not a public diff API. See the documented boundaries. No prebuilt binaries are included.
Chio is MIT licensed.