AddThisFeature

Unsplash Image Search

Let users search and place Unsplash photography without leaving the screen.

moderate Integrations

What it adds

An in-app image search that returns licensed photos with the identifier and attribution needed to use them.

What your agent is told to do

5
  1. 1

    Add image search where users currently paste a URL or hunt for a stock photo — cover images, avatars, banners — and keep the existing upload path beside it.

  2. 2

    Proxy every provider request through the server so the application credential never reaches the browser, and cache popular queries briefly to stay inside the rate limit.

  3. 3

    Debounce typing and cancel the request for a query the user has moved past, so results cannot arrive out of order and replace a newer search.

  4. 4

    On selection, store the provider's stable image identifier, the photographer's name and profile link, and the source link, alongside whatever the app caches locally. A raw image URL alone cannot be attributed or re-resolved later.

  5. 5

    Honour the provider's attribution and download-tracking requirements: show the photographer and source wherever the image appears, and trigger the download event when a user actually selects an image rather than on every result that renders.

Edge cases it handles

8
  • Attribution is a licence condition, not a nicety. An image shown without a visible credit and a working link back puts the app out of compliance.
  • Results for an abandoned query must be discarded. Without cancellation a slow early request can land after a fast later one and show photos for a query the user has already replaced.
  • The provider credential must stay server-side. Putting it in front-end code hands the app's entire quota to anyone who reads the page.
  • An image can be removed by its author or by the provider after it was chosen. Detect the broken reference, fall back to a placeholder, and prompt for a replacement rather than leaving a dead image in place.
  • Store the identifier and author metadata at the moment of selection so attribution survives even when the provider is later unreachable.
  • Development and production rate limits differ by an order of magnitude. Handle exhaustion with a clear message and keep the upload path available, rather than an empty grid that reads as no matches.
  • A search with no results, an empty query, and a failed request must each look different from one another.
  • Results are unmoderated for any particular context. If the app serves a sensitive audience, apply the provider's content filtering and say in the interface that it is applied.

Definition of done

9
  • Users can search and insert an image without leaving the screen they are working on.
  • No provider credential is present in client code; all requests pass through the server.
  • Typing is debounced and responses for superseded queries are discarded.
  • Each selected image stores a stable identifier, photographer, and source link.
  • Attribution is displayed wherever the image appears and links back correctly.
  • Download tracking fires on selection only, not on search result rendering.
  • A removed image or an exhausted rate limit degrades to a clear message with upload still available.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.