johba/harb
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

chore: gardener housekeeping 2026-03-23

Browse source 
AGENTS.md watermarks refreshed to HEAD (209e0c7). Key content updates:
- root AGENTS.md: added packages/analytics/ to directory map
- landing/AGENTS.md: documented @harb/analytics integration and Umami funnel tracking
- web-app/AGENTS.md: documented analytics events (wallet_connect, swap_initiated, stake_created)
- onchain/AGENTS.md: documented AttackRunner fixes (taxRate as index, vm.warp, same-broadcast recenter), 2000-trade floor-ratchet evidence

Pending actions (6): promote #1083 and #1086 to backlog, unblock #1099.
This commit is contained in:
johba 2026-03-23 18:07:12 +00:00
parent 209e0c798e
commit 2ef2e48f8a
10 changed files with 57 additions and 53 deletions
Download patch file Download diff file Expand all files Collapse all files

12
landing/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: b276392e7a1d4eda36ec20a90ef22de471da2344 -->
<!-- last-reviewed: 209e0c798ea85204c5fe466ba7b54b874095e08f -->
# Landing Interface - Agent Guide
Vue 3 + Vite application that delivers the public marketing site and forthcoming staking UI.
@ -10,6 +10,7 @@ Vue 3 + Vite application that delivers the public marketing site and forthcoming
- `@wagmi/vue` for wallet connection (injected, WalletConnect, Coinbase Wallet)
- `@tanstack/vue-query` — required peer dependency of `@wagmi/vue`; must be registered via `VueQueryPlugin` in `main.ts`
- `@harb/web3` shared composables for wagmi config and wallet hooks
- `@harb/analytics` — self-hosted Umami wrapper; call `initAnalytics(url, id)` in `main.ts`, use `trackCtaClick(label)` via the `navigateCta` helper in views
## Key Views & Components
- `HomeView.vue` - Launch countdown, feature overview, and staking CTA
@ -32,6 +33,15 @@ Vue 3 + Vite application that delivers the public marketing site and forthcoming
- `npm run type-check`
- Deployments assume hash-based routing and the Vite `base` setting configured for static hosting.
## Analytics
The landing page uses `@harb/analytics` (a self-hosted Umami wrapper) for conversion funnel tracking.
- `initAnalytics(VITE_UMAMI_URL, VITE_UMAMI_WEBSITE_ID)` is called in `main.ts` — the Umami `<script>` tag is injected dynamically so ad-blocker state is handled gracefully.
- CTA buttons use `navigateCta(path, label)` in `HomeView.vue` instead of `router.push()` directly — this fires `trackCtaClick(label)` before navigating. Tracked labels: `hero_get_krk`, `how_it_works_get_krk`, `getting_started_get_krk`, `view_protocol`, `how_it_works_docs`.
- All tracking calls are safe no-ops if Umami is unavailable (ad-blocked, env vars unset, dev mode without Umami running).
- Env vars required: `VITE_UMAMI_URL` (script URL), `VITE_UMAMI_WEBSITE_ID` (UUID). See `docs/ENVIRONMENT.md`.
## Upcoming Integrations
- Wallet connection with Base network switching
- Staking dashboard that reuses shared helpers from `kraiken-lib`