AddThisFeature

Document Preview

Show a readable preview of an uploaded file without opening another program.

involved Documents & Files

What it adds

Server-generated previews for common uploaded document types, shown inline wherever files are listed.

What your agent is told to do

5
  1. 1

    Decide the small set of types worth previewing based on what users actually upload, and treat everything else as an icon plus file details. A general-purpose converter for every format is not the minimum coherent version of this.

  2. 2

    Generate previews in the app's existing background job system after upload completes, and show the file as uploaded with a preview pending rather than holding the upload open.

  3. 3

    Extend the app's existing File Upload and Attachment Gallery to display previews in place, rather than adding a second file surface alongside them.

  4. 4

    Authorise the preview exactly as strictly as the source file. A generated thumbnail of a private contract is the private contract.

  5. 5

    Do not render documents by handing the original bytes to the browser. Convert server-side and serve the rendered output, so an uploaded file cannot execute anything in a viewer's session.

Edge cases it handles

8
  • Conversion is slow and sometimes fails. Queue it in the background, show progress and a clear failed state, and never let a conversion block or roll back the upload itself.
  • Very large files, files with hundreds of pages, and archives nested many levels deep will exhaust a worker. Cap page count, file size, and nesting depth, and say the preview was truncated rather than failing silently.
  • Cache generated previews and expire them when the source file is replaced, or users will keep seeing the old version of a document they have already updated.
  • Unsupported types must degrade to a file type icon with name, size, and date, which is genuinely useful, rather than a broken image frame.
  • Documents embed scripts, macros, and remote references that phone home when rendered. Strip them during conversion and block outbound fetches from the renderer.
  • Previews are derived files that also consume storage. Give them a retention policy and delete them when the source file is deleted, including from any cache or CDN.
  • If the app already runs Upload Malware Scanning, previews must not be generated or shown until the scan clears, otherwise the preview becomes the delivery mechanism.
  • Reserve the preview's dimensions in the list so a page of files does not reflow as each thumbnail arrives, and give every preview alt text naming the file.

Definition of done

9
  • Common uploaded types show a readable inline preview where files are listed.
  • Conversion runs in the background with visible progress and never blocks upload.
  • Oversized and deeply nested files are capped and reported as truncated.
  • Previews are cached and regenerated when the source file changes.
  • Unsupported types fall back to an icon with file details.
  • Embedded scripts and remote references are stripped before rendering.
  • Deleting a file removes its previews, and preview access requires the same permission as the file.
  • 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.