# Property listings An estate agency site. The main page lists properties for sale; each listing has its own page with photos, address, price, and details. Listings can be marked as sold without deleting them — they vanish from the public list but the URL still works for anyone who bookmarked it. This is the pattern for any site that's essentially "a list of things with detail pages": properties, products, jobs, courses, events, team members. The mechanics are always the same: 1. Each item is a sub-page with its data in metadata 2. The main page fetches `cross_page_metadata.json` and renders cards from the metadata of all items 3. A `status` field on the metadata controls which items appear in the public list 4. Bulk creation is just a Python loop ## The script ```python import requests import time API = "https://api.uat-beam.page" TOKEN = "" H = {"Authorization": f"Bearer {TOKEN}", "Content-Type": "application/json"} slug = "smith-estate-agency" # 1. Create the project requests.post(f"{API}/projects", headers=H, json={ "slug": slug, "context": "An estate agency in Springfield with residential listings.", }) time.sleep(2) # 2. Brand it — navy and gold, traditional estate agency feel requests.put(f"{API}/projects/{slug}/assets/tailwind-config.js", headers=H, json={ "content": ( 'tailwind.config = { theme: { extend: { ' 'colors: { brand: "#1e3a5f", accent: "#e2a84b" }, ' 'fontFamily: { serif: ["Lora", "serif"] } ' '} } }' ), }) requests.put(f"{API}/projects/{slug}/assets/styles.css", headers=H, json={ "content": "@import url('https://fonts.googleapis.com/css2?family=Lora:wght@400;500;600;700&display=swap');", }) # 3. Bulk-create the listings. In real life this might come from a # spreadsheet, a database, or the user pasting them in. properties = [ { "slug": "123-oak-street", "title": "3 bed semi-detached", "address": "123 Oak Street, Springfield", "price": 250000, "bedrooms": 3, "bathrooms": 2, "sqm": 110, "features": ["South-facing garden", "Off-street parking", "Period features"], }, { "slug": "456-elm-avenue", "title": "4 bed detached with garden", "address": "456 Elm Avenue, Springfield", "price": 375000, "bedrooms": 4, "bathrooms": 3, "sqm": 160, "features": ["Large garden", "Garage", "Recently extended"], }, { "slug": "789-pine-road", "title": "2 bed flat, city centre", "address": "789 Pine Road, Springfield", "price": 145000, "bedrooms": 2, "bathrooms": 1, "sqm": 65, "features": ["Top floor", "Lift", "Walking distance to station"], }, ] for p in properties: # Create the page requests.post(f"{API}/projects/{slug}/pages", headers=H, json={ "slug": p["slug"], "notes": p["title"], }) time.sleep(0.3) # Set its metadata. The "status" field controls visibility. requests.put( f"{API}/projects/{slug}/pages/{p['slug']}/metadata", headers=H, json={ "address": p["address"], "price": p["price"], "bedrooms": p["bedrooms"], "bathrooms": p["bathrooms"], "sqm": p["sqm"], "features": p["features"], "status": "active", }, ) time.sleep(0.3) # 4. The main page reads cross_page_metadata.json and renders cards for active listings. main_html = """ Smith Estate Agency — Springfield Property

Smith Estate Agency

Property specialists in Springfield since 1987

Properties for sale

""" requests.put( f"{API}/projects/{slug}/pages/_root/files/index.html", headers=H, json={"content": main_html}, ) # 5. The detail page template — each listing reads its own metadata. # The __PAGE_SLUG__ placeholder is replaced per-listing in the upload loop. listing_html = """ Property Details — Smith Estate Agency
Smith Estate Agency
""" # Upload the template to each listing page, replacing the base href # placeholder with the actual page slug. for p in properties: requests.put( f"{API}/projects/{slug}/pages/{p['slug']}/files/index.html", headers=H, json={"content": listing_html.replace("__PAGE_SLUG__", p["slug"])}, ) time.sleep(0.2) print(f"Done. Live at https://{slug}.uat-beam.page") ``` ## Marking a listing as sold The metadata's `status` flag controls visibility. Flip it to `sold` and the listing disappears from the main page (because the filter is `p.metadata.status === 'active'`), but the URL still works for anyone who bookmarked it. ```python import requests API = "https://api.uat-beam.page" TOKEN = "" H = {"Authorization": f"Bearer {TOKEN}", "Content-Type": "application/json"} # Read current metadata, modify, write back (PUT replaces the whole object) page = requests.get( f"{API}/projects/smith-estate-agency/pages/123-oak-street", headers=H, ).json() metadata = page["metadata"] metadata["status"] = "sold" metadata["sold_date"] = "2026-04-15" requests.put( f"{API}/projects/smith-estate-agency/pages/123-oak-street/metadata", headers=H, json=metadata, ) ``` You could also extend the listing page HTML to show a big "SOLD" banner when `status === 'sold'`, so people who land on the URL still see something useful. ## Variations - **Add hero photos** for each listing — see `photo-gallery.md`. - **Show listings on a map** instead of a grid — see `map-with-pins.md`. - **Filter by bedrooms/price** with Alpine.js — add `