diff --git a/docs/UX-DECISIONS.md b/docs/UX-DECISIONS.md new file mode 100644 index 0000000..775a327 --- /dev/null +++ b/docs/UX-DECISIONS.md @@ -0,0 +1,89 @@ +# UX-DECISIONS.md — Design & Messaging Decisions + +Living record of UX/messaging decisions. Agents must follow these. +Updated after each review session. + +**Last updated:** 2026-02-22 + +--- + +## Audience + +- **Primary:** Crypto natives who understand DeFi but don't know KrAIken +- **Not targeting:** Beginners, "new to DeFi" users +- No ELI5 content on the landing page +- Beginners can find their way through the docs if curious + +## Landing Page Variants + +| Variant | File | Target | Tone | +|---------|------|--------|------| +| Default | `HomeView.vue` | General crypto users | Clean, professional | +| Offensive | `HomeViewOffensive.vue` | Degens, technical users | Aggressive, direct | +| Mixed | `HomeViewMixed.vue` | Blend | Balanced | + +**Offensive is strongest** for crypto natives. Default wins for broader appeal. + +## Messaging Rules + +### Do Say +- "Stake & Grow" (not "Start Earning") +- "Floor guaranteed" (the mechanism exists, even if floor can decrease) +- "Token-owned liquidity" (metaphor, acceptable in marketing) +- "No admin keys" ONLY when staker governance is implemented +- "How It Works →" as equal-weight CTA alongside "Get $KRK" + +### Staking Visibility +- **Staking is NOT mentioned on the landing page.** The staking app is password-protected for a reason — it's for insiders, not casual visitors. +- Landing page sells the token and protocol. The CTA is "Get $KRK", not "Stake". +- No staking mechanics, staking CTAs, or staking explainers on any HomeView variant. +- Visitors discover staking through the community, not through the landing page. + +### Don't Say +- "Start Earning" / "Earn yield" / "APY" — staking isn't yield +- "Stake" / "Stake & Grow" / "Staking" on the landing page — see above +- "You just hold and win" — too promissory (changed to "You just hold.") +- "Open source" — repo is private +- "Three strategies" — three positions, one strategy +- Raw holder count when it's low (show growth % instead) + +### Staking Value Prop +The one-liner: **"Stake → invite friends → supply grows → you profit with leverage."** + +Staking is leveraged directional exposure that pays off when the community grows. +It is NOT passive income. It is NOT yield farming. + +## Display Rules + +### Numbers +- Show **USD as primary** for all ETH amounts (people can't relate to 0.0000029 ETH) +- Keep ETH as secondary/tooltip for crypto natives +- Use CoinGecko API for ETH/USD, cache 5 min +- Format: ≥$1000 → "$25.4k", ≥$1 → "$2.50", <$1 → "$0.007" +- Never use `toFixed(4)` on tiny ETH values — use dynamic precision + +### Stats +- Show growth trends (sparklines, ↑X%) not raw counts +- Multiple mini-sparklines per stat card, not a single health graph +- 7 days or since launch (whichever shorter) for historical data +- Ring buffer only — no unbounded snapshot tables (disk growth concern) +- Live indicator (green dot + "Updated Xs ago") for freshness + +### Contract Addresses +- Show in footer with copy buttons +- Link to Basescan for verification + +## Docs + +- "How It Works" should be equal-weight navigation item, not buried +- Recenter explainer: keep it to 3 bullets (atomic, sentiment-driven, bull/bear) +- No Baseline comparison table — borrow their language, don't name-drop them +- Code page (`/docs/code`) for contract source viewing instead of Codeberg link + +## Tone + +- Sharp, direct, no fluff +- Technical confidence without overclaiming +- "We" when referring to the protocol community +- Never condescending +- Dark theme, minimal decoration diff --git a/landing/src/views/HomeView.vue b/landing/src/views/HomeView.vue index 0a480ca..d356272 100644 --- a/landing/src/views/HomeView.vue +++ b/landing/src/views/HomeView.vue @@ -28,7 +28,7 @@
The protocol rebalances liquidity automatically based on market conditions and staker sentiment. You don't lift a finger.
+The protocol rebalances liquidity automatically based on market conditions. You don't lift a finger.
-