Skip to content

davidteather/simplestreet

Repository files navigation

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.

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

Coming soon (maybe).

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.

Submitting to Web Stores

The easiest way to deploy your Plasmo extension is to use the built-in bpp GitHub action. Prior to using this action however, make sure to build your extension and upload the first version to the store to establish the basic credentials. Then, simply follow this setup instruction and you should be on your way for automated submission!

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.

About

An extension to add some quality of life features to StreetEasy

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published