Asc App Create UI

1---
2name: asc-app-create-ui
3description: Create a new App Store Connect app record via browser automation. Use when there is no public API for app creation and you need an agent to drive the New App form.
4---
5 
6# asc app create (UI automation)
7 
8Use this skill to create a new App Store Connect app by driving the web UI.
9This is opt-in, local-only automation that requires the user to be signed in.
10 
11## Preconditions
12- A browser automation tool is available (Playwright, Cursor browser MCP, or equivalent).
13- User is signed in to App Store Connect (or can complete login + 2FA).
14- The **bundle ID must already be registered** in the Apple Developer portal.
15- Required inputs are known:
16  - app name (max 30 characters)
17  - bundle ID (must exist and be unused by another app)
18  - SKU
19  - platform (iOS, macOS, tvOS, visionOS)
20  - primary language
21  - user access (Full Access or Limited Access)
22 
23## Safety Guardrails
24- Never export or store cookies.
25- Use a visible browser session only.
26- Pause for a final confirmation before clicking "Create" (for standalone scripts).
27- Do not retry the Create action automatically on failure.
28 
29## Workflow
30 
31### 1. Preflight: register bundle ID and verify no existing app
32```bash
33# Register the bundle ID via public API (if not already registered)
34asc bundle-ids create --identifier "com.example.app" --name "My App" --platform IOS
35 
36# Confirm no app record exists yet
37asc apps list --bundle-id "com.example.app" --output json
38```
39 
40### 2. Open App Store Connect
41Navigate to `https://appstoreconnect.apple.com/apps` and ensure the user is signed in.
42 
43### 3. Open the New App form
44The "New App" button (blue "+" icon) opens a **dropdown menu**, not a dialog directly.
45- Click the "New App" button to open the dropdown.
46- Click the "New App" **menu item** inside the dropdown.
47- The creation dialog/modal appears.
48 
49### 4. Fill required fields (in order)
50 
51#### Platform (checkboxes)
52The platforms are **checkboxes** (not radio buttons). Click the checkbox for the desired platform(s):
53- iOS, macOS, tvOS, visionOS
54- Multiple can be selected.
55 
56#### Name (text input)
57- Label: `Name`
58- Max 30 characters.
59 
60#### Primary Language (select/combobox)
61- Label: `Primary Language`
62- Use `select_option` or equivalent with the language label (e.g., `"English (U.S.)"`).
63 
64#### Bundle ID (select/combobox)
65- Label: `Bundle ID`
66- This is a `<select>` dropdown. The options load asynchronously after platform selection.
67- Wait for the dropdown to finish loading (it shows "Loading..." initially).
68- Select by matching the label text which includes both the name and identifier:
69  `"My App - com.example.app"`
70 
71#### SKU (text input)
72- Label: `SKU`
73 
74#### User Access (radio buttons) -- REQUIRED
75- **This field is required.** The Create button stays disabled until one option is selected.
76- Options: `Limited Access` or `Full Access`.
77- These are custom radio buttons with `<span>` overlays.
78- **Known issue:** Accessibility-based clicks may be intercepted by the overlay `<span>`.
79- **Workaround:** Use `scrollIntoView` on the radio element first, then click the radio ref directly. This bypasses the overlay interception.
80 
81### 5. Click Create
82- The "Create" button is disabled until all required fields are filled **and** User Access is selected.
83- After clicking, the button text changes to "Creating" while processing.
84- Wait for navigation to the new app's page (URL pattern: `/apps/<APP_ID>/...`).
85 
86### 6. Verify creation via API
87```bash
88asc apps get --id "APP_ID" --output json --pretty
89# or
90asc apps list --bundle-id "com.example.app" --output json
91```
92 
93### 7. Hand off to post-create setup
94```bash
95asc app-setup info set --app "APP_ID" --primary-locale "en-US"
96asc app-setup categories set --app "APP_ID" --primary GAMES
97asc app-setup availability set --app "APP_ID" --territory "USA,GBR" --available true
98```
99 
100## Known UI Automation Issues
101 
102### "New App" is a dropdown menu, not a direct action
103The first click opens a menu with "New App" and "New App Bundle". You must click the menu item, not just the button.
104 
105### User Access radio buttons have span overlays
106Apple's custom radio buttons wrap the `<input type="radio">` in styled `<span>` elements. Direct ref-based clicks may fail with "click target intercepted". The fix is:
1071. Scroll the radio element into view (`scrollIntoView`).
1082. Click the radio ref directly (not via offset or label click).
109 
110### Bundle ID dropdown loads asynchronously
111After selecting a platform, the Bundle ID dropdown shows "Loading..." and is disabled. Wait for it to become enabled and populated before selecting.
112 
113### browser_fill may not trigger form validation
114Apple's Ember.js forms use custom change handlers. `browser_fill` (atomic set) may not trigger validation. If the Create button stays disabled after filling all fields:
115- Retype the value slowly (character-by-character) in at least one text field.
116- Or click the field, clear it, and type slowly.
117 
118## Failure Handling
119- If any field or button cannot be located, stop and request user help.
120- Capture a screenshot and report the last known step.
121- Do not retry the Create click automatically.
122- On failure, the user should check the browser for validation errors (red outlines, inline messages).
123 
124## Notes
125- This skill is a workaround for a missing public API. Apple's docs explicitly state: "Don't use this API to create new apps; instead, create new apps on the App Store Connect website."
126- UI selectors can change without notice. Prefer role/label/text selectors over CSS.
127- The only manual step should be signing in. Everything else is agent-drivable.
128