0 Fork 0

mirror of https://github.com/codewhale-hq/Codewhale.git synced 2026-11-07 10:36:05 -10:00

Files

T

CodeWhale BotandClaude Opus 5.5 168c3c2658 feat(web): paper above, sea below — redesign the homepage around the live whale

Founder direction (2026-10-04): replace the blue-wall ocean with "paper
above, sea below", animate the real GPUI whale, deslop the copy, fix the
sideways-scrolling terminal, and show Windows.

Design
- Paper (the GPUI light palette) is the site's appearance; dark is a pinned
  choice in the theme toggle, no longer the OS default.
- One named sea ramp (--sea, --sea-band) and the tide ombré (--tide: paper ->
  light aqua -> logo light -> logo deep -> navy), taken from the merch's Tide
  ombré tee. Retired the blurred strata bands, the sea texture and the
  mirrored reflection whale; strata.tsx deleted.
- Homepage: paper hero (category headline, install plate, CTAs), the live
  whale resting where the tide begins, the real terminal in the deep water,
  reading sections back on paper (no "01 /" eyebrows, terms in the brand
  face, getting-started steps as ruled columns), install band into the
  footer. Footer: one horizon line, no waterline band.
- Terminal captures scale to their frame (container query on column count)
  instead of scrolling sideways; scroll hint removed.

Whale
- Vendored whale-character-v2 (acting/rig/props/habitat/mark-data) from
  codewhale-app bc1044887b4e, publication approved by the owner; see
  web/vendor/whale-character-v2/PROVENANCE.md.
- components/whale-live.tsx: the app's own Director on a canvas, 30 fps only
  while visible, poster pose under prefers-reduced-motion, pointer gaze at
  rest. It performs a session loop (ready, reading request, planning,
  reading files, editing, running tests, done) with a word for each phase;
  picking a terminal view (Composer/Workbar/Fleet/Providers/Help) cues the
  matching state, Fleet shows three calves.

Copy (English; other locales follow in a translation pass)
- COPY_STYLE.md (UT Dallas JSOM business-communication conventions) and
  MESSAGING.md (positioning research across opencode, Pi, Codex, Claude
  Code, Cline, Zed, Kilo, Crush, Aider; translation-safety rules; glossary).
- Hero: "The open-source coding agent for any model"; section headings,
  product/plugins/models/getting-started/runtime/community/faq strings
  rewritten; claims narrowed to shipped behaviour.

Install
- Windows tab (Scoop main bucket carries codewhale 0.10.0). No winget: the
  manifest is not in microsoft/winget-pkgs (checked 2026-10-04).

Tests: rewrote the design-contract tests that pinned the retired look
(ocean-contract, docs-theme-contract, gpui-role-tokens). The contrast test
now resolves var() stops and caught a real defect (muted ink on the logo-deep
tide stop was 4.38:1); the tide was re-stopped so muted text sits >= 4.5:1.

Evidence (local, this tree):
- web: vitest 74 files / 764 tests passed, 0 failed
- web: npm run check exit 0 (facts, latest-release, docs, tokens, lint,
  tsc --noEmit, next build); 1 pre-existing lint warning in
  scripts/facts-lib.mjs
- headless Chrome: whale cycles all 7 phases and cues "pod" on Fleet; pages
  checked at 1440 and 390 wide: home, product, install, docs/guide, models

Co-Authored-By: Claude Opus 5.5 <[email protected]>

2026-10-04 18:12:18 -07:00

2.2 KiB

Raw Permalink Blame History

Codewhale web copy style

Sources: UT Dallas JSOM Business Communication Center guides (refs/utd-business-communication), codewhale-design/DIRECTION.md "Words", codewhale-ops/CURRENT_DECISIONS.md §25b.

Rules

Lead with a verb or the reader's outcome. "Records every change", not "Receipts for every change". Résumé-style: verb, object, proof.
Know the reader. A developer deciding whether to install. Say what they get, then the one next step.
One idea per unit. One heading, one claim, one CTA per block.
Concrete over adjectives. Name the command, the file, the mode. codewhale exec beats "scriptable".
Never overclaim. Every claim must be true in the released build today. Check docs/features.toml and docs/*.md; if unsure, write the narrower claim. Preview and development surfaces say so.
Short. Headlines ≤ 8 words, sentence case, no period unless it is two sentences. Body ≤ 2 short sentences.
Parallel structure. List items share a grammatical form (all verbs, or all nouns).
"You", not "we" or "users". Address the reader directly.
Plain English. Read it aloud; rewrite anything that doesn't parse on the first pass.
Exact product vocabulary. Plan / Work / Operate, Ask / Auto-Review / Full Access, Fleet, Runtime, codewhale exec, /provider, /model.
No public pricing. No desktop download offer. Placeholders ({brand}, {version}, {tag}) stay verbatim.

Slop blacklist

Words: seamless, powerful, unlock, leverage, empower, effortless, robust, cutting-edge, journey, elevate, supercharge, revolutionize, next-generation, world-class, best-in-class, game-changer, harness, delve, streamline, unleash, first-class, simply, just, truly, really, very.

Patterns:

Stacked hedges ("can help you potentially", "may be able to").
"Whether you're X or Y…" openers.
Rule-of-three padding: a third item added for rhythm, not content.
Em-dash flourishes used for drama; use a period or colon.
"Not just X, but Y."
Vague tails: "and more", "and beyond", "everything you need".
Throat-clearing: "Welcome to", "We're excited", "would love to hear from you".
Generic headings: "What you can do with X", "Getting started with X", "Features".

2.2 KiB Raw Permalink Blame History

Codewhale web copy style

Rules

Slop blacklist

2.2 KiB

Raw Permalink Blame History