Skip to content

Vitrin 2.0.0

Choose a tag to compare

@github-actions github-actions released this 03 Nov 23:33
· 23 commits to main since this release

Vitrin for Mac becomes an App Store Connect panel, and the asc CLI becomes the one App Store uploader.

Removed

  • Breaking: fastlane deliver. vitrin upload to the App Store runs through the asc CLI only; uploader: deliver in vitrin.config.yaml warns and behaves like asc. Google Play still uses fastlane supply.

Added

  • Vitrin for Mac: every asc command on the page it belongs to, and the live store text in projects. The flat "All commands" list is gone. Each app tab ends with the rest of asc for that place (release and review, store text and declarations, screenshots and product pages, builds, TestFlight, reviews, pricing and purchases, analytics, and a More tab for App Clips, Game Center, marketplace and the like), and the Team section gained Reports & finance, Automation, Apple Ads and Account pages. Every asc command group appears in exactly one place; the app fills in the app and the version being prepared. Only the local tooling stays out (sign-in, docs, local Xcode builds, raw API and schema access, completion, telemetry). A project linked to an app gets an App Store Connect page, a click on an app always opens its App Store Connect page, and the Store text page imports the app's live text from App Store Connect into metadata/listing/ after a confirmation. The new Screenshots tab counts the screenshot sets of the version in App Store Connect.

  • Vitrin for Mac runs asc commands where they belong. An app's Status tab offers what its release state allows: a new version (optionally copying the text of an earlier one), attaching a build, submitting for review, cancelling a submission, releasing an approved version, starting, pausing or finishing a phased release, the version's settings, and the readiness check (asc validate, shown as a list of errors and warnings with what to do). The store text tab edits name and subtitle per language and sets the categories; Builds sends a build to TestFlight groups (with beta review), writes What to Test and expires a build; TestFlight invites and removes testers and creates and deletes groups; Reviews shows the ratings per country and filters unanswered and by stars; Purchases shows the price. A new Team section lists and manages users (invite, remove), devices (register), certificates (revoke), profiles (delete) and bundle IDs (create). Each action is a sheet with its fields, the exact command line and asc's answer; changes ask first, reads run with --read-only.

  • Vitrin for Mac manages App Store Connect through the asc CLI. An app's page has tabs for its release status (asc status: next action, blockers, App Store version, App Review, latest build, TestFlight, phased release), its store text per language and version with the App Store Connect limits (saved with asc localizations update), name and subtitle, builds, TestFlight groups and testers, customer reviews with public replies, and subscriptions and in-app purchases. "All commands" covers everything else: every asc command from asc's own help, its flags as a form with --app filled in, the JSON result as a table. Reads run with --read-only; a change is confirmed first and shows the command line. The connection is optional and comes from the key stored in Vitrin or, without one, from asc's own asc auth login; the app list reads through asc as well. The Visuals and Store text pages no longer push the sidebar off the window when the Claude column is open (capsule tabs that scroll, stage buttons that wrap, a Claude column that narrows first), the log bar keeps its status pill whole, and a project is named after its App Store Connect app.

  • The asc CLI is Vitrin's only App Store uploader; fastlane deliver is gone. vitrin upload sends App Store text with asc metadata push and replaces each selected display type with asc screenshots|video-previews upload --replace; iPhone Duo and the creatives still go through the App Asset Library, and no run overwrites a whole locale any more. doctor --create-version uses asc versions create, vitrin submit uses asc review submit, and the uploader question, select --uploader and the Studio's uploader-unset blocker are gone (vitrin uploader --json keeps its shape and reports only asc). Without an ASC key in Vitrin, asc's own asc auth login is used, for the upload and for Vitrin's API calls (through asc api), and doctor no longer asks for the key. An old upload.uploader: deliver or asset-library still loads, behaves like asc and prints one warning; Google Play keeps using fastlane supply (the Fastfile template, now version 3, has only the Play lane). asc does not upload categories, copyright or review information; set those in App Store Connect.

  • Vitrin for Mac: a welcome tour and the Remote Code family look. The first launch opens a six-step tour in the main window: what Vitrin does, the tools on this Mac (Node.js, the Vitrin CLI, Claude Code, asc or fastlane, ffmpeg, with the install command for each missing one), the App Store Connect key with how to create it (saving it checks it by listing the team's apps), the team's apps with a "link folder" button each and the project folders, the Claude model and the language, and a summary of what is set up. Every step after the tools can be skipped; Help → "Show the Welcome Tour" opens it again. The app now uses the design system Remote Code and Promo Studio share (gradient header and primary button, glass cards on blurred colour blobs, gradient icon badges, status pills), with Vitrin's own amber → coral → pink palette: an Overview page (counts, what waits for you, the projects, every app with its state), badge rows in the sidebar with projects above the apps and the account at the bottom, a gradient hero on an app's page, a Settings window with a badge sidebar and pane headers (Account first while no key is stored, and a Claude pane), and a 360 pt menu bar panel with the counts, what runs, what waits and the apps that need attention.

  • Vitrin for Mac lists the team's App Store Connect apps. With the key from Settings → Account, an "Apps" section at the top of the sidebar shows every app on the team a few seconds after launch: name, bundle id, the newest App Store version and its state as a pill, and a link badge when a local project's vitrin.config.yaml has the same bundle id (clicking such an app opens that project). An app without a project opens a read-only overview — platforms, the newest version and state per platform, SKU, primary language, a button to App Store Connect — and a "Link a project folder" button. Without a key the section points at Settings → Account; the section's refresh button and the toolbar read the list again, as does saving or removing the key. This is step 1 of the management-panel roadmap (apps/VitrinMac/docs).

  • vitrin asc apps [--json]: the team's apps from App Store Connect (GET /v1/apps with the versions included, every page followed), each with id, bundle id, name, SKU, primary locale, its platforms and the newest App Store version per platform with its state. It needs no project: ASC_KEY_ID, ASC_ISSUER_ID and ASC_KEY_PATH in the environment are enough in any folder, and inside a project its .env fills in what the environment does not set. Nothing is written, and the output goes through the CLI's secret masking. Without a key it stops with exit 2 and the variable names.

  • Vitrin for Mac (apps/VitrinMac): a native macOS 15 app (Swift 6, SwiftUI) over the Studio's local API. It adds projects, offers vitrin init, shows the flow with its stages, blockers, next step and Claude's questions, runs stages with a live log, edits the store text with the App Store Connect counters, shows the research tables, screenshots, design samples, the store preview and the App Previews, the review gallery with approve and reject, and the upload checklist (keys by name only, dry-run plan, explicit confirmation, read-back, finalize). A menu bar mode keeps it running when the window closes, and an update check reads the GitHub releases. English and Turkish. Build with xcodegen generate && xcodebuild -scheme VitrinMac build in apps/VitrinMac.

  • Vitrin for Mac, after its first real use: the app no longer crashes when the Claude panel opens (SwiftUI's .inspector re-entered AppKit layout while its hosting view resized; the panel is now a plain side column); a project no longer gets two Studio servers when the sidebar and the page open it at the same time; the Flow page stacks its columns when the window is narrow instead of squeezing the stage rows; the gallery inside the app hides its own decision bar (report.html?embed=app). open -a Vitrin --args --project <folder> adds and opens a project at launch. A Studio started with --token-file stops on its own two seconds after the program that started it is gone (a crash, a force quit), so no server lingers.

  • Vitrin for Mac: one App Store Connect key for every project, a Claude model picker, and a brief you can read. Settings → Account takes the key id, the issuer id and the .p8 once; the .p8 is copied under ~/Library/Application Support/Vitrin/keys/ and the ids next to it, both owner-only (0600), and every Studio the app starts gets them as ASC_KEY_ID, ASC_ISSUER_ID and ASC_KEY_PATH — except for a project whose own .env sets ASC_KEY_ID, which keeps its key. The "missing in .env" blocker now points at that tab. Settings → General (and the Claude column's header) choose the Claude Code model the briefs run with — an alias (fable, opus, sonnet, haiku) or a full name — and each run's row shows the model Claude Code reported. "Read the brief" opens a sheet with the stage's brief (it opened empty and could not be closed: sheet(isPresented:) with an if let inside built the sheet before the state arrived; it is sheet(item:) now, and Escape closes it). The Claude column can be dragged to 320–560 points wide; the toolbar no longer squeezes a "Claude is working" capsule next to its buttons (the column and the log bar say it).

  • vitrin studio: the Claude model is a request field and a config key. POST /api/claude and POST /api/questions/answer take model (an alias or a full name, letters, digits, . _ : -; anything else is 400), passed to Claude Code as --model; without it the Studio uses ui.claudeModel from vitrin.config.yaml, and without that Claude Code's own default.

  • vitrin studio --token-file <path> and vitrin studio --json hand the Studio's URL, port and session token to a program that drives it (the macOS app): the file is written for its owner only (0600) and atomically, and removed when the Studio stops.

  • Vitrin for Mac: asc's commands read as features. Every tab loads what matters by itself (App Review readiness, submission history, store settings, screenshots as images, builds with their groups, TestFlight groups, testers, feedback and crashes, prices with what you keep, weekly insights, Game Center), and the other commands sit in closed cards: what only reads opens in place and runs by itself, asking for a build or a group from a picker when it needs one; what changes something is a button with a short form. No command lines, no JSON.

  • Vitrin for Mac: App Store Connect's codes in words: languages, countries, categories, states, field names, form fields. Commands, with their titles, come from Resources/asc-commands.json; apps/VitrinMac/docs/asc-komutlari.md lists which of asc's 1315 commands could not be run yet.

  • Vitrin for Mac: app icons, from each app's newest build.

  • Vitrin for Mac: Apple Ads connects inside the app: it makes the key pair, shows the public key to paste, takes the three ids (pasting Apple's block fills them) and signs in. asc installs with a button through Homebrew.

  • Vitrin for Mac: when a key's role forbids something, the app says so and walks through getting one, with the form to add it; Analytics starts Apple's reports with a button. Every tab has a sentence on what it is for, and titles and cards have an ⓘ. "More in App Store Connect" is closed until opened.

  • Vitrin for Mac: follows the system language, with the languages of Remote Code: English, German, Spanish, French, Italian, Japanese, Korean, Brazilian Portuguese, Turkish and Simplified Chinese. A system language the app doesn't have falls back to English.

  • Vitrin for Mac: the menu bar panel shows app icons, rejected apps first, and opens an app or Settings in front.

  • Vitrin for Mac: create a new app on App Store Connect, from the sidebar or the overview. Apple only allows this through an Apple Account, so the app signs in with the email, password and two-factor code (the password stays with asc in the keychain) and runs asc web apps create. The same sign-in creates an Admin API key in one step and shows the App Store Connect analytics dashboards for keys that can't read reports.

  • Vitrin for Mac ships as a notarized DMG with a designed window, attached to each release, and as a Homebrew cask (Casks/vitrin.rb). apps/VitrinMac/scripts/build-mac.sh builds it; apps/VitrinMac/docs/RELEASE.md describes the release.

  • Vitrin has a new logo, on the app, the website and the READMEs.

  • Vitrin for Mac: installs the Vitrin CLI with a button, using the plugin's launcher, which verifies the release tarball.

Fixed

  • The Team pages no longer push the window's content off screen. Their header's description had a vertical fixedSize; measured at a zero width it grew a letter per line. It is two lines at most now.
  • The review page no longer reloads in a loop. Reading the review regenerates metadata/report.html, the Studio announced that as a file change, and the page read the review again. The Studio no longer announces the files it derives itself (report.html, store/, review-snapshot.json), and the app redraws the gallery only when its content changed.
  • vitrin asc apps failed on every real account with ASC API 400: createdAt is not a valid field name. App Store Connect does not accept createdAt in fields[appStoreVersions]; the newest version per platform is now the highest version number. With the field gone, the versions were still empty: a sparse fieldset drops every relationship it does not name, so fields[apps] now names appStoreVersions. Checked against a real team (38 apps, all with their versions); the tests pin both rules, since the stubbed API had accepted the broken request.
  • Vitrin for Mac: the project row's arrow no longer touches the icon or sits on the first line.
  • Vitrin for Mac: Settings opens in front of the main window; the apps refresh button lines up with the sidebar's status dots.