unique/CHANGELOG.md

Changelog

May 2026

• Colocate every collection's articles with their media: each entry is now a folder <slug>/index.mdx with sibling media files. Applied to reviews/, find/ (104 articles + 89 heroes auto-resolved by src/lib/find-hero.ts via import.meta.glob('../content/find/*/hero.{...}')), finds/, and posts/. Slug derivation handled by a shared stripIndex helper on each glob loader; URLs unchanged across the entire site. MDX paths shortened from ../../assets/reviews/<slug>/<file> to ./<file>. src/assets/ removed entirely
• Media optimization pass: re-encode the 13 heaviest assets (h264 CRF 28, scale ≤1280px, audio stripped) and convert the two animated GIFs (cotypist, flux-markdown) to MP4 — dist/ drops from 53 MB to 31 MB (~42% smaller); biggest single wins are homerow/search.mp4 (6.7 MB → 1.6 MB), antinote/links.mp4 (2.9 MB → 193 KB), flux-markdown/demo.gif (3.9 MB → 1.3 MB MP4). Originals preserved at src/assets/reviews/<slug>/source/ and never bundled
• Tile videos on / and /grid/ switched from preload="metadata" to preload="none" so below-the-fold demos don't fetch on page load
• src/lib/hero.ts and the cotypist/flux-markdown review MDX updated to render the new MP4 heroes as inline autoplay-loop muted <video> instead of <img>
• Comprehensive SEO pass: new <SEO> component centralising every head-level tag (canonical, Open Graph, Twitter Card, theme-color, RSS alternate, JSON-LD); page-aware structured data — Review + BreadcrumbList on review pages, BlogPosting on posts, Product + BreadcrumbList on finds, Article + ItemList on finds superposts, CollectionPage + ItemList on category/tag/sources/blog pages, WebSite + Organization + ItemList on the home page, AboutPage on /about
• Add @astrojs/sitemap (auto sitemap-index.xml excluding /grid/, /index3/, /404/) and @astrojs/rss (feed at /rss.xml covering reviews + posts + finds superposts); add public/robots.txt pointing at the sitemap
• Add custom 404 page with recent reviews + nav fallback (noindex)
• Wire promoted finds to canonical to their review (via promotedTo); other finds self-canonical
• Noindex /grid/ and /index3/ (kept linked but absent from sitemap and search)
• Per-page descriptions + OG image alt text for every page; count-bearing titles and descriptions on category/tag pages ({category} ({n})); hero image upgraded with real alt text, fetchpriority="high", loading="eager", decoding="sync"; static OG fallback tiers in /public/og/ (default/reviews/finds/posts — PNGs to be supplied)
• Set trailingSlash: 'always' and build.format: 'directory' explicitly to keep canonical URLs stable
• Memoize getSiteStats() so per-page SEO additions don't multiply build cost
• Site-wide UI/UX refresh: newspaper-style masthead on every page (entry-count + last-updated on the left, large serif "Unique" wordmark centered between thin rules, About · Blog nav on the right), per-page italic subheader with last-updated date on listing pages, and an SEO-friendly footer with Browse / Collections / About link columns
• Home page swapped to a Pinterest-style hero + masonry grid; the plain chronological list view moves to /index3/
• New /about stub and /blog index (Astro page over the posts collection with an empty-state when no posts exist)
• Single 76rem page width across the entire site (replaces the 42rem default + wide prop split); article prose is constrained to a 42rem reading measure inside the wider layout so reviews/finds stay readable
• New getSiteStats() helper in src/lib/entries.ts powers the masthead counts and footer Collections column live
• Amazon affiliate handling: outbound links to amazon.com, amzn.to, a.co, and smile.amazon.com get the configured tracking ID appended at render time, are marked with rel="sponsored noopener noreferrer", and display a clearly-signposted "Affiliate" badge plus a one-line FTC-style disclosure on review and find pages. Tracking IDs live in src/lib/affiliate.ts keyed by marketplace; non-US Amazon hostnames are recognized but left untagged until a marketplace-specific ID is added
• Restructure into a four-collection content pipeline: find (captured items, hidden from indexes), finds (editorial superposts that reference find slugs in a Pinterest-style grid), reviews (existing — gains optional source and fromFind fields for graduations), and posts (existing, generic essays)
• New routes /find/<slug>/ (direct URL only — finds don't appear on home, tag, or category pages) and /finds/<slug>/ (superpost detail with intro + grid)
• New components: FindCard, FindsGrid, Backlinks, SourceBadge
• /sources cards gain a "Recent finds" sub-list per source — the one cross-cutting surface where individual finds are visible
• Find pages show "Featured in:" backlinks computed at build time from any superpost referencing them; review pages show "← First surfaced…" when promoted from a find
• New project-local skills under .claude/skills/: daily-finds (capture-only — no theme detection, no candidate post, no winner pick), build-finds (editorial superpost author), build-review (find → review graduation)
• sources.json gains per-source fetch strategy (webfetch / curl / skip) with optional fetchUrl override; 11 sources switch to curl with a Safari User-Agent (Cool Material, MoMA Design Store, StyleForum, Atlas Obscura, etc.); 9 marked skip after Cloudflare JS challenges and active anti-bot defeats both WebFetch and curl
• New /sources page (3-column card stream listing every source with its type, cadence, topics, and notes)
• Migrate the seed daily-finds post: extract 5 candidates into individual find files, slim the superpost to just the intro paragraph, move from posts/ to finds/
• Initial sources.json curated across macOS apps, useful tools, gifts, clothing, travel, and general-delight feeds (47 sources)
• Daily-finds capture log at daily-finds.log.md; new-source nominations queued at candidate-sources.md
• Initial blog scaffold with Astro 5 (content collections, no client JS)
• Base layout with light/dark theme via prefers-color-scheme
• Index page listing posts by date (newest first)
• Per-post page with title, date, category, optional external link, tags
• Auto-generated category and tag listing pages
• Seed content: 12 posts on delightful Mac apps (Cotypist, Folder Peek, DockDoor, TypeWhisper, Hyperkey, AntiNote, FluxMarkdown, Monocle, Alcove, Shottr, MiddleDrag, LinearMouse)
• Switch to MDX (@astrojs/mdx) for post bodies
• Restructure into two content types: reviews (name + subtitle + body) and posts (title + body, empty for now)
• Unified entry helper (src/lib/entries.ts) and shared EntryList component so the home, category, and tag pages render a mixed chronological feed across collections
• Reviews route moved to /reviews/<slug>/; review detail pages show name as <h1> with subtitle as a tagline beneath
• Index entries now show two lines for reviews (bold name + muted subtitle), single line for posts
• Migrate the 12 seed entries from src/content/posts/*.md to src/content/reviews/*.mdx with the new schema
• Add 5 new reviews: Ice (interface), AltTab (interface), Mac Mouse Fix (input), Homerow (input), Tot (writing)
• Establish media convention at src/assets/reviews/<slug>/ for real screenshots/clips downloaded from each app's site
• Add visuals to 15 of 17 reviews (mp4 demos, animated gifs, or App Store screenshots), with one-line italic captions naming what's shown
• Style images and videos in review pages: max-width 100%, centered, soft border-radius; italic-only paragraphs auto-render as captions
• Use import …?url for animated GIFs (cotypist, flux-markdown) to bypass Sharp and preserve animation
• linearmouse and middledrag intentionally have no visual: linearmouse.app is JS-only with no scrapeable demo and the repo carries no screenshots; the artginzburg/MiddleDrag repo cited in the review no longer exists
• Rewrite all 17 reviews — informative, concise, no sales tone; longer reviews lead with a pre-review blockquote summary
• Style .body blockquote as a confident lead (accent left-border, no italics, foreground color) on review and post detail pages
• Add optional linkText field to reviews: overrides the external-link label (e.g. "Visit in App Store" or "Visit on GitHub"); defaults to the link's hostname with www. stripped
• Sample a Pinterest-like 3-column tile stream at /grid/ (CSS column-count masonry, no JS); responsive to 2 cols / 1 col on narrow viewports
• src/lib/hero.ts maps slug → hero asset (image or video) so the grid can render visuals; reviews without media (linearmouse, middledrag) become text-only tiles with an accent gradient
• Add wide prop to BaseLayout for pages that need a wider max-width than the default reading column
• Floating "grid view →" link from the home page; the main index keeps its plain list layout
• Add a CSS-only scroll-snap carousel for reviews with multiple visuals: each <figure> slide carries its own <figcaption>; pure CSS, no client JS; thin scrollbar visible on desktop, swipe on touch
• Expand 8 reviews into multi-slide carousels with downloaded media — antinote (5), typewhisper (6), dockdoor (3), shottr (3), folder-peek (3), homerow (3), ice (3), tot (2); 28 slides total across the site
• Limit the home page index to the 12 most recent entries across all collections; older entries remain reachable via /grid/, categories, and tags