Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
name: TestFlight
name: App Store upload

# Started by hand (Actions → TestFlight → Run workflow). Archives a signed build and
# uploads it to App Store Connect, where it appears in TestFlight after processing.
# Started by hand (Actions → App Store upload → Run workflow). Archives a signed build and
# uploads it to App Store Connect. After processing it can be submitted for review
# (or handed to TestFlight testers first).
# Signing is cloud-managed by Xcode with an App Store Connect API key, so no
# certificates or profiles are stored here. See docs/decisions/0008-testflight.md.
on:
Expand Down
7 changes: 5 additions & 2 deletions config/project.yml
Original file line number Diff line number Diff line change
Expand Up @@ -14,15 +14,18 @@ packages:
settings:
base:
SWIFT_VERSION: "5.0"
MARKETING_VERSION: "0.1.0"
MARKETING_VERSION: "1.0"
CURRENT_PROJECT_VERSION: "1"
targets:
Cloudroll:
type: application
platform: iOS
sources:
- path: ../src
excludes: ["**/*.js"]
excludes: ["**/*.js", "PrivacyInfo.xcprivacy"]
# Apple's privacy manifest; must ship as a resource at the bundle root.
- path: ../src/PrivacyInfo.xcprivacy
buildPhase: resources
# Injected into the shell page at runtime, so they ship as resources.
- path: ../src/WebView/shell-navigation.js
buildPhase: resources
Expand Down
11 changes: 11 additions & 0 deletions docs/app-store/listing.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,17 @@

Paste into App Store Connect when the app record exists. Field limits are Apple's and are shown in brackets.

## New App dialog (My Apps → + → New App)

| Field | Value |
| --- | --- |
| Platforms | iOS |
| Name | Cloudroll |
| Primary language | English (U.S.) |
| Bundle ID | io.github.keasbeexd.cloudroll (register it first under Certificates, IDs & Profiles → Identifiers, as an explicit App ID; no extra capabilities needed) |
| SKU | cloudroll-ios (internal only, never shown, can't be changed) |
| User access | Full Access |

## App information

| Field | Value |
Expand Down
6 changes: 4 additions & 2 deletions docs/decisions/0008-testflight.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Date: 2026-10-27

## Decision

- A separate, manually started workflow (`.github/workflows/testflight.yml`) archives a Release build and uploads it to App Store Connect. The push workflow keeps building the unsigned IPA for SideStore.
- A separate, manually started workflow (`.github/workflows/app-store-upload.yml`, named `testflight.yml` until 2026-11-13) archives a Release build and uploads it to App Store Connect. The push workflow keeps building the unsigned IPA for SideStore.
- Signing is cloud-managed: `xcodebuild -allowProvisioningUpdates` with an App Store Connect API key creates and renews the distribution certificate and profile. Nothing else is stored in the repository.
- Four repository secrets: `APPLE_TEAM_ID`, `ASC_KEY_ID`, `ASC_ISSUER_ID` and `ASC_KEY_P8` (the contents of the `.p8` file). The key needs the App Manager role.
- The build number is a UTC timestamp (`YYYYMMDDHHMM`), which always increases. The version is typed in when the workflow is started.
Expand All @@ -19,7 +19,9 @@ Date: 2026-10-27
1. Register the bundle ID `io.github.keasbeexd.cloudroll` (Certificates, IDs & Profiles) and create the app in App Store Connect with it.
2. In App Store Connect, Users and Access → Integrations → App Store Connect API, create a team key with the App Manager role. Download the `.p8` once; note the key ID and issuer ID.
3. Add the four secrets under the repository's Settings → Secrets and variables → Actions. The team ID is under Membership details in the developer account.
4. Run Actions → TestFlight → Run workflow.
4. Run Actions → App Store upload → Run workflow.

Version 1.0 is submitted for review straight from the uploaded build, without a TestFlight round (decided 2026-11-13); TestFlight starts with the next update.

## Consequences

Expand Down
4 changes: 3 additions & 1 deletion docs/roadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,9 @@ Cloudroll is free, with every feature included. It's funded by optional donation

## Phase 3: App Store

- [ ] Apple Developer Program enrollment (individual). TestFlight uploads are ready in `.github/workflows/testflight.yml` and need four secrets after enrollment ([0008](decisions/0008-testflight.md))
- [x] Apple Developer Program enrollment (individual)
- [ ] Upload with `.github/workflows/app-store-upload.yml` (needs four secrets, [0008](decisions/0008-testflight.md)); 1.0 goes straight to App Review, TestFlight starts with the next update
- [x] Privacy manifest (`src/PrivacyInfo.xcprivacy`): no tracking, no data collected, reasons for UserDefaults and file attributes
- [x] App Store listing draft, privacy label answers and review notes ([docs/app-store/listing.md](app-store/listing.md))
- [ ] Register the bundle ID `io.github.keasbeexd.cloudroll` (reverse of keasbeexd.github.io, where the site lives; persisted identifiers such as the Keychain services and the PhotoKit edit format keep their `app.cloudroll` prefix)
- [ ] Privacy policy (GitHub Pages) and privacy label ("Data not collected")
Expand Down
36 changes: 36 additions & 0 deletions src/PrivacyInfo.xcprivacy
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<!-- Cloudroll's privacy manifest: no tracking, no data collected (matches the
App Store privacy label), and the reasons for the required-reason APIs it calls. -->
<plist version="1.0">
<dict>
<key>NSPrivacyTracking</key>
<false/>
<key>NSPrivacyTrackingDomains</key>
<array/>
<key>NSPrivacyCollectedDataTypes</key>
<array/>
<key>NSPrivacyAccessedAPITypes</key>
<array>
<!-- Settings, account order and phone-photo matching, read only by the app. -->
<dict>
<key>NSPrivacyAccessedAPIType</key>
<string>NSPrivacyAccessedAPICategoryUserDefaults</string>
<key>NSPrivacyAccessedAPITypeReasons</key>
<array>
<string>CA92.1</string>
</array>
</dict>
<!-- attributesOfItem on video copies in the app's own temporary folder
(BridgeEndpoints.serveFile reads their size for byte ranges). -->
<dict>
<key>NSPrivacyAccessedAPIType</key>
<string>NSPrivacyAccessedAPICategoryFileTimestamp</string>
<key>NSPrivacyAccessedAPITypeReasons</key>
<array>
<string>C617.1</string>
</array>
</dict>
</array>
</dict>
</plist>
Loading