Metadata-Version: 2.4
Name: site2voice
Version: 0.5.3
Summary: Ready-to-use VOICE.md copy profiles and optional benchmarks for AI-generated copy.
Author: Sihyeon Jeon
License-Expression: MIT
Project-URL: Homepage, https://github.com/SihyeonJeon/site2voice
Project-URL: Repository, https://github.com/SihyeonJeon/site2voice
Project-URL: Issues, https://github.com/SihyeonJeon/site2voice/issues
Project-URL: Changelog, https://github.com/SihyeonJeon/site2voice/blob/main/CHANGELOG.md
Keywords: agents,context-engineering,voice-md,copywriting,benchmark,markdown
Classifier: Programming Language :: Python :: 3
Classifier: Environment :: Console
Classifier: Topic :: Text Processing :: Markup :: HTML
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# site2voice

**Drop-in `VOICE.md` copy profiles. Pick a public writing pattern, save one file, and your agent writes less generic copy.**

`site2voice` is not a visual design-system library and not a brand-cloning tool.
It turns public copy into a compact, reference-only writing contract: sentence
rhythm, heading shape, CTA verb shape, claim boundaries, and benchmark gates.

**No install. No JSON. No generation step.**

**Not official. Not affiliated. Not permission to impersonate a brand.**

## Featured Profiles

| Profile | Tone | Best for |
| --- | --- | --- |
| [Apple](voices/apple.md) | premium, minimal | product launches |
| [Anthropic](voices/anthropic.md) | measured, institutional | AI safety and product pages |
| [EYESMAG](voices/eyesmag.md) | concise, culture-led | Korean fashion and lifestyle copy |
| [Figma](voices/figma.md) | collaborative, creative | design-tool pages |
| [GitHub](voices/github.md) | developer-first | platform and ecosystem copy |
| [Highsnobiety](voices/highsnobiety.md) | editorial, commerce-aware | culture and fashion launches |
| [Hypebeast](voices/hypebeast.md) | trend-led | streetwear and culture blurbs |
| [Linear](voices/linear.md) | precise, product-team | SaaS positioning |
| [Monocle](voices/monocle.md) | polished, global | city, design, and affairs copy |
| [Notion](voices/notion.md) | simple, workspace | productivity pages |
| [OpenAI](voices/openai.md) | research-to-product | AI product pages |
| [Shopify](voices/shopify.md) | merchant-growth | commerce pages |
| [Stripe](voices/stripe.md) | calm, technical | fintech and SaaS copy |
| [Vercel](voices/vercel.md) | performance-led | developer platform pages |
| [Wallpaper](voices/wallpaper.md) | design-editorial | architecture and interiors copy |

The full collection now includes **33 reference-only profiles**, including
popular web products such as [Canva](voices/canva.md),
[LinkedIn](voices/linkedin.md), [Netflix](voices/netflix.md),
[TikTok](voices/tiktok.md), [WhatsApp](voices/whatsapp.md), [Zoom](voices/zoom.md),
and [PayPal](voices/paypal.md). See the [full collection](voices) and the
[popular-sites analysis](docs/popular-sites-analysis.md).

## Use

Download one copy profile as `VOICE.md`:

```bash
curl -L https://raw.githubusercontent.com/SihyeonJeon/site2voice/main/voices/stripe.md -o VOICE.md
```

Tell Claude Code, Codex, Cursor, or Copilot:

```text
Use @VOICE.md as a copy contract for headings, CTA shape, paragraph rhythm, and UI microcopy.
```

Each file is a plain Markdown writing brief with sentence rhythm, heading
shape, CTA verbs, content boundaries, claim boundaries, and a benchmark target.
The public profiles remove source nouns, raw CTAs, navigation labels, paragraph
samples, logos, screenshots, and brand assets.

Reference names identify the public page used for measurement. They do not
imply sponsorship, endorsement, affiliation, or permission to reuse protected
brand identity. See [Brand Usage](BRAND_USAGE.md).

## Not DESIGN.md

`DESIGN.md` describes visual identity: colors, typography, spacing, components,
layout, and responsive behavior. `VOICE.md` describes writing behavior: rhythm,
CTA shape, information order, claim safety, and copy-safety gates.

Read the full comparison in [DESIGN.md vs VOICE.md](docs/design-md-comparison.md)
and the dated [competitive review](docs/competitive-review.md).

## Before / After

Same LedgerFlow prompt, scored against Stripe:

| Candidate | Result | Overall | Variety | CTA | Copy safety |
| --- | --- | ---: | ---: | ---: | ---: |
| Without `VOICE.md` | FAIL | 63.8 | 40.5 | 25.0 | 100.0 |
| With `VOICE.md` | PASS | 91.1 | 45.8 | 100.0 | 96.2 |

See the [full comparison](examples/comparisons/stripe-ledgerflow/README.md).

## Optional CLI

Generate a new copy profile from any public URL:

```bash
pipx install site2voice
site2voice init https://example.com
```

Validate generated copy:

```bash
site2voice bench https://example.com draft.md --strict
```

Need `voice.json` or an agent prompt too? Use the full [context packs](packs).

## Status

[![PyPI](https://img.shields.io/pypi/v/site2voice.svg)](https://pypi.org/project/site2voice/)
[![CI](https://github.com/SihyeonJeon/site2voice/actions/workflows/ci.yml/badge.svg)](https://github.com/SihyeonJeon/site2voice/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

## Develop

```bash
python3 -m pip install -e .
make test
make bench-ci
```

## License

MIT
