SimpleStreet

Apartment search so bad I made this. A Chrome extension to make StreetEasy slightly less painful to use.

⚠️ Heavily WIP / Unstable - Things break, features come and go, use at your own risk. Is mostly vibe coded so please report any issues you find

What It Does

SimpleStreet adds some quality-of-life improvements to StreetEasy's apartment search experience. It injects useful information directly into listing cards, lets you organize listings with notes and tags, and filters out the noise so you can focus on finding a place that doesn't cost your entire salary.

Features

Search Results Enhancements

• Show Available Date - Displays move-in dates directly on listing cards (no more clicking through to find out it's not available for 3 months)
• Hide Sponsored Listings - Filter out promoted listings to see only organic results
• Hide Other Content - Remove ads, banners, and other promotional clutter (wip idk I use brave)

Listing Management

• Notes & Tags - Add private notes and custom tags to listings and buildings to keep track of what you've seen
• Ratings - Rate listings and buildings for your own reference
• Skip Listings - Mark listings you're not interested in to keep your search focused
• Export Data - Export your notes, tags, and ratings (coming soon)

Building Pages

• Building Notes - Add notes and tags at the building level to track building-wide observations
• Building Ratings - Rate entire buildings, not just individual units

All your data is stored locally in your browser - nothing is sent to any servers. See PRIVACY.md for details.

Screenshots

Move-in date on search cards

Skip a listing you're not interested in

A StreetEasy listing card

For the full walkthrough — notes, tags, ratings, hiding a listing, and the Top Rated buildings/listings view — watch rating-comments-labeling.mp4 (opens GitHub's file view, which plays it inline) or read the blog post.

Installation

From Source (Development)

1. Clone this repo
2. Install dependencies:

   pnpm install
   # or
   npm install

3. Build the extension:

   pnpm dev
   # or
   npm run dev

4. Load the extension in Chrome:
   • Go to chrome://extensions/
   • Enable "Developer mode"
   • Click "Load unpacked"
   • Select the build/chrome-mv3-dev folder

From Chrome Web Store

SimpleStreet on the Chrome Web Store, link will go live once it clears review.

Usage

1. Navigate to StreetEasy
2. Click the extension icon in your toolbar to open the popup
3. Toggle features on/off as needed
4. On listing pages, you'll see UI to add notes, tags, and ratings
5. On search results, available dates will appear on listing cards (if enabled)
6. Use the skip button (X icon) on listing cards to hide listings you're not interested in

Development

This is a Plasmo extension project bootstrapped with plasmo init.

Making Production Build

Run the following:

pnpm build
# or
npm run build

This should create a production bundle for your extension, ready to be zipped and published to the stores.

Releasing to the Chrome Web Store

Releases are automated with the bpp GitHub action, triggered by version tags:

pnpm release:patch   # bump version, commit, tag vX.Y.Z, push

The tag push runs .github/workflows/submit.yml, which builds, packages, and uploads to the Chrome Web Store using the SUBMIT_KEYS repo secret (see Plasmo's submit guide for how to generate the keys). Note the very first store submission has to be done manually through the developer dashboard — bpp can only update an existing listing.

Tech Stack

• Plasmo Framework - Chrome Extension framework
• React + TypeScript
• Chrome Storage API (local storage)
• StreetEasy API (for fetching listing data)

Known Issues & Limitations

• StreetEasy's DOM structure changes frequently, so selectors may break
• Available dates are cached for 24 hours (metadata only, your notes/tags never expire)
• Some features may not work if StreetEasy updates their page structure
• This extension only works on streeteasy.com and www.streeteasy.com

Contributing

This is a personal project, but if you find bugs or have suggestions, feel free to open an issue. PRs welcome, but no promises on merge timelines since this is very much a work-in-progress.

License

See LICENSE file for details.