Skip to content
Back to search

itsyconnect-macos

Better App Store Connect

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nickustinov--itsyconnect-macos/badge.svg)](/listings/nickustinov--itsyconnect-macos)

HTML

<a href="/listings/nickustinov--itsyconnect-macos"><img src="/api/listings/nickustinov--itsyconnect-macos/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 202 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <h1>Itsyconnect</h1>
  2. <p>
  3. Better App Store Connect.
  4. </p>
  5. <p>
  6. <a href="https://github.com/nickustinov/itsyconnect-macos/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License" /></a>
  7. <a href="https://github.com/nickustinov/itsyconnect-macos/actions"><img src="https://img.shields.io/github/actions/workflow/status/nickustinov/itsyconnect-macos/ci.yml?branch=main" alt="CI" /></a>
  8. <img src="https://img.shields.io/badge/electron-40-9feaf9" alt="Electron" />
  9. <img src="https://img.shields.io/badge/next.js-16-black" alt="Next.js 16" />
  10. <img src="https://img.shields.io/badge/sqlite-WAL-green" alt="SQLite" />
  11. <img src="https://img.shields.io/badge/macOS-11%2B-999" alt="macOS 11+" />
  12. <a href="https://github.com/nickustinov/itsyconnect-macos/releases"><img src="https://img.shields.io/github/downloads/nickustinov/itsyconnect-macos/total" alt="Downloads" /></a>
  13. </p>
  14. ---
  15. 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.
  16. 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.
  17. <table>
  18. <tr>
  19. <td><a href="docs/screenshots/1.webp"><img src="docs/screenshots/1.webp" alt="App overview" /></a></td>
  20. <td><a href="docs/screenshots/2.webp"><img src="docs/screenshots/2.webp" alt="Store listing" /></a></td>
  21. </tr>
  22. <tr>
  23. <td><a href="docs/screenshots/3.webp"><img src="docs/screenshots/3.webp" alt="Screenshots" /></a></td>
  24. <td><a href="docs/screenshots/4.webp"><img src="docs/screenshots/4.webp" alt="TestFlight builds" /></a></td>
  25. </tr>
  26. <tr>
  27. <td><a href="docs/screenshots/5.webp"><img src="docs/screenshots/5.webp" alt="Analytics" /></a></td>
  28. <td><a href="docs/screenshots/6.webp"><img src="docs/screenshots/6.webp" alt="Customer reviews" /></a></td>
  29. </tr>
  30. </table>
  31. ## Features
  32. **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.
  33. **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.
  34. **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.
  35. **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.
  36. **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.
  37. **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.
  38. **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.
  39. **Nominations** – browse, edit, and submit App Store nominations. AI-powered fill generates nomination answers from your app metadata with one click.
  40. **Dark mode** – full light and dark theme support, follows your system appearance or can be set manually.
  41. **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](#self-hosting-with-docker).
  42. **Diff mode** – opt-in setting that accumulates store listing, app details, app review, and keyword changes locally instead of saving to App Store Connect immediately. Review a full before/after diff across all sections and locales, discard individual fields, then push everything in one go.
  43. **MCP server** – optional [Model Context Protocol](https://modelcontextprotocol.io) 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. Respects diff mode when enabled. See [docs/MCP.md](docs/MCP.md).
  44. **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.
  45. ## Free and open source
  46. Itsyconnect is completely free, with no limits – manage as many apps and developer accounts as you like. Every feature is available to everyone, distributed as a direct DMG download. Licensed under [MIT](LICENSE).
  47. ## Download
  48. Most people just want the app. Download the latest release, open the DMG, and drag Itsyconnect into your Applications folder:
  49. **[⬇ Download Itsyconnect](https://github.com/nickustinov/itsyconnect-macos/releases/latest/download/Itsyconnect.dmg)** – macOS 11 or later
  50. The build is signed and notarized by Apple, so it opens without Gatekeeper warnings, and updates itself automatically from then on. On first launch the setup wizard guides you through connecting your App Store Connect credentials. Older builds are on the [releases page](https://github.com/nickustinov/itsyconnect-macos/releases).
  51. ## Build from source
  52. Prefer to compile and run it yourself? Clone the repo and start the dev build:
  53. ```bash
  54. git clone https://github.com/nickustinov/itsyconnect-macos.git
  55. cd itsyconnect-macos
  56. npm install
  57. npm run electron:dev
  58. ```
  59. The setup wizard will guide you through connecting your App Store Connect credentials. See [Development](#development) below for building your own signed DMG.
  60. ## Self-hosting with Docker
  61. Run Itsyconnect as a web app on your local network or server.
  62. ```bash
  63. docker run -d -p 3000:3000 -v itsyconnect-data:/app/data ghcr.io/nickustinov/itsyconnect:latest
  64. ```
  65. Or with docker compose:
  66. ```bash
  67. docker compose up -d
  68. ```
  69. The app will be available at `http://localhost:3000`. A master encryption key is auto-generated and saved to the data volume on first run.
  70. ### Reverse proxy with authentication
  71. 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.
  72. **Caddy** (recommended – automatic HTTPS):
  73. ```
  74. itsyconnect.example.com {
  75. basicauth {
  76. admin $2a$14$... # caddy hash-password
  77. }
  78. reverse_proxy localhost:3000
  79. }
  80. ```
  81. Generate a password hash with `caddy hash-password`, then paste it into the Caddyfile.
  82. **Nginx:**
  83. ```nginx
  84. server {
  85. listen 443 ssl;
  86. server_name itsyconnect.example.com;
  87. auth_basic "Itsyconnect";
  88. auth_basic_user_file /etc/nginx/.htpasswd;
  89. location / {
  90. proxy_pass http://localhost:3000;
  91. proxy_set_header Host $host;
  92. proxy_set_header X-Real-IP $remote_addr;
  93. }
  94. }
  95. ```
  96. Generate credentials with `htpasswd -c /etc/nginx/.htpasswd admin`.
  97. **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.
  98. ### Data persistence
  99. All data (SQLite database, master key) is stored in the `/app/data` volume. Back up this directory to preserve your configuration and cached analytics.
  100. ## Development
  101. ```bash
  102. npm run electron:dev # Launch Electron with hot reload
  103. npm run electron:make:dmg # Build signed DMG
  104. npm run test # Run tests
  105. npm run test:watch # Watch mode
  106. npm run test:coverage # Coverage report
  107. npm run db:generate # Generate Drizzle migration
  108. npm run db:studio # Drizzle Studio
  109. npm run lint # ESLint
  110. ```
  111. ## Architecture
  112. ```
  113. Electron app
  114. ├── electron/main.ts → main process (Keychain, server, window)
  115. ├── electron/preload.ts → minimal context bridge (no FS access)
  116. ├── src/proxy.ts → request interception (replaces middleware.ts)
  117. ├── src/app/api/* → REST API routes (Next.js 16)
  118. ├── src/lib/asc/* → App Store Connect API client
  119. ├── src/lib/ai/* → AI prompt templates and streaming
  120. ├── src/db/* → Drizzle ORM + SQLite (WAL mode)
  121. └── ~/Library/Application Support/Itsyconnect/
  122. ├── itsyconnect.db → SQLite database
  123. └── master-key.enc → Keychain-encrypted master key
  124. ```
  125. **Stack:** Electron 40 · Next.js 16 · React 19 · TypeScript · Tailwind v4 · shadcn/ui · Phosphor Icons · Geist font · SQLite via better-sqlite3 · Drizzle ORM · Recharts · dnd-kit · Zod · Vercel AI SDK · AES-256-GCM envelope encryption · macOS Keychain
  126. ## Releasing a new version
  127. The app auto-updates via [update.electronjs.org](https://update.electronjs.org), which reads from public GitHub Releases.
  128. 1. Bump `APP_VERSION` and `BUILD_NUMBER` in `src/lib/version.ts`, and `"version"` in `package.json`
  129. 2. Commit and push
  130. 3. Run the release script (builds, signs, notarizes, creates a draft GitHub release):
  131. ```bash
  132. APPLE_ID=you@example.com APPLE_ID_PASSWORD=xxxx-xxxx-xxxx-xxxx APPLE_TEAM_ID=XXXXXXXXXX \
  133. ./scripts/build-release.sh
  134. ```
  135. 4. Review the draft release on GitHub, edit release notes, then click **Publish**
  136. 5. `update.electronjs.org` picks up the new release – existing users are prompted to restart and update
  137. Users can also check manually via **Itsyconnect > Check for updates…** in the menu bar.
  138. ## Contributing
  139. Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) for the development setup, project conventions, and how to submit a pull request. For features, open an issue to discuss the idea first; bug reports and small fixes can go straight in.
  140. ## License
  141. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.