Copy Pasta Formaggi — Open Source

Looking for the app? Download Copy Pasta Formaggi for macOS — copy text anywhere, paste it perfectly.

First-time launch: Right-click the app → Open, then click Open in the dialog. macOS Gatekeeper blocks unsigned apps — this is a one-time step. (The app is not signed with an Apple Developer ID during the beta.)

These are the open-source packages from Copy Pasta Formaggi — a cross-application formatting translator that converts clipboard content between apps so your text looks right no matter where you paste it.

---

What's in This Repo

Package	Description
@copy-pasta/ucf-spec	UCF (Unified Canonical Format) type definitions and constants
@copy-pasta/detectors	Format detectors — identifies clipboard format (Markdown, HTML, plain text, PDF)
@copy-pasta/adapter-reference	Reference adapter implementation (plain text decode/encode) — use as a template for custom adapters
@copy-pasta/eslint-config	Shared ESLint configuration for all packages

The full app with all production adapters is available at copypastaformaggi.com. These packages are the open-source foundation you can use to build custom integrations, write your own adapters, or embed UCF in other tools.

Getting Started

git clone https://github.com/Alpakash/copy-pasta-ucf.git
cd copy-pasta-ucf
pnpm install
pnpm test

Write Your Own Adapter

See CONTRIBUTING.md for a step-by-step guide on writing a UCF adapter. The @copy-pasta/adapter-reference package is a minimal, well-commented reference implementation.

The basic pattern:

1. Detect the source format → @copy-pasta/detectors
2. Decode into UCF (Unified Canonical Format) → implement a decoder using @copy-pasta/ucf-spec types
3. Encode from UCF to your target format → implement an encoder
4. Test with the provided fixtures

UCF (Unified Canonical Format)

UCF is a structured document model that sits between source and target formats. Instead of writing N×M format converters, you write one decoder (source → UCF) and one encoder (UCF → target).

Source format → [Decoder] → UCF → [Encoder] → Target format

UCF represents documents as blocks (paragraphs, headings, lists, code blocks, blockquotes, dividers) with inline content (text, bold, italic, links, inline code, hard breaks).

License

MIT — see LICENSE.

Links

• Download the app — macOS, free beta
• Copy Pasta Formaggi — marketing site
• Contributing Guide — how to write adapters
• Package issues — bugs in UCF spec, detectors, adapters
• App feedback — feature requests & app bugs