@trading-game/design-intelligence-layer 0.8.5

package/docs/tone-of-voice/trading-game-tone-of-voice-and-campaign-brief.md

@@ -0,0 +1,290 @@
+# trading.game — Tone of voice + campaign brief
+
+*The creative foundation. Build everything from here.*
+
+Version 1.0 · 2026
+
+---
+
+The style guide tells writers what to do.
+
+This tells them why it works — and what world-class looks like.
+
+---
+
+## What we're actually selling
+
+Not a game. Not a platform. Not a crypto product.
+
+The moment you call what a market does next — before it happens — and you're right. The line moves. The number hits. The screenshot goes up.
+
+*I called it.*
+
+No other brand owns this sentence. Crypto exchanges sell holdings. Prediction markets are slow. Casino-adjacent apps sell luck. None of them give the player a reason to say *I called it.*
+
+trading.game does.
+
+Everything follows from this. Every headline. Every bust state. Every push notification. Every button. The question behind all of it is the same: does this copy give the player *I called it* — or does it take it away?
+
+---
+
+## The three campaign territories
+
+Every player is protecting one sentence. These are the three sentences.
+
+---
+
+### Territory 1 — The Edge
+
+> *"I have an edge. I've done the research."*
+
+This player watches charts because they believe attention is a competitive advantage. They've been right three times in a row. Maybe five. Enough to build a conviction that the reads mean something.
+
+They're usually wrong about having an edge. They're right about one thing: they are paying attention. The product's job is to give that attention the fastest possible verdict.
+
+**Campaign anchor:** *Your read. The market decides.*
+
+**What this territory owns:**
+Speed of resolution as validation. Not luck — the read, tested. The chart annotated after the fact. The screenshot that says *called this level three days ago.*
+
+**Demonstration copy:**
+
+| Context | Copy |
+|---|---|
+| Win | Your read. Confirmed. |
+| Win (specific) | Called the level. Vol moved exactly where you said. |
+| Loss | Bust. Vol spiked at the last tick. Happens. |
+| Loss (sustain) | Direction was right. Go again. |
+| Streak | Still up 3 this week. Keep reading. |
+| Campaign headline | Your read. The market decides. |
+| Campaign headline | You've been calling levels for months. Now you can back them. |
+| Campaign headline | The fastest feedback loop on a read. |
+
+**What kills it:** Anything implying randomness. "Lucky break." "Your selection was incorrect." These remove the read entirely. The player doesn't just lose — they lose the thing the product was supposed to protect.
+
+---
+
+### Territory 2 — The System
+
+> *"I'm not just playing. I have rules."*
+
+This player has a modified martingale. The modification is wrong. The cap won't save them. None of that matters. Having a system is the point. Without it, this is gambling. With it, it's research. Every session is data. Every bust is a flaw to iterate on.
+
+The word *system* is doing all the psychological work. trading.game's job is to keep that frame intact — especially after a loss.
+
+**Campaign anchor:** *Every trade is data.*
+
+**What this territory owns:**
+The intellectual coating they've always wanted around the game they've already been playing. Session stats as content. Provably fair as trust signal. Clean withdrawals as table stakes.
+
+**Demonstration copy:**
+
+| Context | Copy |
+|---|---|
+| Win | +250 USDT. System running. |
+| Win streak | 3-game streak. Keep the rules tight. |
+| Loss | Bust. Market barely moved. Tight range. |
+| Loss (sustain) | Variance is part of any system. Go again. |
+| Stats | 7 trades. 4 wins. 57%. Your session. |
+| Withdrawal | Withdrawal confirmed. On its way. |
+| Campaign headline | Every trade is data. |
+| Campaign headline | A game that rewards having a system. |
+| Campaign headline | The read. The result. The record. |
+
+**What kills it:** WIN BIG. Jackpot language. Casino aesthetics. Any of these strips the system frame immediately and turns the product into the thing they've been insisting it isn't. Also: "please try again." Systems don't apologise.
+
+---
+
+### Territory 3 — The Record
+
+> *"I called it. And I can prove it."*
+
+The prediction only counts if someone witnessed it. The win is not complete until it's posted. This player runs a public record — a spreadsheet in their bio, a weekly X post, a pinned Discord message. The number that matters is not their balance. It's their running unit total and their public win rate.
+
+Being early to trading.game is as valuable as winning on it. "I found this before anyone knew about it" is not a throwaway line. It's identity. Write for this player and the next hundred come free.
+
+**Campaign anchor:** *The fastest way to be publicly right.*
+
+**What this territory owns:**
+The result screen as a content piece. The streak counter as a K/D ratio. The platform as evidence. Shareable, specific, worth posting — because if the win state is generic, it doesn't get posted, and the distribution flywheel doesn't turn.
+
+**Demonstration copy:**
+
+| Context | Copy |
+|---|---|
+| Win | Called it. +1,250 USDT. 5-tick streak. |
+| Win (share prompt) | Streak: 7. Post this. |
+| Near-win | You were early on that move. Vol 75 confirmed. |
+| Loss | Bust. Still 6 from 9 today. Record stands. |
+| All-time stat | Your record: 47–29. Keep building. |
+| Campaign headline | The fastest way to be publicly right. |
+| Campaign headline | You found it early. That matters here. |
+| Campaign headline | Before it was mainstream. You know what to do. |
+
+**What kills it:** "Great job." "You're getting the hang of this." Generic win states with no data, no mechanic, nothing worth posting. If the result screen is forgettable, it doesn't get shared. The UI is a distribution channel. Treat it like one.
+
+---
+
+## The translation principle
+
+Apple doesn't describe the product. They describe the experience in the user's language.
+
+Neither do we.
+
+| What the product is | What the player calls it | The copy rule |
+|---|---|---|
+| A synthetic GBM price feed | A live market | Never say synthetic |
+| A 50/50 binary outcome | My read, tested | Never say 50/50 |
+| A house edge of 2% | Known edge. Provably fair. | Own the number — don't hide it |
+| A 5-tick resolution | Fast feedback on the call | Speed is the whole product |
+| A streak counter | My record | Not a feature. Their identity. |
+| A win state | Called it | Two words. That's the product. |
+| A loss state | Market moved. Next one. | The copy is the recovery mechanism |
+
+Every piece of copy should be written from the right column. The left column is for the legal team and the product spec. The right column is for everyone else.
+
+---
+
+## The near-miss — a dedicated campaign brief
+
+This is the mechanic no one talks about. It should be a campaign.
+
+When the price lands one tick short of the target — when the line stops at 55.49 and the player needed 55.50 — the brain does not register a loss. It registers: *I was right and the resolution was imprecise.* Neurologically distinct from a clean loss. More motivating than a win, because a win ends the tension. A near-miss keeps it alive.
+
+The animation of the line stopping one tick short is not a UX detail. It is the most powerful retention mechanic in the product.
+
+**Campaign territory:** The feeling of being one tick away from right — and knowing the read was correct — is specific to trading.game. No exchange offers it. No prediction market delivers it this fast. This is a campaign.
+
+**Campaign lines:**
+- One tick short. The read was right.
+- 55.49. You had 55.50. Next one.
+- Close. Vol reversed at the last second.
+- Almost isn't wrong. Go again.
+
+**The creative brief:**
+Show the line stopping one tick short. No music swell. No consolation overlay. Just the number, held for a beat. Then one line. The player should feel correct — not consoled. They should place the trade again without being told to.
+
+The near-miss is the product's most honest promise: *you are getting better at this.* Every piece of near-miss copy should carry that without saying it.
+
+---
+
+## The voice
+
+One person. A smart friend who actually plays. Who has been right on three calls in a row and knows — specifically — the difference between edge and luck.
+
+Not a bank. Not a tutorial. Not a hype account. The friend who would tell you when the read was bad, without apology, but who also knew before you did that it was going to bust.
+
+**The voice has a point of view.** It knows what it's talking about. It sounds like someone with something at stake.
+
+**The voice is fast.** It gets to the point before the player blinks. In a game context, attention is short. If a sentence can be cut in half, cut it in half.
+
+**The voice reacts.** It responds to what just happened. A win state written last Tuesday is not a win state. It's furniture.
+
+**The voice is fearless.** Real stakes. Real crypto. Real loss. It doesn't apologise for any of this. It owns it.
+
+---
+
+## What the voice never does
+
+**Never explains what the player already knows.**
+They follow charts. They know support levels. They've been on Stake. Copy that explains how a volatility index works to this player is an insult.
+
+**Never celebrates luck.**
+"Lucky break" destroys the frame. The read wasn't lucky. It was right. Say that.
+
+**Never apologises for the product.**
+The player didn't sign up for safety. They signed up for the verdict.
+
+**Never writes a loss as a failure.**
+A loss is: the market moved, the vol spiked, the range was tight, the tick landed short. A loss is never: your selection was incorrect. One gives the player something to hold. The other leaves them with nothing and no reason to go again.
+
+**Never sounds generated.**
+Smooth, competent, forgettable is the failure mode. trading.game copy has a point of view. It sounds like someone who has actually played. If it could have been written by a language model in three seconds for any product — rewrite it.
+
+---
+
+## The mirror test
+
+Before any copy ships, hold it against these. These are the exact phrases the player uses. Copy that sounds like a response to one of these passes. Copy that sounds like it was written for someone else doesn't.
+
+**Territory 1 (The Edge):**
+- *"Flagged the rejection at 68.4k on Monday. Played out exactly."*
+- *"Direction was right, timing was off."*
+- *"Not changing the system."*
+
+**Territory 2 (The System):**
+- *"Down 300 but my process was solid."*
+- *"Variance is part of any system — you accept it or you quit."*
+- *"New rules after last week. Still testing. Will update end of month."*
+
+**Territory 3 (The Record):**
+- *"Week 22: 9–5, +3.1 units. Running total since January: +31.2 units."*
+- *"I was on this before anyone knew about it."*
+- *"Positive EV call even if it doesn't land."*
+
+If the copy could sit next to any of these sentences and not feel out of place — it passes.
+
+---
+
+## Campaign headlines — the standard
+
+These are not drafts to be revised. They are the bar.
+
+**Hero / brand:**
+- Your read. The market decides.
+- Call it. The market says yes or no.
+- Five seconds. Real money. Real read.
+- The arcade where the read is everything.
+- The read is the game.
+
+**Mid-funnel / consideration:**
+- You've been calling levels for months. Now you can back them.
+- Polymarket for people who don't want to wait a week.
+- No portfolio. No chart analysis course. Just the call.
+- The gap between having a read and proving it: five seconds.
+
+**Acquisition — first mover:**
+- You found it early. That matters here.
+- Before it was mainstream. You know what to do.
+
+**Retention — post-loss:**
+- Bust. The market had other plans. Go again.
+- One tick short. Next one.
+- Down today. The read was right. Keep reading.
+
+**Retention — streak:**
+- 5-day streak. You're not guessing anymore.
+- Called 7 of 9. That's not variance. That's an edge.
+- Streak alive. Don't stop now.
+
+---
+
+## The emotional undercurrent
+
+Never say this. Always carry it.
+
+The self-taught analyst is providing liquidity to algorithmic traders running sub-second execution on news he sees five minutes late. The session tracker is back at midnight for the same reason anyone is. The documented bettor's unfalsifiable EV framing means she's never actually wrong — just temporarily right in a way the universe hasn't confirmed yet.
+
+None of them need to be told any of this.
+
+The product just needs to sell them the version of themselves they prefer. Sharp. Right. Early. In control. Someone who reads markets, not someone who presses buttons.
+
+That's what the copy does. Every word either reinforces that self-image or accidentally destroys it. There is no neutral position. Every button, every bust state, every notification is either *yes, that's me* — or it isn't.
+
+Write for the version of them they prefer. Every time.
+
+---
+
+## How to use this document
+
+**Before writing anything:** identify the territory. Who is in the room when they read this — Edge, System, or Record? Usually all three. Write for the one who matters most, check that it doesn't break the other two.
+
+**Before shipping anything:** run the mirror test. Hold the copy against the player's actual phrases. If it sounds like it came from a different world, rewrite it.
+
+**If in doubt:** return to the anchor. *I called it.* Does this copy give the player that sentence? Or does it take it away?
+
+The answer tells you everything.
+
+---
+
+*trading.game Tone of Voice + Campaign Brief — v1.0. Supersedes the style guide as the creative foundation for all marketing, campaign, and brand copy. Use the style guide for mechanics and grammar rules. Use this for what matters.*

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@trading-game/design-intelligence-layer",
+  "version": "0.8.5",
+  "description": "Trading Game Design System — shadcn/ui components with Tailwind CSS v4",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./styles": "./src/styles.css"
+  },
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "scripts": {
+    "dev": "next dev -H 127.0.0.1 -p 3000",
+    "generate:registry": "node scripts/generate-component-registry.mjs",
+    "build": "tsup",
+    "build:next": "next build",
+    "start": "next start",
+    "lint": "eslint",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist/",
+    "src/styles.css",
+    "docs/",
+    "AGENTS.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18",
+    "tailwindcss": ">=4"
+  },
+  "dependencies": {
+    "@base-ui/react": "^1.2.0",
+    "@hookform/resolvers": "^5.2.2",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "cmdk": "^1.1.1",
+    "date-fns": "^4.1.0",
+    "embla-carousel-react": "^8.6.0",
+    "input-otp": "^1.4.2",
+    "lucide-react": "^0.577.0",
+    "radix-ui": "^1.4.3",
+    "react-day-picker": "^9.14.0",
+    "react-hook-form": "^7.71.2",
+    "react-resizable-panels": "^4.7.1",
+    "recharts": "^2.15.4",
+    "sonner": "^2.0.7",
+    "tailwind-merge": "^3.5.0",
+    "vaul": "^1.1.2",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.1.6",
+    "next": "16.1.6",
+    "next-themes": "^0.4.6",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "shadcn": "^3.8.5",
+    "tailwindcss": "^4",
+    "tsup": "^8.5.1",
+    "tw-animate-css": "^1.4.0",
+    "typescript": "^5"
+  }
+}