Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/0-blu/stiksource
StikSource is a Swift Package for fetching and decoding AltStore-compatible JSON source data from a given URL. It provides a simple API and SwiftUI views to display the decoded data in your app.
https://github.com/0-blu/stiksource
Last synced: 22 days ago
JSON representation
StikSource is a Swift Package for fetching and decoding AltStore-compatible JSON source data from a given URL. It provides a simple API and SwiftUI views to display the decoded data in your app.
- Host: GitHub
- URL: https://github.com/0-blu/stiksource
- Owner: 0-Blu
- License: mit
- Created: 2024-12-11T20:20:53.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2024-12-11T21:24:06.000Z (30 days ago)
- Last Synced: 2024-12-11T21:24:08.314Z (30 days ago)
- Language: Swift
- Homepage:
- Size: 33.2 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# StikSource
**StikSource** is a Swift Package for fetching and decoding **AltStore-compatible JSON source data** from a given URL. It provides a simple API and SwiftUI views to display the decoded data in your app.
## Features
- Fetches and decodes AltStore source JSON.
- Provides a SwiftUI-friendly way to display the source content.
- Allows navigation to view detailed app data.
- Compatible with **iOS 15+** and **macOS 12+**.
- Supports **v1 and v2** sources.
---
## Installation
### Using Swift Package Manager (SPM)
1. Open your Xcode project.
2. Go to **File > Add Packages...**.
3. Enter the repository URL:
```
https://github.com/0-Blu/StikSource.git
```
4. Add the **StikSource** package to your project.
---
## Sample Usage
### SwiftUI Example
Here’s an example of how you can use **StikSource** to fetch and display data from a source URL, with navigation to view app details.
```swift
import SwiftUI
import StikSource
struct ContentView: View {
var body: some View {
StikSourceView(sourceURL: "placeholder")
}
}
@main
struct MyApp: App {
var body: some Scene {
WindowGroup {
ContentView()
}
}
}
```
### Output
This will fetch the data from the provided URL and display:
- **Source Name**
- **List of Apps** with icons, names, and developer information.
- Tapping an app navigates to a **Detail View** showing:
- App Icon
- App Name
- Developer
- Description
- Screenshots
- Additional metadata
- Tint Color
---
## SwiftUI `StikSourceView`
`StikSourceView` is a prebuilt SwiftUI view to display the fetched AltStore source data.
### Parameters
| Parameter | Type | Description |
|---------------|--------------|--------------------------------------|
| `sourceURL` | `String` | The URL of the AltStore JSON source. |
---
## Manual Fetching
If you want more control, you can fetch and decode the source data manually using `StikSourceManager`.
### Example
```swift
import SwiftUI
import StikSource
struct ManualFetchView: View {
@StateObject private var manager = StikSourceManager()
@State private var isLoading = false
let sourceURL = "placeholder"
var body: some View {
NavigationView {
VStack {
if isLoading {
ProgressView("Loading...")
} else if let source = manager.source {
List(source.apps) { app in
NavigationLink(destination: AppDetailView(app: app)) {
HStack {
AsyncImage(url: URL(string: app.iconURL)) { image in
image.resizable()
} placeholder: {
Color.gray.opacity(0.3)
}
.frame(width: 50, height: 50)
.cornerRadius(10)
VStack(alignment: .leading) {
Text(app.name).font(.headline)
Text(app.developerName)
.font(.subheadline)
.foregroundColor(.gray)
}
}
}
}
.navigationTitle(source.name)
} else {
Text("No data available.")
}
}
.task {
isLoading = true
do {
try await manager.fetchSource(from: sourceURL)
isLoading = false
} catch {
print("Failed to fetch data: \(error.localizedDescription)")
isLoading = false
}
}
}
}
}
```
---
## Requirements
- **iOS 15+**
- **macOS 12+**
- Swift 5.5+
---
## License
This package is licensed under the **MIT License**.
Feel free to use and modify it for your projects.
---
## Author
**0-Blu**
[GitHub Profile](https://github.com/0-Blu)