app-name-compliance

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

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.

2. 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.

3. 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.

4. 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: <exact actionable step> — `file:line` — Guideline 2.3.7

### 🟠 HIGH — Very likely rejection
- [ ] TODO: <exact actionable step> — 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

2. 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

3. 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

4. Report

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