Ready-to-use SITE.md and VOICE.md profiles for AI-generated web structure and copy.
Project description
site2voice
Drop-in SITE.md and VOICE.md profiles. Pick a public web pattern, save two files, and your agent gets page structure plus copy rhythm.
site2voice is not a visual design-system library and not a brand-cloning tool.
It turns public pages into compact, reference-only context files:
SITE.md: section order, page jobs, structure recipes, and content boundaries.VOICE.md: sentence rhythm, heading shape, CTA shape, claim boundaries, and benchmark gates.
No install. No JSON. No generation step.
Not official. Not affiliated. Not permission to impersonate a brand.
Context Stack
Use the files together without overlapping responsibilities:
| Context | Owns | Must not supply |
|---|---|---|
| Project brief | product category, audience, facts, domain nouns, examples, offer, claims | reference-site nouns |
DESIGN.md |
colors, typography, spacing, layout grid, components, motion, imagery style | copy rhythm or claims |
SITE.md |
page structure, section order, section jobs, conversion path | colors, fonts, product category |
VOICE.md |
sentence rhythm, heading behavior, CTA shape, claim boundaries | product nouns, visual design |
This prevents an athletic retail reference from leaking its products or cultural context into an unrelated education, finance, healthcare, or developer product.
Featured Profiles
| Profile | Tone | Best for |
|---|---|---|
| Apple | premium, minimal | product launches |
| Anthropic | measured, institutional | AI safety and product pages |
| EYESMAG | concise, culture-led | Korean fashion and lifestyle copy |
| Figma | collaborative, creative | design-tool pages |
| GitHub | developer-first | platform and ecosystem copy |
| Highsnobiety | editorial, commerce-aware | culture and fashion launches |
| Hypebeast | trend-led | streetwear and culture blurbs |
| Linear | precise, product-team | SaaS positioning |
| Monocle | polished, global | city, design, and affairs copy |
| Notion | simple, workspace | productivity pages |
| OpenAI | research-to-product | AI product pages |
| Shopify | merchant-growth | commerce pages |
| Stripe | calm, technical | fintech and SaaS copy |
| Vercel | performance-led | developer platform pages |
| Wallpaper | design-editorial | architecture and interiors copy |
The full collection now includes 33 reference-only profiles, including popular web products such as Canva, LinkedIn, Netflix, TikTok, WhatsApp, Zoom, and PayPal. See the full collection and the SITE.md collection, plus the popular-sites analysis.
Use
Download one structure profile and one copy profile:
curl -L https://raw.githubusercontent.com/SihyeonJeon/site2voice/main/sites/stripe.md -o SITE.md
curl -L https://raw.githubusercontent.com/SihyeonJeon/site2voice/main/voices/stripe.md -o VOICE.md
Tell Claude Code, Codex, Cursor, or Copilot:
Use @SITE.md for page structure and @VOICE.md for copy rhythm. Bring our own product nouns, facts, and claims.
Each file is plain Markdown. Public profiles remove source nouns, raw CTAs,
navigation labels, paragraph samples, logos, screenshots, and brand assets.
Use SITE.md when building a web page; use VOICE.md when writing headings,
CTAs, UI copy, and launch copy.
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.
Not DESIGN.md
DESIGN.md describes visual identity: colors, typography, spacing, components,
layout, and responsive behavior. SITE.md describes page structure: section
order, section jobs, page archetype, and content boundaries. VOICE.md
describes writing behavior: rhythm, CTA shape, claim safety, and copy-safety
gates.
Read the full comparison in DESIGN.md vs SITE.md / VOICE.md and the dated competitive review.
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.
For a visible web result, see the
SITE.md + VOICE.md web comparison.
It shows the same HTML landing-page prompt with and without the context files,
including screenshots and a reference-fit score.
Optional CLI
Generate a new context pack from any public URL:
pipx install site2voice
site2voice init https://example.com
Generate only a page-structure file:
site2voice site https://example.com --out SITE.md
Validate generated copy:
site2voice bench https://example.com draft.md --strict
Need site.json, voice.json, or an agent prompt too? Use the full context packs.
Status
Develop
python3 -m pip install -e .
make test
make bench-ci
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file site2voice-0.5.5.tar.gz.
File metadata
- Download URL: site2voice-0.5.5.tar.gz
- Upload date:
- Size: 1.3 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
003380ced62e598a42882801fa2c5908fdeb73f0f11522da1e86e887d0ef0ffd
|
|
| MD5 |
ffb2f9e1cbd2dbc6ca367f4256e4fafe
|
|
| BLAKE2b-256 |
eff94271f93cfac8c7e8aced0c12c958067b98b3c9c8e2452b47ef84c1a0c5bb
|
Provenance
The following attestation bundles were made for site2voice-0.5.5.tar.gz:
Publisher:
publish.yml on SihyeonJeon/site2voice
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
site2voice-0.5.5.tar.gz -
Subject digest:
003380ced62e598a42882801fa2c5908fdeb73f0f11522da1e86e887d0ef0ffd - Sigstore transparency entry: 1588895535
- Sigstore integration time:
-
Permalink:
SihyeonJeon/site2voice@7dc40cd1e6fedf865959c34ddb74e8d45e395775 -
Branch / Tag:
refs/tags/v0.5.5 - Owner: https://github.com/SihyeonJeon
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@7dc40cd1e6fedf865959c34ddb74e8d45e395775 -
Trigger Event:
release
-
Statement type:
File details
Details for the file site2voice-0.5.5-py3-none-any.whl.
File metadata
- Download URL: site2voice-0.5.5-py3-none-any.whl
- Upload date:
- Size: 22.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f8484c4356c617335743f0a38558f303a6c39a79a78eb733c7b927d6b40cfa18
|
|
| MD5 |
7b6c57d0c0080f558e2d4343dc37dfd8
|
|
| BLAKE2b-256 |
649b2672d730cf88ce618da5e480d12ed3d64e82785258414f12ce363226c8b1
|
Provenance
The following attestation bundles were made for site2voice-0.5.5-py3-none-any.whl:
Publisher:
publish.yml on SihyeonJeon/site2voice
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
site2voice-0.5.5-py3-none-any.whl -
Subject digest:
f8484c4356c617335743f0a38558f303a6c39a79a78eb733c7b927d6b40cfa18 - Sigstore transparency entry: 1588895547
- Sigstore integration time:
-
Permalink:
SihyeonJeon/site2voice@7dc40cd1e6fedf865959c34ddb74e8d45e395775 -
Branch / Tag:
refs/tags/v0.5.5 - Owner: https://github.com/SihyeonJeon
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@7dc40cd1e6fedf865959c34ddb74e8d45e395775 -
Trigger Event:
release
-
Statement type: