Skillget

itsyconnect-macos

mcp
SUMMARY

Better App Store Connect

README.md

Itsyconnect

Better App Store Connect.

License CI Electron Next.js 16 SQLite macOS 11+ Downloads

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.

App overview Store listing
Screenshots TestFlight builds
Analytics Customer reviews

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.

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.

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. Respects diff mode when enabled. 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

git clone https://github.com/nickustinov/itsyconnect-macos.git
cd itsyconnect-macos
npm install
npm run electron:dev

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.

docker run -d -p 3000:3000 -v itsyconnect-data:/app/data ghcr.io/nickustinov/itsyconnect:latest

Or with docker compose:

docker compose up -d

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.

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):

itsyconnect.example.com {
    basicauth {
        admin $2a$14$... # caddy hash-password
    }
    reverse_proxy localhost:3000
}

Generate a password hash with caddy hash-password, then paste it into the Caddyfile.

Nginx:

server {
    listen 443 ssl;
    server_name itsyconnect.example.com;

    auth_basic "Itsyconnect";
    auth_basic_user_file /etc/nginx/.htpasswd;

    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

Generate credentials with htpasswd -c /etc/nginx/.htpasswd admin.

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 /app/data volume. Back up this directory to preserve your configuration and cached analytics.

Development

npm run electron:dev          # Launch Electron with hot reload
npm run electron:make:dmg     # Build signed DMG (direct distribution)
npm run electron:make:mas     # Build for Mac App Store (MAS=1)
npm run test                  # Run tests
npm run test:watch            # Watch mode
npm run test:coverage         # Coverage report
npm run db:generate           # Generate Drizzle migration
npm run db:studio             # Drizzle Studio
npm run lint                  # ESLint

MAS builds

The MAS=1 environment variable switches the app from LemonSqueezy to StoreKit for the Pro upgrade. It is set automatically by the electron:make:mas script.

To test MAS mode during development:

MAS=1 npm run electron:dev

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
MAS=1 Switch to StoreKit IAP, disable auto-updater, use MAS entitlements. Set automatically by electron:make:mas.
MAS_DEV=1 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
provisioning.dev.provisionprofile macOS App Development Local testing (MAS_DEV=1)
provisioning.dist.provisionprofile Mac App Distribution App Store submission

Create both in the Apple Developer portal under Provisioning Profiles, selecting the com.itsyconnect.app App ID and the matching certificate.

Building and testing MAS locally

# Build with dev signing (runs locally)
MAS_DEV=1 npm run electron:make:mas

# Open the built app
open out/Itsyconnect-darwin-arm64/Itsyconnect.app

Building for App Store submission

# Build with distribution signing
npm run electron:make:mas

# Submit via Transporter or altool
xcrun altool --upload-app -f out/make/*.pkg -u [email protected]

Testing the StoreKit API locally

While running MAS=1 npm run electron:dev, you can simulate StoreKit activations via curl:

# Activate (simulates a successful purchase)
curl -X POST http://127.0.0.1:3000/api/license/storekit \
  -H "Content-Type: application/json" \
  -d '{"transactionId": "test-txn-123"}'

# Check licence status
curl http://127.0.0.1:3000/api/license

# Deactivate
curl -X DELETE http://127.0.0.1:3000/api/license/storekit

Testing real StoreKit purchases

Real purchases require a signed MAS build and an Apple sandbox tester:

  1. Register the product com.itsyconnect.app.pro (non-consumable) in App Store Connect
  2. Create a sandbox tester under Users and Access → Sandbox
  3. Build with MAS_DEV=1 npm run electron:make:mas
  4. Run the signed build, sign into the sandbox account when prompted, then purchase

Architecture

Electron app
├── electron/main.ts      → main process (Keychain, server, window)
├── electron/preload.ts   → minimal context bridge (no FS access)
├── src/proxy.ts          → request interception (replaces middleware.ts)
├── src/app/api/*         → REST API routes (Next.js 16)
├── src/lib/asc/*         → App Store Connect API client
├── src/lib/ai/*          → AI prompt templates and streaming
├── src/db/*              → Drizzle ORM + SQLite (WAL mode)
└── ~/Library/Application Support/Itsyconnect/
    ├── itsyconnect.db    → SQLite database
    └── master-key.enc    → Keychain-encrypted master key

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

Releasing a new version

Direct distribution

The app auto-updates via update.electronjs.org, which reads from public GitHub Releases.

  1. Bump APP_VERSION and BUILD_NUMBER in src/lib/version.ts, and "version" in package.json
  2. Commit and push
  3. Run the release script (builds, signs, notarizes, creates a draft GitHub release):
    [email protected] APPLE_ID_PASSWORD=xxxx-xxxx-xxxx-xxxx APPLE_TEAM_ID=XXXXXXXXXX \
  ./scripts/build-release.sh
  4. Review the draft release on GitHub, edit release notes, then click Publish
  5. update.electronjs.org picks up the new release – existing users are prompted to restart and update

Users can also check manually via Itsyconnect > Check for updates… in the menu bar.

Mac App Store

MAS builds use Apple's distribution signing and skip notarization (Apple reviews MAS apps separately). The auto-updater is disabled – updates go through the App Store.

npm run electron:make:mas

Submit the resulting package via Transporter or xcrun altool.

License

AGPL-3.0

Yorumlar (0)

Sonuc bulunamadi