# 05 — Messaging & Voice

The brand-voice spec for SwoleX. Use this when writing app store copy, landing pages, ads, social, video voiceover, push notifications, in-app empty states, and Kevin's coaching language.

---

## The voice in one sentence

> **Spoken by a lifter, written for lifters.** Direct, specific, honest, a little dry. Lifter vernacular without try-hard slang. No wellness language. No fluff.

---

## Audience persona

The reader is **Danny**.

- 28, male, lifts 4×/week, has been training for 5+ years.
- Has logged in Strong / Hevy / FitNotes / Notes app at some point.
- Watches lifting content on IG Reels and TikTok (Sam Sulek, AlphaDestiny, Layne Norton, Renaissance Periodization, whoever).
- Has a friend group that lifts. They text each other PRs and form-check clips.
- Considers himself "intermediate to advanced." Knows what RPE, 1RM, drop set, superset, and progressive overload mean.
- Hates getting talked down to. Hates "begin your wellness journey." Loves brutal honesty.
- Pays for one subscription if it's worth it, cancels three if they're not.

Secondary persona: **Coach Ryan** — 35, has trained clients for 8 years, has 12k followers on IG, wants to publish programs but doesn't want to build a Squarespace + Stripe stack from scratch.

Tertiary: **New Danny** — 22, brand new to lifting, just signed up for his first commercial gym, doesn't know what to do with a barbell. Wants someone to tell him what to lift. Kevin is that someone.

---

## Voice principles

### 1. Direct > clever

> ✅ *"Tap a workout. Kevin scales the weights. Lift."*
> ❌ *"Unlock your potential with intelligent training optimization."*

### 2. Specific > general

> ✅ *"Kevin reads your last 90 days, rounds every set to your plate math, and adds 5 lb where you've earned it."*
> ❌ *"Personalized workouts adapted to you."*

### 3. Honest > polished

> ✅ *"You under-trained pull all month. Fix it."*
> ❌ *"Consider rebalancing your training distribution."*

Kevin doesn't soften feedback for the user. The brand voice doesn't either.

### 4. Show, don't claim

> ✅ A 5-second video of tapping **CHALLENGE ACCEPTED** and watching the weights snap to plate math.
> ❌ *"AI weight scaling that's smarter than the rest."*

### 5. Lifter vernacular, not gym-bro slang

Use:
- "Ridiculous," "brutal," "destroyed," "punish," "crushed," "got swole," "smoked," "in the bag"
- "Working weight," "top set," "back-off set," "drop set," "tempo," "RPE," "AMRAP"
- "Plate math," "rep range," "split," "block," "deload"

Avoid (smells like an agency wrote it):
- "Gains" used as a verb
- "Beast mode"
- "Crush your goals"
- "Wellness journey"
- "Find your why"
- "Mind-body connection"
- "Sweat is fat crying"
- Anything with "your best self"

### 6. No emoji except 🔥 💪 🦍

These three are the in-app reaction icons and are fair game. Anything else (🚀 ✨ 💯 🙌 etc.) reads as agency-LinkedIn. Skip.

### 7. Use Kevin's name

Don't say "the AI" or "the algorithm." Say **Kevin**. That's the entire branding move. Use it.

---

## Capitalization rules (locked)

| Form | Where it appears |
|---|---|
| **SWOLEX** | Logo, wordmark, app icon, share-card title text |
| **SwoleX** | In-sentence body text, app store name, paragraphs, ads |
| ~~swoleX~~, ~~swolex~~, ~~Swolex~~ | Never |
| **CHALLENGE ACCEPTED** / **I GOT THIS** | Feed-card CTAs — always all-caps |
| **AI WORKOUT** | The button label — all-caps in UI; sentence case is OK in prose ("ask Kevin for an AI workout") |
| **Kevin** | Always capitalized, first name only |
| **Pro / Trainer / Creator** | Tier names — proper-noun cap when referenced as the tier ("upgrade to Pro", "become a Trainer"). Creator is bundled with Trainer; the standalone Creator path is free + application-based. |

---

## Tagline candidates

The current ASC subtitle is the locked one. Others below are options for context-specific surfaces (homepage hero, ad, video super, etc).

### Locked
- **App Store subtitle (≤30 chars):** *"Log, Share & Get Swole"*

### Hero / above-the-fold candidates
1. *"Every workout. Executable."*
2. *"Tap their workout. Lift your weights."*
3. *"Lift it. Post it. Watch your friends try it."*
4. *"The lifting app with Kevin in the rack."*
5. *"Logs in. Lifts more. Posts more."*

### Pro-tier upsell candidates
- *"Kevin without limits."*
- *"Unlimited Kevin. Full reports. CSV export. $9.99."*
- *"Pro is just Kevin off the leash."*

### Trainer-tier candidates
- *"Your clients. Your programs. SwoleX takes care of the rest."*
- *"Stop running your business on a Notes app and a calendar."*

### Creator-tier candidates
- *"Publish. Get paid. Keep 85%."*
- *"Your followers don't need a Patreon. They need a workout."*

---

## Messaging architecture

### Single-pillar messaging (one big idea per surface)

When you have one screen, one slide, one billboard — lead with **executable content**:

> *"Every post in SwoleX is a workout you can run."*

Everything else is supporting evidence. Don't try to say "AI + social + trainers + creators + reports" in one breath.

### Three-pillar messaging (landing page, longer ad, deck)

1. **Executable feed.** "Tap any post. Kevin scales the weights. Lift in 10 seconds."
2. **Kevin, your AI coach.** "He builds your sessions, swaps your exercises, grades your training."
3. **Creator + Trainer economy in one app.** "Sell programs. Coach clients. One subscription, one identity."

### Five-feature messaging (homepage feature grid)

1. **AI WORKOUT** — Kevin builds a session in seconds, scaled to your strength.
2. **DO ANYONE'S WORKOUT** — Tap a feed post. The weights are already yours.
3. **TRAINING REPORTS** — Kevin grades your last 30/90/365 days. Export to PDF.
4. **PROGRAMS** — From you, from creators, or from your trainer. All in one app.
5. **SHARE TO IG / TIKTOK / SNAP** — Auto-generated cards that drive new users to your workout.

---

## App-store copy (current, verbatim from `store/listings.md`)

This copy is **already locked** in the App Store and Play Store. Variants for other channels should respect its tone:

### Subtitle
> *Log, Share & Get Swole*

### Promotional text (170 chars)
> *The workout app that executes. Log your training, share it to the feed, and let others run your exact routine with AI-scaled weights.*

### Description opener
> *SwoleX is the workout app built for lifters who actually show up.*

> *Log your training, share it to your feed, and watch others hit your exact routine — with weights automatically scaled to their own history. That's the SwoleX loop: post a workout, someone taps DO WORKOUT, and they're training your program in seconds.*

### Feature-section headers (use the same nouns elsewhere)
- *TRACK EVERY LIFT*
- *AI WORKOUT ENGINE*
- *DO WORKOUTS FROM THE FEED*
- *PROGRAMS & PREMIUM CONTENT*
- *SHARE YOUR WINS*

> **Note:** the ASC copy still says "AI WORKOUT ENGINE." For marketing-channel copy going forward, **prefer "Kevin"** — but don't rush to retype the ASC listing until the next planned listing revision (see `store/RELEASE_PLAYBOOK.md`).

---

## Release-note voice (drop-in template)

Release notes are a high-signal voice surface — the lifter actually reads them. The 1.0.9 notes are the model:

> *• Fitness Profile hub overhaul — every part of your profile (training level, goal, strength, capabilities, preferences, injuries) is now its own focused edit screen. No more re-running the entire onboarding to fix one answer. Tap a section, edit just that piece, save.*
>
> *• Slimmer onboarding for new users — required questions only (handle, name, birthday). The rest of your fitness profile waits in the hub for you to fill in at your pace.*
>
> *Behind the scenes:*
>
> *• The AI Coach now reads each injury qualifier (prevents training / persists through warmup / OK at light weight) with per-region directives — e.g. lower-back injuries automatically avoid loaded hip-hinge movements and substitute chest-supported rows.*

Pattern:
- One-line bullet stating the change in user terms
- *Optional* short follow-up explaining the upside
- "Behind the scenes:" section for the lifter who cares about the engine

---

## Push notification voice

Notifications need to be **glanceable** and **specific**.

### ✅ Good
- *"@oldfatstrongguy challenged you to THE ARM GAUNTLET. 5 exercises · 39.7k lbs."*
- *"Kevin's training report dropped: B+ this month. 3 things to fix."*
- *"Coach Ryan added you to APEX VELOCITY. Day 1 is Push."*
- *"New PR on Bench. 235 × 5. Add it to the feed?"*

### ❌ Avoid
- *"You have new activity!"*
- *"Don't forget to work out today!"*
- *"Discover new content."*

---

## In-app empty-state copy

Empty states are an underused voice surface. Use them.

| Screen | Empty state |
|---|---|
| **Feed (no follows yet)** | *"Your feed's empty. Follow a few lifters and your gym fills up."* + [Find Trainers] + [Browse Programs] |
| **History (zero workouts)** | *"Nothing here yet. Tap **+** and log your first set. Kevin starts learning today."* |
| **AI Coach (free tier)** | *"Kevin's training report is a Pro feature. Free tier shows the raw numbers — your trend, your volume, your calibration. Upgrade for the letter grade."* |
| **Programs (no enrollments)** | *"Browse a program below or tap **+ → AI WORKOUT** to let Kevin build today's session from scratch."* |
| **PRs (none yet)** | *"PRs show up here the moment you log a heavier set than last time. Go get one."* |

---

## Voiceover style — 30-second spot

Read all of it in a flat, dry, almost-amused tone. No hype voice. Lifter, mid-30s, has lifted long enough to find the whole "Olympia mindset" thing a little ridiculous.

**Example:**

> *(Plates clink. Tap → CHALLENGE ACCEPTED. Workout loads.)*
>
> "My buddy hit a brutal arm day. I tapped his post. The weights were already mine."
>
> *(Cut to AI Coach screen, "B+ — Hypertrophy" lands.)*
>
> "Kevin grades me at the end of the month. Last month I was a C. I argued, then I deadlifted."
>
> *(Cut to logo + line.)*
>
> "SwoleX. Tap. Lift. Repeat."

---

## Push, ad, and headline matrix

Use this as a rolodex. Pick the line that fits the surface.

### For lifters (Member acquisition)
- *"Every post is a workout you can run."*
- *"Strong saves your sets. SwoleX programs them."*
- *"Tap any feed post. The weights are already yours."*
- *"Kevin reads your history. He writes today's session."*
- *"Hevy lets you post your workout. SwoleX lets your friends do it."*
- *"Lift. Post. Watch your friends try."*

### For coaches / creators
- *"Publish a program in 8 seconds. Kevin scaffolds the weeks. You polish the edges."*
- *"Sell programs. Keep 85%. Get discovered."*
- *"Your followers don't need a Patreon. They need a workout."*

### For trainers
- *"Onboard a client in three taps. Kevin handles the in-between."*
- *"One subscription. Ten clients. Stripe deposits weekly."*
- *"Stop running your business on a Notes app."*

### For brand-new lifters (App Store)
- *"Don't know what to lift today? Ask Kevin."*
- *"The lifting app that programs for you."*

---

## Do / don't reference

| Topic | Do say | Don't say |
|---|---|---|
| Kevin | *"Kevin programmed it"* | *"Our AI engine optimized it"* |
| Free tier | *"Free. Genuinely."* | *"Free trial."* |
| Pro | *"Pro is just Kevin off the leash."* | *"Premium subscription unlocks features."* |
| Sharing | *"One tap to Story."* | *"Engage with our social platform."* |
| Lifting | *"Run his chest day."* | *"Try a recommended workout."* |
| Injuries | *"Kevin programs around your shoulder."* | *"Adaptive accommodations engine."* |
| Plate math | *"Your dumbbells, your math."* | *"Equipment-specific weight adjustment."* |
| Goal | *"Strength block. Hypertrophy block."* | *"Personalized fitness journey."* |
| The category | *"Lifting app."* / *"Workout app."* | *"Fitness platform."* / *"Wellness solution."* |

---

## Audience-specific channel notes

### TikTok / Reels
- Lead with the **tap** — CHALLENGE ACCEPTED + the weights changing on screen.
- 7 seconds to hook, 22 seconds to convince.
- Lifter POV. Talk to the camera like it's your gym buddy.
- Don't show Kevin's text output unless it's a single specific sentence ("Kevin: cut volume 15% next week, your bench velocity is dropping").

### App Store screenshots (already produced — see `screenshots/`)
- The current set is strong; don't over-polish.
- Captions should be short imperative sentences: *"Tap any workout."* *"Kevin scales the weights."*

### Landing page (swolex.com)
- Hero: 6-second product loop (looping video, no audio, autoplay).
- Below the fold: three-pillar grid (executable feed / Kevin / creator+trainer economy).
- Social proof: 3 creator quotes once we have them.
- Pricing: simple table. Don't over-explain tiers — link to a tier-compare page.

### Email / in-app digest
- Personalize with the user's actual numbers.
- *"Last week: 4 sessions, 38,200 lbs, 2 PRs. Kevin says: push pull this week. You're 22% behind your push volume."*

### Press / reviewer briefings
- Lean on the **executable content** unique angle. Reviewers know the category and will appreciate a real differentiator over hype.
- Demo flow: Open feed → tap CHALLENGE ACCEPTED → watch weights snap to your plate math → finish → share card → IG Story → tap card → workout opens.

---

## A 200-word elevator (for podcasts, investors, partners)

> SwoleX is the workout app where every post is executable. Other lifting apps treat a workout log as data — SwoleX treats it as content you can run. You see a feed of your friends' actual workouts. You tap a button — CHALLENGE ACCEPTED — and Kevin, our AI coach, scales every weight to your strength, gates the exercises by your gym's equipment, and you're lifting in ten seconds.
>
> That's the unlock. Strong is a tracker. Hevy is a tracker with friends. Fitbod is AI in a vacuum. Nobody connects social fitness to AI workout generation the way SwoleX does.
>
> On top of that we've stacked a creator economy — anyone can publish a program and earn via Stripe — and a Trainer tier that bundles client management with the consumer app, so a trainer's clients don't get the typical stripped-down satellite experience.
>
> The whole thing flows from one button on the feed. The button is the product. Everything else is in service of getting more of them tapped.

---

## Final rule

If the copy doesn't make Danny (the persona) say *"yeah, that's me,"* or doesn't make Coach Ryan say *"oh that's actually useful,"* it's not SwoleX copy. Rewrite it.
