`apps/mobile/ASC-PASTE-KIT.md`

200 lines

# Homes on Spec — App Store Connect Paste Kit

Bundle ID: `com.abrams.homesonspec` · App name: Homes on Spec · Version: 1.0 · Build to attach: **2**

This file is the single source of truth for the 1.0 App Store listing. Each field below is a
copy-paste block sized to Apple's character limits. Char counts are shown for every
length-capped field. Nothing here calls any Apple API — paste it into App Store Connect by hand.

---

## ✅ TODO for Steve in App Store Connect

Do these in order in the ASC console (appstoreconnect.apple.com → Homes on Spec → 1.0):

- [ ] **Attach build 2** to the 1.0 version (Build section → Select a build → pick build 2). Build 1 was superseded; 2 is the one to ship.
- [ ] **Paste each field** below into its matching ASC field (Name, Subtitle, Promotional Text, Keywords, Description, URLs, category).
- [ ] **Set Primary + Secondary category** (Lifestyle / Business — see below).
- [ ] **Capture + upload screenshots.** None exist yet. ⚠️ **Do NOT use the iOS Simulator — HoS hangs forever on the splash there** (`react-native-maps` native init blocks the React root; JS is clean, works on a real device). **Capture from build 2 on a real device via TestFlight.** Grab the 4 tabs (Browse, Map, Saved, Alerts), upload the required sizes (6.7" iPhone required; 6.5" recommended). See `SCREENSHOT-SHOTLIST.md`.
- [ ] **Confirm the privacy policy page is live** at https://homesonspec.com/privacy (verified 200 OK as of 2026-08-07 — re-check before submit).
- [ ] **Answer the App Privacy questionnaire** — use the "Data Not Collected" posture below.
- [ ] **Set Age Rating** → **DECIDED 2026-08-10: ship 17+ now with build 2.** In the questionnaire answer all content descriptors **None** BUT **"Unrestricted Web Access = Yes"** (Browse's WebView is unscoped) → Apple assigns **17+**. The 4+ path (add a webview domain-lock → new build #3) is intentionally deferred, not done. See ASC-METADATA.md "Optional 4+ fix".
- [ ] **Confirm Export Compliance** — `ITSAppUsesNonExemptEncryption=false` is already in `app.json`; ASC should not prompt, but if it does, answer "No" (standard HTTPS only).
- [ ] **Paste Review Notes** (below) into App Review Information → Notes.
- [ ] **Submit for Review.**

---

## Name (≤30)

```
Homes on Spec
```
**12 / 30**

---

## Subtitle (≤30)

```
New-construction home finder
```
**28 / 30**

---

## Promotional Text (≤170)

Editable any time without a new build — good for seasonal or market messaging.

```
Browse thousands of new-construction and spec homes on a live map. Save the ones you love and get ready for new-listing alerts. No account needed.
```
**146 / 170**

---

## Keywords (≤100, comma-separated, NO spaces)

```
new construction,spec homes,new homes,builder,move-in ready,home search,real estate,map,for sale,new build,houses
```
**110 / 100 — TRIM before pasting.** Suggested 100-char version:

```
new construction,spec homes,new homes,builder,move-in ready,home search,real estate,map,for sale
```
**96 / 100** ✅

---

## Description (≤4000)

```
Homes on Spec is the fastest way to explore brand-new construction and spec homes across the country. Skip the resale clutter and see only newly built and to-be-built homes — the ones going up right now.

BROWSE NEW HOMES
Scroll thousands of new-construction listings pulled straight from builders. Every listing links through to full details: price, location, and construction status.

EXPLORE THE MAP
See new homes plotted on a fast, native map. Pins are color-coded by construction status so you can tell at a glance what is move-in ready, what is under construction, and what is still planned:
- Green: move-in ready
- Orange: under construction
- Indigo: planned
Filter the map to just the status you care about, tap a pin for the price and city, and open the full listing in a tap. Dense areas cluster into a single count bubble that zooms in when you tap it, so even the busiest markets stay smooth.

SAVE HOMES YOU LOVE
Found one worth a second look? Tap Save this Home and it lands in your Saved tab. Your saved list lives right on your phone and stays put between visits — no sign-up, no login, no email required. Open any saved home to jump back to its full details.

NEW-LISTING ALERTS
Turn on alerts to get set up for notifications the moment a new matching home is published. We are rolling delivery out builder by builder — flip the switch now so you are ready when it goes live. Your notification preference stays on your device.

WHY HOMES ON SPEC
- New-construction focused. No resale listings to wade through.
- A real native map, not a slow web page — built to handle the whole country.
- Save homes with zero friction. No account, ever.
- Straightforward and private. We do not ask you to register, and we do not sell your data.

Homes on Spec pairs a fast native experience with the full homesonspec.com catalog, so you get the best of both: an app that feels quick and a listing set that stays current.

Questions or feedback? Reach us any time at homesonspec.com. Happy house hunting.
```
**~1,760 / 4000** (well under; expand later if desired)

---

## Category

- **Primary: Lifestyle** — house-hunting / home-discovery is a consumer lifestyle activity (this is where Zillow, Redfin, and Realtor.com sit); it's a browse-and-save consumer tool, not a professional/agent workflow product, so Lifestyle fits better than Business.
- **Secondary: Business** — reasonable secondary since real-estate discovery has a commercial dimension; leave blank if ASC pushes for a tighter fit.

---

## Support URL

```
https://homesonspec.com
```

## Marketing URL (optional)

```
https://homesonspec.com
```

## Privacy Policy URL

```
https://homesonspec.com/privacy
```
**Status: page returns 200 OK (verified 2026-08-07).** A privacy policy URL is required by App Review — re-confirm it renders real policy text (not a placeholder) before submitting.

---

## Age Rating

```
17+
```
**DECIDED 2026-08-10 — shipping 17+ with build 2 as-is.** All content descriptors are None, but Browse renders `homesonspec.com` in an **unscoped WebView** (no `onShouldStartLoadWithRequest` in `browse.tsx`), so the questionnaire's **"Unrestricted Web Access" must be answered "Yes"** → Apple assigns 17+. This is honest and fine to ship. To earn a legit **4+** later, add the webview domain-lock and cut build #3 (see ASC-METADATA.md "Optional 4+ fix") — deferred for now.

---

## App Privacy questionnaire answer

The app requires **no account** and has **no analytics or tracking SDKs**. Saved homes and the
alert preference are stored **only on the device** (AsyncStorage). The push token, if the user
opts in, is generated on-device and is **not yet transmitted to any server** (backend delivery
is a future step). Location, when granted, is used **only** to center the map on the device and
is never collected or sent off the phone.

**Answer in ASC App Privacy: "Data Not Collected."**

- Data collection: **None** — the app collects no data from this app.
- Tracking: **No** — no tracking, no third-party ad/analytics SDKs, no IDFA.
- Location: used on-device to show nearby homes (`NSLocationWhenInUseUsageDescription` is set); **not collected**, so it is not declared as a collected data type.

If Apple asks about the WebView loading homesonspec.com: the site is first-party content the
app displays; the app itself does not collect or link user data. Keep the answer "Data Not
Collected" unless the website's own analytics ever change that posture (flag to Steve if so).

---

## Export Compliance

```
ITSAppUsesNonExemptEncryption = false
```
Already set in `app.json` → `ios.infoPlist`. The app uses only standard HTTPS (exempt). No
custom or non-exempt encryption. If ASC prompts during submission, answer **"No"** to
"Does your app use non-exempt encryption?"

---

## App Review Information → Notes

```
Homes on Spec is a native iOS app for browsing new-construction / spec homes.

- It is a NATIVE SHELL over homesonspec.com content, not a plain WebView wrapper. Three of the four tabs are fully native:
• Map — native MapKit (react-native-maps) rendering the live homes dataset, color-coded by construction status, with clustering for dense areas.
• Saved — native on-device favorites list (AsyncStorage); no login required.
• Alerts — native push opt-in screen (preference stored on device).
• Browse — displays homesonspec.com listings with native loading, error/retry, and a native "Save this Home" action layered on top.

- NO LOGIN is required anywhere. There is no account system and no test credentials are needed — just launch and use.

- Location permission is optional; the app works fully without it. If granted, it only centers the map. Decline the prompt and everything still works.

- Alerts: enabling the toggle registers a push token on-device. Delivery is not yet wired to a backend, so no notifications are sent in this version — the screen is a working opt-in, clearly labeled as rolling out.

Contact: homesonspec.com
```

---

### Notes for whoever pastes this
- Keywords: use the **96/30-compliant** trimmed version, not the first draft.
- Screenshots are the one true blocker — the app must be run in the Simulator to capture them; there are none on disk yet.
- Everything else here is final copy, ready to paste.