Preference Curation
Fine-tune your property search by curating explicit preferences that guide recommendations and search results.
Overview
Section titled “Overview”The My Data page (/my-data) serves as your personal preference center. As you browse properties, the system infers preferences from your behavior—which price ranges you view, bedroom counts you filter for, and areas you explore. You can also explicitly add, confirm, or remove preferences to fine-tune your search results.
Accessing Your Preferences
Section titled “Accessing Your Preferences”Navigate to /my-data from any page. You’ll see:
- Browsing Activity — Session statistics (properties viewed, photos, searches)
- Your Preferences — Curated list of home criteria
- Additional Notes — Freeform text for specific requirements
- Scribe Assistant — Toggle the property recommendation assistant
Managing Preferences
Section titled “Managing Preferences”Adding Preferences
Section titled “Adding Preferences”Click Add Preference to manually specify what you’re looking for:
| Type | Description | Example |
|---|---|---|
| Price Range | Your budget (min-max) | $400,000 – $550,000 |
| Bedrooms | Minimum bedrooms needed | 3+ bedrooms |
| Bathrooms | Minimum bathrooms needed | 2+ bathrooms |
| Location | Preferred city or area | Twin Falls |
| Property Type | Type of home | Single Family, Condo, Land |
| Must-Have Feature | Essential amenity | Pool, Workshop, Mountain View |
| Square Footage | Size requirements | 1,500 – 3,000 sqft |
Preference Badges
Section titled “Preference Badges”Each preference card displays a badge indicating its source:
- Added by you — Preferences you explicitly added
- Confidence % — Inferred preferences with confidence score (future feature)
- Confirmed — Inferred preferences you’ve validated (future feature)
Removing Preferences
Section titled “Removing Preferences”Click the trash icon on any preference card to remove it. The change takes effect immediately.
Additional Notes
Section titled “Additional Notes”Use the freeform text area to describe requirements that don’t fit standard categories:
“Near Lincoln Elementary, needs a workshop for woodworking, must have mountain views, prefer a quiet neighborhood with mature trees”
Features:
- 500 character limit
- Auto-saves as you type (debounced)
- “Saved” indicator confirms your notes are stored
How Preferences Improve Your Experience
Section titled “How Preferences Improve Your Experience”Your curated preferences help in several ways:
- Semantic Search — Natural language queries match properties using text embeddings and your saved criteria
- Scribe Recommendations — The recommendation engine weighs your preferences when suggesting properties
- Agent Matching — When you connect with an agent, they see your preferences
- Email Alerts — Listing alerts can be filtered by your preferences (future feature)
Privacy
Section titled “Privacy”- All preference data is stored anonymously (session-based)
- No personal information is collected unless you choose to contact an agent
- You can clear all data anytime using Clear All Data
- Read the full Privacy Policy
Technical Details
Section titled “Technical Details”API Endpoints
Section titled “API Endpoints”| Action | Method | Endpoint |
|---|---|---|
| Get preferences | GET | /api/v1/sessions/scribe-status |
| Add preference | POST | /api/v1/sessions/preferences |
| Delete preference | DELETE | /api/v1/sessions/preferences/{type}/{key} |
| Save notes | POST | /api/v1/sessions/preferences/notes |
Components
Section titled “Components”MyDataPage.tsx— Main page componentAddPreferenceDialog.tsx— Dialog for adding new preferences- Session cookies manage anonymous user identity
Best Practices
Section titled “Best Practices”- Be specific — “3+ bedrooms” is better than just browsing 3-bedroom homes
- Add must-haves early — Features you can’t live without should be added first
- Use notes for context — Explain why certain features matter
- Review regularly — Update preferences as your search evolves