diff --git a/.woodpecker/ci.yml b/.woodpecker/ci.yml index 5654b50..c617056 100644 --- a/.woodpecker/ci.yml +++ b/.woodpecker/ci.yml @@ -5,6 +5,18 @@ name: build-and-test when: event: pull_request +clone: + git: + image: woodpeckerci/plugin-git + settings: + depth: 50 + environment: + GIT_TERMINAL_PROMPT: "0" + CI_NETRC_MACHINE: codeberg.org + CI_NETRC_USERNAME: johba + CI_NETRC_PASSWORD: + from_secret: codeberg_token + steps: - name: bootstrap-deps image: registry.niovi.voyage/harb/node-ci:latest diff --git a/.woodpecker/e2e.yml b/.woodpecker/e2e.yml index e938088..dff4408 100644 --- a/.woodpecker/e2e.yml +++ b/.woodpecker/e2e.yml @@ -8,6 +8,18 @@ name: e2e when: event: pull_request +clone: + git: + image: woodpeckerci/plugin-git + settings: + depth: 50 + environment: + GIT_TERMINAL_PROMPT: "0" + CI_NETRC_MACHINE: codeberg.org + CI_NETRC_USERNAME: johba + CI_NETRC_PASSWORD: + from_secret: codeberg_token + # All background services - services get proper DNS resolution in Woodpecker # Note: Services can't depend on steps, so they wait internally for contracts.env services: 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 @@
⚙️

Self-Adjusting

-

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.

🔍
diff --git a/landing/src/views/HomeViewMixed.vue b/landing/src/views/HomeViewMixed.vue index a4f5d19..f6a162c 100644 --- a/landing/src/views/HomeViewMixed.vue +++ b/landing/src/views/HomeViewMixed.vue @@ -60,7 +60,7 @@ Get Started