The Clipper Appendix

The worked example for the new website workflow: the marketing site for Clipper, the app built in the new app workflow. The site has one job: turn a curious podcaster into a download.

Appendix A · Aim

WHY.md
Who it's for

A solo podcaster running a one-person show. They just saw a Clipper-made clip, or went looking for a faster way to make one, and they're curious for about a minute.

The pain

Making a clip means scrubbing an hour of audio in a video editor and captioning by hand. So most episodes ship without one, and most episodes go unheard.

Why it needs to exist

Clips are how podcasts get found, and nobody else is going to make them for a show of one. The site's job is to show Clipper doing the work, then send that podcaster to the App Store.

MESSAGE.md
The one-liner

Post a clip five minutes after you publish.

Three points, each with its proof
  • Find the moment by reading, not scrubbing · the transcript picker, shown
  • Captions baked in · a real exported clip, playing
  • Built for one-person shows · no team seats, no timeline
Headlines & taglines
  • Post a clip five minutes after you publish.
  • Read the episode. Clip the moment.
  • Built for one-person shows.
JOURNEYS.md
Journey 1 · from a clip (expanded)
  • arrives from · a Clipper-made clip on social
  • step 1 · lands on home
  • step 2 · watches the demo clip
  • step 3 · taps Get Clipper
  • outcome · App Store product page
JOURNEY 1 · FROM A CLIP sees a clip lands on home watches the demo clip taps Get Clipper App Store product page
Journey 2 · from a search

Searches for a way to clip a podcast, lands skeptical, reads the three points. Outcome: taps through convinced, or leaves knowing exactly what Clipper is.

Journey 3 · the return visit

Saw it last week, comes back to check the fine print before downloading. Outcome: the FAQ answers it, taps through.

Mood board

Direction before pixels. Three words to build toward: quick, legible, a little loud. Then references, each named for the one thing it lends.

MOOD BOARD LENDS LENDS LENDS one big line the caption motif real screens

A reference earns its tile by finishing the sentence "lends · ". One that can't gets cut.

Appendix B · Sketch

Site map

Pages carry the journeys they serve. Every path ends at the store.

SITE MAP home j1 · j2 · j3 how it works j2 faq j3 app store outside blog learn more fine print get it no journey reaches it → cut it, or it's a new journey

A page with no journey numbers is a page nobody asked for.

Page skeleton, home

One section stack per page. Real first-draft headlines, no styling.

HOME, AS A SECTION STACK Post a clip five minutes after you publish. Get Clipper hero · j1 j2 the demo clip, playing clip-demo · j1 read, don't scrub captions baked in built for one point-row · j2 Get Clipper cta-band · all

Sections carry names and journey numbers. Design styles these later; the words are already true.

Appendix C · Architecture

runs in tandem with Appendix D · Design

System map

Thin on purpose. The stack is decided once for every site we ship: Next.js on Vercel. This stage writes down the handful of choices that remain.

site app store email list analytics copy lives in the repo tap through signups pageviews dashed = bought, not built

The only running part is the site itself. There is no database: the copy is the state, and it lives in the repo.

Signups go straight to a hosted list, so the list outlives any rebuild of the site.

DECISIONS.md

One line per decision, the stack included. Written as the choices land, and again whenever the build later overrules one. A decision that needs its argument written out also gets a file in docs/adr/, and its line points to it.

sep 05Next.js on Vercelthe same platform as everything we ship · rejected: Framer, Webflow
sep 05no CMSthree pages, the copy lives in the repo · rejected: headless CMS · docs/adr/0001-no-cms.md
sep 09buy the email list (hosted)the list must outlive any rebuild · rejected: signups into our own table
sep 09pageview analytics onlyone number matters: tap-through · rejected: session replay

Appendix D · Design

runs in tandem with Appendix C · Architecture

Brand sheet

The tokens, decided once. Every component reads from these; nothing hardcodes a color or a face.

paper #FFFFFF ink #16181C caption #F2C21F soft #5D636E
color
 ├─ paper → #FFFFFF
 ├─ ink → #16181C
 ├─ caption → #F2C21F   the accent; the product is captions
 └─ soft → #5D636E

type
 ├─ headlines → Bricolage Grotesque 700
 └─ body → Public Sans 400 / 600

space → 4 8 12 16 24 40 64
radius → 10px cards, pill buttons
motif → the caption block: ink box, paper text, 3px radius

The motif comes from the product. Clipper makes captions, so the site speaks in caption blocks.

The wordmark is the word Clipper set in the headline face inside a caption block. There is no logo project.

Components

The repeatable sections, built in code with real copy. These are the design deliverable; there is no handoff file.

HERO, ASSEMBLED FROM THE SHEET Post a clip five minutes after you publish. Get Clipper words · MESSAGE.md motif · brand sheet action · WHY.md
ComponentWhere it runsNotes
herohomeThe one-liner in caption blocks, one button.
clip-demohome · how it worksA real exported clip, muted, looping.
point-rowhomeThree points, each with its proof.
cta-bandevery page, last sectionThe one action, restated.
faq-itemfaqQuestion, short answer. No accordions.

Each component names where it runs. A component no journey needs doesn't get built.

Appendix E · Ship

PLAN.md
EACH BLOCK ENDS IN A URL M1 assemble M2 sharpen M3 wire M4 launch all pages, thin
M1 · assemble

Every page standing on a preview URL, built from the Design components with the Sketch copy. Demo: the preview link, on a phone.

M2 · sharpen

A pass per page: rhythm, spacing, motion, and the copy read aloud once.

M3 · wire

Signups land on the list, analytics counts, every page has its title, description, and preview card.

M4 · launch

The checklist walked, then the DNS flip. Demo: the real URL.

A ticket, whole

#7 · home · j1 · hero · done when: the one-liner and the button render on a phone

Launch checklist

Walked on a phone by someone who didn't build it.

LAUNCH CHECKLIST j1 · from a clip j2 · from a search j3 · the return visit signups reach the list preview cards render pass pass fail pass blocked bug #12 waits on j3

Launch when the column is green, then flip the DNS.