Giving a link useful context
Vantage turns a pasted URL into a structured preview with a title, description, image, favicon, domain, and content type. The project brings the same underlying payload to an interactive interface and a public JSON endpoint. Its README also describes batch previews, local history, and HTML, Markdown, and JSON export as parts of the broader application.
A cache with a refresh path
The server checks Upstash Redis before scraping. A cached result returns immediately; entries older than a day trigger a background refresh through Next.js after(). Fresh responses receive a seven-day cache lifetime. Open Graph images take priority over Twitter images, with a Thum.io screenshot URL as the final image fallback. GitHub repository links receive an official preview image and repository statistics from GitHub's API.
Handling imperfect source pages
The preview API adds an HTTPS prefix when needed, validates URL syntax, and applies a sliding-window request limit. Metadata fields can remain null, and scraping or infrastructure errors can return no preview. That makes the implemented contract more precise than a promise to successfully preview every website: results depend on the target page, Redis, and any external fallback services used.
Making freshness visible
Proposed future work
A useful next iteration would expose the existing lastFetched timestamp and distinguish scraped images from screenshot fallbacks. Collections and scheduled refreshes could build on the cache, while explicit destination restrictions and clearer upstream error categories would strengthen the public endpoint. These are proposed additions, alongside the README's ideas for broader embeds and richer metadata normalization.