VS Code Aphex Preview Extension

Thumbnail preview images on hover for @kitschpatrol/unplugin-aphex URLs.

Getting started

Let's assume you have VS Code installed and are working in a project using the unplugin-aphex build tool plugin to integrate photos from your local Apple Photos.app library into your build pipeline via the Aphex project.

Install the extension from the Marketplace, or run the following in VS Code's command palette:

ext install kitschpatrol.aphex-preview

Now, when you hover over an Aphex-style link in your code, you should see a live preview thumbnail of the referenced photo.

vscode-aphex-preview banner

For now, this extension does not itself resolve or fetch images; it only provides thumbnail previews for cached Aphex URLs that have already been resolved by unplugin-aphex via Aphex.

This plugin will technically function and resolve from an existing image cache on Linux and Windows versions of VS Code, but the underlying Aphex pipeline (and the entire premise of resolving assets from a local Apple Photos.app library) will only work on the macOS platform.

Configuration

The extension provides the following settings:

Setting	Default	Description
`aphex-preview.manifestPath`	`node_modules/.cache/aphex/.aphex-plugin-cache.json`	Path to the Aphex cache manifest file
`aphex-preview.maxWidth`	`300`	Maximum width for image previews (points)

Supported file types

Hover previews work in the following file types: JavaScript, TypeScript, JSX, TSX, Markdown, MDX, HTML, Astro, and Svelte.

Maintainers

kitschpatrol

Contributing

Issues are welcome and appreciated.

Please open an issue to discuss changes before submitting a pull request. Unsolicited PRs (especially AI-generated ones) are unlikely to be merged.

This repository uses @kitschpatrol/shared-config (via its ksc CLI) for linting and formatting, plus MDAT for readme placeholder expansion.

Aphex Preview

Kitschpatrol