Skip to main content

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

PyPI CI License: MIT

Develop

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

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

site2voice-0.5.5.tar.gz (1.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

site2voice-0.5.5-py3-none-any.whl (22.5 kB view details)

Uploaded Python 3

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

Hashes for site2voice-0.5.5.tar.gz
Algorithm Hash digest
SHA256 003380ced62e598a42882801fa2c5908fdeb73f0f11522da1e86e887d0ef0ffd
MD5 ffb2f9e1cbd2dbc6ca367f4256e4fafe
BLAKE2b-256 eff94271f93cfac8c7e8aced0c12c958067b98b3c9c8e2452b47ef84c1a0c5bb

See more details on using hashes here.

Provenance

The following attestation bundles were made for site2voice-0.5.5.tar.gz:

Publisher: publish.yml on SihyeonJeon/site2voice

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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

Hashes for site2voice-0.5.5-py3-none-any.whl
Algorithm Hash digest
SHA256 f8484c4356c617335743f0a38558f303a6c39a79a78eb733c7b927d6b40cfa18
MD5 7b6c57d0c0080f558e2d4343dc37dfd8
BLAKE2b-256 649b2672d730cf88ce618da5e480d12ed3d64e82785258414f12ce363226c8b1

See more details on using hashes here.

Provenance

The following attestation bundles were made for site2voice-0.5.5-py3-none-any.whl:

Publisher: publish.yml on SihyeonJeon/site2voice

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page