App Name Compliance

Skill: App Name Compliance

Purpose

Detects app name violations including names exceeding 30 characters, beta/alpha labels, Apple trademark terms, and version numbers in the display name, enforcing Guideline 2.3.7.

Apple Guideline

• Primary: 2.3.7 — Performance: Accurate Metadata — App Names
• Related: 2.1, 2.3.1
• Reference: references/guidelines/2-performance.md

Real-World Rejection Cases

• Case: App name "MyApp Beta" submitted — reviewer rejected as incomplete/beta

Source: mobiloud.com/blog/avoid-app-rejected-apple Root cause: 2.1 + 2.3.7 — "beta"/"alpha" in name signals app not ready for App Store — these words in the display name are an explicit rejection trigger

• Case: App name 34 characters — rejected for exceeding 30-character limit

Source: App Store Connect (enforced automatically at metadata submission; Guideline 2.3.7) Root cause: App name must be max 30 characters — App Store Connect enforces this at upload time for the store name, but CFBundleDisplayName violations affect the displayed name on device

Trigger

Invoke on any iOS/macOS project before App Store submission to validate the app display name.

Inputs

| Name | Type | Default | Description | |------|------|---------|-------------| | project_root | path | cwd | iOS/macOS project root | | shared_context | object | nil | Pre-collected context from appstore-full-audit Phase 1 |

Actions

Phase 1: Context Collection

Skip this phase if shared_context is provided.

1. Glob **/Info.plist — locate Info.plist.
2. Glob **/*.pbxproj — locate Xcode project for display name confirmation.

Phase 2: Checks

1. Display name character length

Read Info.plist — extract CFBundleDisplayName value. Count characters — if length > 30 → 🟡 MEDIUM. App Store Connect enforces 30-character limit on the store listing name; the device display name must also be concise.

1. Beta/alpha/test/demo in display name

Grep pattern CFBundleDisplayName in **/Info.plist — extract value. If value contains "beta", "alpha", "test", "demo" (case-insensitive) → 🟡 MEDIUM. These words signal an unreleased/test build and will cause rejection.

1. Apple trademark terms in display name

Grep pattern CFBundleDisplayName in **/Info.plist. If value contains "Apple", "iPhone", "iPad", "iOS", "macOS", "Mac", "iCloud", "Siri", "FaceTime", "AirDrop" → 🟡 MEDIUM. Use of Apple trademark terms in app names is prohibited without explicit permission.

1. Version number pattern in display name

Grep pattern CFBundleName|CFBundleDisplayName in **/Info.plist. If value matches a trailing version number pattern (e.g., "App 2", "MyApp 3.0", "Tool v2") → 🟡 MEDIUM. App names should not include version numbers — use the version field in App Store Connect instead.

Phase 3: Output

Collect all findings from Phase 2 and build the prioritised findings list below. Include file paths and line numbers. Omit tiers with no findings.

Output Format

## App Name Compliance — Findings

### 🔴 CRITICAL — Guaranteed rejection
- [ ] TODO:  — `file:line` — Guideline 2.3.7

### 🟠 HIGH — Very likely rejection
- [ ] TODO:  — Guideline 2.3.7

### 🟡 MEDIUM — Possible rejection
- [ ] TODO: Shorten CFBundleDisplayName to 30 characters or fewer — current name is 34 characters — `Info.plist` — Guideline 2.3.7
- [ ] TODO: Remove "Beta" from CFBundleDisplayName — beta/alpha labels cause rejection — `Info.plist` — Guideline 2.3.7
- [ ] TODO: Remove Apple trademark "iPhone" from app display name — trademark use requires explicit permission — `Info.plist` — Guideline 2.3.7
- [ ] TODO: Remove version number suffix from app display name — use App Store Connect version field instead — `Info.plist` — Guideline 2.3.7

### 🟢 LOW — Best practice
- [ ] TODO: Verify the App Store Connect listing name also matches — it is limited to 30 characters and must be consistent with CFBundleDisplayName

Tools Used

Glob, Grep, Read

Constraints

• Read-only. No file edits.
• No network calls.
• Skip Phase 1 if shared_context is provided by orchestrating agent.
• Works on Swift, Objective-C, React Native, Flutter projects.

Quick Commands

Run these in your project root to check manually:

# Check app display name and length
!find . -name "Info.plist" -not -path "*/Pods/*" | head -1 | xargs plutil -convert json -o - | python3 -c "import sys,json; d=json.load(sys.stdin); name=d.get('CFBundleDisplayName',d.get('CFBundleName','?')); print(f'Name: \"{name}\" ({len(name)} chars, limit: 30)')"

# Check for problematic terms in app name
!find . -name "Info.plist" -not -path "*/Pods/*" | head -1 | xargs plutil -convert json -o - | python3 -c "import sys,json; d=json.load(sys.stdin); name=d.get('CFBundleDisplayName',''); bad=['beta','alpha','test','demo','Apple','iPhone','iPad','iOS']; [print('WARNING: name contains',w) for w in bad if w.lower() in name.lower()]"

Swift Anti-Pattern Reference

examples/swift/QualityPatterns.swift

Detection Steps

1. Find target files

• Glob: **/Info.plist

1. Search for rejection patterns

• Read Info.plist → get CFBundleName and CFBundleDisplayName values
• Check string length ≤ 30 characters
• Check (case-insensitive) for: beta, test, debug, demo, trial, alpha
• Check for trademark terms: Apple, iPhone, iPad, Google, Facebook, WhatsApp, Instagram

1. Determine verdict

• Name length > 30 characters → 🟠 HIGH (Guideline 2.3.1)
• beta/test/debug in name → 🟠 HIGH
• Competitor trademark in name → 🟠 HIGH
• Name ≤ 30 chars, clean, no trademarks → 🟢 pass

1. Report

• Exact CFBundleName and CFBundleDisplayName values with character count
• Fix: Shorten name to ≤ 30 chars; remove status words and trademark terms

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: cruisediary
• Source: cruisediary/apple-app-review-skills
• License: MIT

Install and usage instructions live in the source repository linked above.