Skip to content
d5v7Public

About

Local first preview social link cards instantly before deployment.

Topics

Resources

Code of conduct

Contributing

Stars

8 stars

Watchers

0 watching

Forks

Repository files navigation

PREVU

PREVU

Inspect, validate, and preview Open Graph and Twitter Card metadata locally — before you ship.

PR Check Build Latest release License Top language Rust TypeScript Tauri Platforms


Why PREVU?

Most broken social previews show up only after deploy. PREVU runs on your machine so you can paste a localhost, staging, or production URL and see metadata, validation warnings, and platform previews before anything ships.

Screenshots

Home Site scan
Home Site scan
Batch testing Staging vs production
Batch testing Local and staging comparison
Local URL / port testing
Local URL and port testing

Features

  • Inspect any URL (localhost, staging, or production)
  • Extract Open Graph and Twitter Card tags
  • Validate required tags, image dimensions, aspect ratio, and file size
  • Social previews for Twitter/X, LinkedIn, Facebook, Discord, WhatsApp, and Slack
  • Site monitor with progressive batched scans
  • Batch inspect and staging vs production compare
  • Clipboard URL helper and workspace save/load
  • Shared Rust CLI: prevu inspect <url>

Download

Installers are published on the Releases page.

Platform Artifacts
Windows .exe (NSIS), .msi
macOS .dmg / .app (Apple Silicon + Intel)
Linux .AppImage, .deb, Arch AUR (prevu)

Builds are currently unsigned. Use the platform notes below if Gatekeeper or SmartScreen blocks the first launch.

Installation

Windows
  1. Download PREVU_*_x64-setup.exe (or the .msi) from Releases.
  2. Run the installer.
  3. If SmartScreen appears: More info → Run anyway.
macOS
  1. Download the .dmg for your architecture.
  2. Open it, drag PREVU into Applications, then eject.
  3. If macOS reports the app is damaged or blocked:
xattr -cr /Applications/PREVU.app

Or use System Settings → Privacy & Security → Open Anyway.

Linux

Arch (AUR)

yay -S prevu

AppImage

chmod +x PREVU_*_amd64.AppImage
./PREVU_*_amd64.AppImage

Debian / Ubuntu

sudo dpkg -i PREVU_*_amd64.deb
sudo apt-get install -f

WebKitGTK is required. On Ubuntu/Debian:

sudo apt-get install libwebkit2gtk-4.1-0

Quick start (development)

Prerequisites: Bun 1.3+, Rust stable, and platform Tauri dependencies.

bun install
bun run tauri:dev

Frontend only:

bun run dev

CLI:

bun run cli -- inspect https://example.com
bun run cli -- inspect https://example.com --json

More detail: docs/development.md and CONTRIBUTING.md.

Documentation

Doc Description
docs/development.md Local setup, scripts, architecture notes
docs/architecture.md How the desktop app, parser, and CLI fit together
docs/webpage Marketing website (version synced from root package.json)
CONTRIBUTING.md Contribution workflow and conventions
CODE_OF_CONDUCT.md Community standards
bun run website:dev

Project structure

prevu/
├── frontend/          # React + Vite + TypeScript UI
├── src-tauri/         # Tauri / Rust backend
├── cli/               # Shared-logic CLI
├── docs/              # Developer documentation
└── .github/workflows/ # PR checks, build, release

Tech stack

Layer Technology
Desktop Tauri 2 (Rust)
UI React, Vite, TypeScript, Tailwind CSS
HTTP / HTML reqwest, scraper
Images image
Clipboard arboard
Async tokio

Contributing

Contributions are welcome. Please read CONTRIBUTING.md and CODE_OF_CONDUCT.md before opening a pull request.

Every PR must pass the mandatory PR Check workflow (Linux, Windows, and macOS builds).

Support

If PREVU helps you catch a broken preview before ship, you can support development here:

Buy Me a Coffee

License

MIT © Prevu Contributors

About

Local first preview social link cards instantly before deployment.

Topics

Resources

Code of conduct

Contributing

Stars

8 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages