`apps/mobile/APP-STORE-LISTING.md`

106 lines

# Homes on Spec — App Store Listing Copy

## App Name
Homes on Spec

## Subtitle (30 chars max)
New Construction Home Search

## Promotional Text (170 chars max)
Discover every new-construction home from every major builder — with a native map of 70,000+ homes and a saved-homes list your browser can't match.

## Description (4000 chars max)

Homes on Spec is the only search platform that shows you every new-construction home from every major builder in one place — verified directly from builder websites, not aggregators.

**What makes the app different from the website:**

SAVED HOMES — NATIVE, NO LOGIN REQUIRED
Save homes you love directly on your device. No account, no email, no sign-up. Your saved list persists across sessions. The website has no equivalent feature for anonymous visitors.

NATIVE MAP — 70,000+ HOMES, PLOTTED LIVE
A native map renders over 70,000 new-construction homes across the country as live markers. Filter by construction status (Move-In Ready, Under Construction, Planned). Tap any marker for price, beds, city, and a one-tap link to the full listing. This is true native performance — not a browser-embedded map.

NEW LISTING ALERTS — PUSH NOTIFICATIONS
Opt in to push notifications for new listings in your market. Get alerted the moment a builder publishes a home matching your search. The website has no notification capability for visitors.

BROWSE WITH NATIVE CHROME
Browse the full HomesOnSpec.com catalog inside a native app shell. The site's navigation chrome is hidden so the content feels app-native. Network errors show a native retry screen — not a browser error page.

**About HomesOnSpec.com**
Every listing is verified from the builder's own website and carries a live verification label and last-verified timestamp. Builder inclusion is never paid placement. New builders and markets are added continuously.

Verified from the source. Every new home. Every builder. One search.

## Keywords (100 chars max, comma-separated)
new homes,new construction,home search,builders,spec homes,real estate,home finder,map search

## Support URL
https://homesonspec.com

## Privacy Policy URL
https://homesonspec.com/privacy

_(Placeholder — create a /privacy page on homesonspec.com before App Review submission)_

## Marketing URL (optional)
https://homesonspec.com

## Category
Primary: Real Estate
Secondary: Lifestyle

## Age Rating
4+ (no user-generated content, no third-party material, no mature content)

## Copyright
2026 Agent Abrams

---

## Guideline 4.2 Defense — Native Value Documentation

Apple Guideline 4.2 states apps should not be "thin wrappers" around websites. This app passes on the strength of **two fully-built, native-only features** — the native Map and Saved Homes — that have no equivalent on the homesonspec.com website. (Push notifications are opt-in scaffolding on a roadmap and are NOT relied on for the 4.2 argument — do not cite them to a reviewer as shipped delivery.)

### 1. Saved Homes (AsyncStorage, native FlatList)
- Anonymous persistent favorites list backed by `@react-native-async-storage/async-storage`
- No account or login required
- Survives app restarts
- Full CRUD: save, remove, clear
- Native FlatList with pull-to-refresh
- In-app modal WebView to view a saved home without leaving the Saved tab
- **The website has no saved-homes feature for anonymous visitors**

### 2. Native Map (react-native-maps, live API data)
- Native MapKit (iOS) map — not a WebView-embedded Leaflet/Mapbox page
- Fetches ~70,000+ markers from GET https://homesonspec.com/api/map
- Color-coded markers by construction status (green = move-in ready, orange = under construction, indigo = planned)
- Filter chips to show only one status tier
- Native callouts with price + city on tap
- Bottom sheet detail panel with one-tap deep-link to full listing
- User location dot (NSLocationWhenInUseUsageDescription set)
- **The website's /map page is a Next.js SSR page served inside a browser; this is a native experience**

### 3. Push Notifications (expo-notifications) — ROADMAP, opt-in scaffolding only
- Permission request flow with native iOS alert
- Local preference persistence (AsyncStorage)
- Settings deep-link when permission denied
- NOT YET DELIVERING: server-side push backend is not built; the Alerts tab is an
opt-in surface that honestly labels new-listing/price-drop/move-in alerts as "Coming soon"
- This feature is NOT part of the 4.2 defense (Map + Saved carry it). It is listed here only
for completeness. Do not describe push as a shipped capability until the backend delivers
at least one end-to-end notification in TestFlight.

### 4. Browse — Native Error Handling + Save Bridge
- Native ActivityIndicator loading state (vs. browser spinner)
- Native retry screen on network error or 5xx (vs. browser error page)
- "Save this Home" floating action button injected on home detail pages
- JS bridge between the WebView and native storage
- CSS injection hides site header/nav for a native-feeling shell

### Reviewer Notes
- To demonstrate native value, please open the Map tab (Tab 3) and Saved tab (Tab 2) first.
- The Map tab loads live data from the production API — an active network connection is required.
- Save a home from the Browse tab, then switch to Saved to see it persisted natively.
- Screenshots submitted with the app should lead with the Map and Saved tabs.