Skip to main content

Ready-to-use SITE.md and VOICE.md profiles for AI-generated web structure and copy.

Project description

site2voice

Reference SITE.md and VOICE.md files for AI-generated web pages.

Pick a public web pattern, copy the matching files into your project, and give your agent structure plus writing rhythm:

  • SITE.md: section order, page jobs, structure recipes, and content boundaries.
  • VOICE.md: sentence rhythm, heading shape, CTA shape, claim boundaries, and benchmark gates.

Reference names identify public pages used for measurement. They do not imply official guidelines, affiliation, endorsement, or permission to reuse protected brand identity.

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

Use the reference files for pattern, not subject matter.

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 VOICE.md collection and the SITE.md collection.

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 your agent:

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.

See Brand Usage for the boundary rules.

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 role map in DESIGN.md vs SITE.md / VOICE.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.

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.6.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.6-py3-none-any.whl (22.2 kB view details)

Uploaded Python 3

File details

Details for the file site2voice-0.5.6.tar.gz.

File metadata

  • Download URL: site2voice-0.5.6.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.6.tar.gz
Algorithm Hash digest
SHA256 854684a4f665e0ecf6fcb5649c69f07f72fee66dc71b7e12b9463278739655a4
MD5 01e859403801e984826c46ff2d8b180a
BLAKE2b-256 40e7980d2ee00f7ab1079e4158909de59f1a833836d1bc5abbfecf78a0066843

See more details on using hashes here.

Provenance

The following attestation bundles were made for site2voice-0.5.6.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.6-py3-none-any.whl.

File metadata

  • Download URL: site2voice-0.5.6-py3-none-any.whl
  • Upload date:
  • Size: 22.2 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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 6bbd7fe54dc5269688473916504aa2898198270b3faa812b01ed14a9fe8181b5
MD5 8455dc7960b0566435c67e6bd9cc61b4
BLAKE2b-256 5e49d008bb0054a908dd9c1bb090277387ef809258d5ad67fc49712547ac6110

See more details on using hashes here.

Provenance

The following attestation bundles were made for site2voice-0.5.6-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