Repository navigation
Releases
Vitrin 2.4.1
Added
- Scheduled rank checks in the Mac app: Settings → Check search ranks runs
vitrin rankevery day or every week while the app is open, for projects measured at least once, and notifies when a term enters or leaves the top 10 or when terms move five places or more. Off by default, since each check adds a file tometadata/rankings/. vitrin rank --jsonreports what changed since the last snapshot.
Vitrin 2.4.0
Vitrin now tells you where a listing stands before it rewrites anything, and the screenshot templates draw on a review of 106 popular App Store galleries.
Added
vitrin audit: a 0–100 score per language from rankings (50), listing (30) and competition (20), never more than the rankings + 30, with a pivot / align / fine verdict, the terms with demand the app misses, the apps that hold the top 10 and the few fixes that matter. It reads what research andvitrin rankmeasured, sends no new requests, and keeps its history inmetadata/audits/. The Studio shows the last one on the Metadata page, and the write brief opens with its fixes.vitrin keywords: volume and difficulty for any terms in any storefront, in any folder, with what the App Store search box suggests for them. Good for sizing an idea before there is a project. Both numbers are estimates, not Apple's search counts, and the suggestion endpoint is undocumented.- Rival ranks:
vitrin rankrecords up to five rivals next to the app and prints who is ahead per term.research.rivalspins App Store ids; otherwise the apps seen most often in the top 10 are followed, even after research is deleted. vitrin pricing: a fair price per country from purchasing power (World Bank data indata/ppp.json), or five tiers, held between a floor and a ceiling. A proposal only: Vitrin does not change prices.- Five style presets:
ink-minimal,sky-dream,zine-collage,retro-sunsetandhorizon-block, all Vitrin's own, each with its spec and category suggestions. - Two archetypes:
fragmentsstacks cropped pieces of real UI as cards with no device, andlockscreendraws a phone at 9:41 with the app's notifications. - Shot and direction options:
captionPlatesets the caption on a solid plate,stepnumbers a flow, andthreadon an art direction runs one line through the whole set, meeting itself at every seam. - The art direction guide lists what the 106 galleries have in common and maps each pattern to a Vitrin setting. No app's screenshots or assets were copied.
Fixed
- The website's Download buttons no longer break around a release: they pointed at
releases/latestwith a versioned file name, so they returned 404 from the moment a new release was published until the site deployed. They now name the release.
Vitrin 2.3.1
Metadata follows how App Store search works, checked against Apple's App Store search page and an ASO guide.
Changed
- The name leads with what the app does until people know the brand: the write brief asks for
Keyword: Brandbelow 10,000 ratings andBrand: keywordabove, and the brand always stays in the name. Below that, a brand-first name gets the infoaso.name-keyword-first. It is about clarity in search results, not a proven ranking gain, so a live app that ranks is not reordered for its own sake. - The keyword score no longer rewards a term nobody searches for: a seed with no results scored 0.35 and could beat a real, crowded term. Demand now fades to 0 below popularity 0.1, and a selected term there gets
keywords.no-demand. - The keyword field is written as single words, each once. The write brief says so, a word used in two terms gets
keywords.word-repeat, and a phrase gets the infokeywords.phrase. Apple allows phrases, so they stay an option. game,gamesandoyuncount as low-value keywords, as Apple advises, and filler words are now caught per language (the,ve). Research no longer suggests competitor name terms with these words either.
Added
- Terms the app can win today: the write brief marks
stretchterms, whose top 10 hold over 100 times the app's ratings, andkeywords.out-of-reachwarns when the name and subtitle hold only those and no field carries a closer term. - More keyword field checks from Apple's page:
keywords.repeats-categoryfor words of the app's category (English locales),keywords.special-charfor#and@. text.keyword-list: a name, subtitle, promotional text or description line that reads like a list of keywords. Promotional text and the description do not rank, so a list gains nothing.- Localization is checked as research:
keywords.no-researchfor a locale without keyword research,research.shared-seedswhen two languages use the same seeds, and the briefs ask for each market's own terms, English ones included where people search in English there. - Ratings: the analyzer detects a native review prompt (
ratings.prompt: StoreKit,in_app_review,expo-store-review,react-native-in-app-review,react-native-store-review). Without one, the write brief tells Claude to mention it to the user once; Vitrin does not change the app. - Screenshot headlines are briefed as what the user gets, not what the feature is called, and
aso-rules.mdsays to judge a metadata change by App Analytics, not by rank alone.
Vitrin 2.3.0
Vitrin for Mac tells you when an app moves through App Review.
Added
- Vitrin for Mac, App Review notifications: it looks at your apps every five minutes while it runs, also in the menu bar, and tells you when one is waiting for review, in review, approved, on the App Store or rejected. Settings → General → App Review status turns it off. With Remote Code 1.7 on the Mac, Remote Code does this instead and reaches your phone too, so a change is told once.
Vitrin 2.2.1
Vitrin for Mac leaves the Dock when its window closes.
Changed
- Vitrin for Mac lives in the menu bar when no window is open: closing the window now removes the Dock icon too, as in Remote Code, and the window, the Dock icon and the menus come back when you open it from the menu bar or from Finder. The Dock icon stays while a window is open or minimized, and always when Settings turns off the menu bar item or "keep in menu bar".
Vitrin 2.2.0
Vitrin for Mac stops waiting for App Store Connect, and finds things.
Added
- Vitrin for Mac, search: the sidebar finds apps (by name, bundle id or SKU), projects and team pages, and long lists on the App Store Connect pages (builds, reviews, testers, users, devices and every other list) have a filter of their own. It ignores case and accents and needs no request.
Changed
- Vitrin for Mac opens from a cache: what the app reads from App Store Connect is kept on disk per account, in
~/Library/Caches/Vitrin/asc(readable only by you, at most 100 MB). Pages open at once and most need no request: states, builds and TestFlight stay good for 15 minutes, store text and reviews for an hour, people, signing and analytics for 6 hours. An older result shows right away and updates behind the page, and a read that fails leaves it in place. Each page says how old it is, with a button that reads it again. A change made through the app or an upload marks everything old; changes made elsewhere show up when those times run out. Removing the key deletes the cache.
Vitrin 2.1.0
Vitrin on your phone, and a Mac app that updates itself.
Removed
- Breaking: Android and Google Play support. Vitrin is now for Apple platforms: iOS, iPadOS, macOS, watchOS, tvOS and visionOS. Gone are the Google Play listing and upload (fastlane supply,
Gemfile,fastlane/Fastfile), Android capture, frames and mockups, the feature graphic and Play icon, and theGOOGLE_PLAY_*andFASTLANE_*keys. Flutter, React Native and Expo projects still work for their iOS side; a native Android project stops with a clear message. Avitrin.config.yamlthat still namesandroidor aplay-*target keeps working: those entries are ignored with one warning, and files an older Vitrin left for Google Play are never reviewed or uploaded.
Added
- Vitrin for Mac updates itself. When a release is newer, the sidebar and Settings → Updates offer Install and Relaunch: the app downloads the DMG, checks its checksum, signature, Team ID and Gatekeeper, swaps itself and opens the new version. The matching CLI follows on the first launch. The update check also runs while the app stays open, and it now compares the app's version: a Mac with a newer CLI than app never heard about a new app. It replaces the Sparkle placeholder.
vitrin hub: a local control API on 127.0.0.1 for programs that run Vitrin for you, with projects, Studios,asc, the App Store Connect key and Apple Account sign-in. It shares its project list and key with Vitrin for Mac, which doesn't need to be running. Seedocs/HUB_API.md.- Vitrin in Remote Code: with Remote Code 1.6.0, a native tab on the iPhone adds projects, runs every stage and manages App Store Connect. Projects added on the phone or on the Mac show up on the other right away.
- The website speaks every language the app does: English, Turkish, German, Spanish, French, Italian, Japanese, Korean, Brazilian Portuguese and Simplified Chinese, each a real page with a language menu.
- Vitrin Studio in a narrow window: below 760 points wide the sidebar becomes a bottom tab strip and the editors stack.
Fixed
- Vitrin for Mac: a failed Studio request no longer closes the app. Any error the Studio answered with, such as a stage that can't start, crashed the app instead of showing a message.
Vitrin 2.0.1
Vitrin for Mac sets itself up with no terminal, and the website is new.
Fixed
- Vitrin for Mac: the welcome tour no longer sends people to a command that fails. It showed
npm install -g @ardasnturk/vitrin, a package that was never published. The same command is gone from Settings.
Added
- Vitrin for Mac installs every missing tool with a click: Node.js, the Vitrin CLI, Claude Code, the asc CLI and ffmpeg, each with its own button, and "Install everything missing" when more than one is missing. It uses Homebrew where the Mac has it. Without Homebrew, Node.js and asc come from their own releases, checked against the published checksums, and ffmpeg comes from the
ffmpeg-staticandffprobe-staticnpm packages, all under the Vitrin folder. The same button replaces the copied commands in Settings, Flow, Upload, the Claude panel and the app page, and the install keeps its progress when you leave the page.
Changed
- New website: the Mac app's amber, coral and pink colors, light and dark themes, a clearer story with fewer sections, and new animations, all of which stop under Reduce Motion. A favicon drawn for small sizes, a web manifest and a new social image (
scripts/site-icons.mjs).
Vitrin 2.0.0
Vitrin for Mac becomes an App Store Connect panel, and the asc CLI becomes the one App Store uploader.
Removed
- Breaking: fastlane deliver.
vitrin uploadto the App Store runs through the asc CLI only;uploader: deliverinvitrin.config.yamlwarns and behaves likeasc. 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 withasc 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--appfilled 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 ownasc 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 uploadsends App Store text withasc metadata pushand replaces each selected display type withasc 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-versionusesasc versions create,vitrin submitusesasc review submit, and the uploader question,select --uploaderand the Studio'suploader-unsetblocker are gone (vitrin uploader --jsonkeeps its shape and reports only asc). Without an ASC key in Vitrin, asc's ownasc auth loginis used, for the upload and for Vitrin's API calls (throughasc api), and doctor no longer asks for the key. An oldupload.uploader: deliverorasset-librarystill 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.yamlhas 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/appswith 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_IDandASC_KEY_PATHin the environment are enough in any folder, and inside a project its.envfills 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, offersvitrin 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 withxcodegen generate && xcodebuild -scheme VitrinMac buildinapps/VitrinMac. -
Vitrin for Mac, after its first real use: the app no longer crashes when the Claude panel opens (SwiftUI's
.inspectorre-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-filestops 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 asASC_KEY_ID,ASC_ISSUER_IDandASC_KEY_PATH— except for a project whose own.envsetsASC_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 anif letinside built the sheet before the state arrived; it issheet(item:)now, and Escape closes it). The Claude column can be dragged to 320–560 points wide; the toolbar no longer squeezes a "Claude i...
Vitrin 1.2.0
Security
- The Studio's Claude runs can no longer reach the user's commands, whatever the prompt lets through. The Claude panel starts
claude -pwithVITRIN_STUDIO_RUN=1, and under that mark the CLI refusesupload,approve,submit,finalize,initandstudiowith exit 1 before they do anything (upload --dry-runstays open: it prints the plan and changes nothing). Before this, the rule lived only in the system prompt and in tool rules that match the command text:vitrin -C . upload --yespassedBash(vitrin:*)without meetingBash(vitrin upload:*). The approval hash gate held either way; now the claim is enforced by the CLI. The run's tool rules are tighter too: nocatoropenin Bash,vitrin -*denied so a global option cannot hide the subcommand, and.env*,*.p8andsecrets/denied to Read (which also covers Edit, Write, Grep and the file commands Claude Code recognizes in Bash).
Fixed
- An upload that fails halfway no longer leaves an App Store Connect set empty. The Asset Library path (iPhone Duo, Custom Product Page and In-App Event creatives,
upload.uploader: asset-library) now reads every file, lists the old placements and uploads and processes every new asset before it deletes anything; the deletes and the placements are a handful of quick calls at the end, and if one of those still fails the error says how many old placements were removed and how many new ones were placed. The classic screenshot and preview sets must still delete first (a set holds at most 10 items), and their error now says the same. Placing the new assets beside the old ones was considered and left out: a placement group's item limit would be exceeded by a full set plus its replacement. - Bounded retries for App Store Connect calls and the pre-signed upload PUTs. 429, 500, 502, 503, 504 and requests that got no response are tried again with exponential backoff (1 s, 2 s, 4 s … up to 30 s), five attempts and two minutes of waiting in all.
Retry-Afteris honoured both as seconds and as an HTTP-date, and only while it fits into that budget; a header the client cannot read falls back to backoff instead of becoming aNaNwait that burnt every attempt at once. A DELETE answered 404 on a repeat counts as done. Every other 4xx is final. - A non-JSON error body (an HTML 502/503 page) no longer surfaces as a
SyntaxError.AscApiErrorandPlayApiErrorkeep the status, the path and the first 300 characters of the body. getAllrefuses a list longer than 20 pages instead of silently returning a prefix, since the callers delete what is not in the list.