nickustinov / itsyconnect-macos
Better App Store Connect
AI Architecture Analysis
This repository is indexed by RepoMind. By analyzing nickustinov/itsyconnect-macos in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Repository Overview (README excerpt)
Crawler viewItsyconnect Better App Store Connect. --- A desktop app and self-hosted web dashboard that replaces Apple's App Store Connect. Edit metadata across all locales at once, manage TestFlight builds and testers, review analytics, respond to customer reviews, and submit nominations – all from a single desktop window. AI translates your descriptions, keywords, review replies, and even screenshots into every language with one click. Everything runs locally. One SQLite database, no cloud, no accounts, no telemetry. Credentials are encrypted with AES-256-GCM and the master key lives in the macOS Keychain. Features **Release management** – edit descriptions, keywords, what's new, promotional text, names, and subtitles for every locale. Pick builds, choose release method (manual, automatic, or scheduled), toggle phased rollout. Save everything in one click. **AI-powered localisation** – translate any field or all fields to one locale or every locale simultaneously. Generate optimised keywords. Draft professional review replies. Translate foreign reviews. Generate appeal text for unfair ratings. Bring your own API key from Anthropic, OpenAI, Google, xAI, Mistral, or DeepSeek. **TestFlight** – manage builds, beta groups, and testers in one interface. Add or remove builds from groups in bulk. Track installs, sessions, and crashes per build. Review tester feedback with device details and screenshots. Mark feedback as done. **Analytics** – impressions, downloads, proceeds, first-time downloads, sessions, crashes, and conversion funnel. Compare periods, break down by territory, track version adoption. Acquisition sources, usage patterns, and crash reports across separate tabs. **Keyword optimisation** – track keyword character budgets per locale and storefront. Detect duplicates between name, subtitle, and keyword fields within a locale and across locales. One-click fix suggestions help maximise coverage and ranking across every market. **Customer reviews** – filter by rating, territory, or response status. Translate foreign-language reviews with one click. Draft replies with AI, automatically matching the reviewer's language. Edit and delete existing responses. **Screenshots** – upload, reorder with drag-and-drop, preview in lightbox, and delete screenshots across all device categories (iPhone, iPad, Mac, Apple TV, Apple Watch, Apple Vision) and locales. Translate screenshots to any locale using Gemini 3 Pro Image – the AI translates marketing text while preserving fonts and layout. Copy base locale screenshots to other locales without translation. Locale picker shows which locales have screenshots at a glance. **Nominations** – browse, edit, and submit App Store nominations. AI-powered fill generates nomination answers from your app metadata with one click. **Dark mode** – full light and dark theme support, follows your system appearance or can be set manually. **Self-hosted Docker** – run Itsyconnect as a web app on your local network or server. One command to start, auto-generated encryption key, persistent SQLite volume. See self-hosting with Docker. **MCP server** – optional Model Context Protocol server lets AI coding tools (Claude Code, Codex, Cursor, OpenCode) manage your app listings directly. Update release notes, translate fields, add locales – all from your terminal. See docs/MCP.md. **Privacy and security** – local-first architecture. All data stays on your Mac in a single SQLite file. Credentials encrypted with AES-256-GCM envelope encryption, master key stored in the macOS Keychain. No cloud, no accounts, no telemetry. Free vs Pro Itsyconnect is free to use with one app and one developer account. A one-time Pro upgrade removes all limits – unlimited apps and accounts. | | Free | Pro | |---|---|---| | Apps | 1 | Unlimited | | Developer accounts | 1 | Unlimited | | All features | Yes | Yes | | Price | Free | One-time purchase | **Direct distribution** – licences are handled via LemonSqueezy (key-based activation). **Mac App Store** – Pro is available as a StoreKit in-app purchase (non-consumable, one-time). Quick start The setup wizard will guide you through connecting your App Store Connect credentials. Self-hosting with Docker Run Itsyconnect as a web app on your local network or server. Or with docker compose: The app will be available at . A master encryption key is auto-generated and saved to the data volume on first run. Reverse proxy with authentication The Docker container has no built-in authentication. If you expose it beyond your local machine, put it behind a reverse proxy with basic auth. **Caddy** (recommended – automatic HTTPS): Generate a password hash with , then paste it into the Caddyfile. **Nginx:** Generate credentials with . **Tailscale** – if you just want access from your own devices without exposing anything to the public internet, put the machine on your tailnet and access it via the Tailscale IP. No auth config needed. Data persistence All data (SQLite database, master key) is stored in the volume. Back up this directory to preserve your configuration and cached analytics. Development MAS builds The environment variable switches the app from LemonSqueezy to StoreKit for the Pro upgrade. It is set automatically by the script. To test MAS mode during development: This shows the StoreKit UI (buy/restore buttons) on the licence page instead of the LemonSqueezy key input. The auto-updater is disabled in MAS mode. Build flags | Flag | Purpose | |---|---| | | Switch to StoreKit IAP, disable auto-updater, use MAS entitlements. Set automatically by . | | | Sign with Apple Development cert + dev provisioning profile (for local testing). Without this, the build uses the 3rd Party Mac Developer Application cert + distribution profile (for App Store submission). | Provisioning profiles Two provisioning profiles are needed in the project root (both gitignored): | File | Type | When to use | |---|---|---| | | macOS App Development |…