bounded-frontend
Wire a web or React Native frontend to Bounded: the @bounded-sh/client SDK (reads, writes, subscriptions, queries), hosted static frontends, and end-user auth UI (email OTP, OAuth, browser guest/anonymous accounts and upgrade). Use when building the client of a Bounded app or handling how end users sign in. Part of the Bounded skill family; server-side rules, functions, and the actor model live in the bounded-backend skill, and deploy/hosting config in bounded-deploy.
How do I install this agent skill?
npx skills add https://github.com/bounded-sh/skill --skill bounded-frontendIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides comprehensive documentation and implementation guides for the Bounded frontend SDK. It adheres to security best practices, such as recommending server-side secret management, session encryption for mobile devices, and robust identity verification using stable account IDs. No malicious patterns, obfuscation, or unauthorized data exfiltration were detected.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
Bounded frontend
The client side of a Bounded app: the SDK your web or mobile app calls, how end users authenticate, and how the hosted frontend is served. Policy still governs every write from the client, so pair this with the bounded-backend skill when a client action needs a rule or invariant, and bounded-deploy for hosting and domains. To route across the family, see the root bounded skill.
Reference Router
Read only the row matching the current task or term.
| Task or term | Read |
|---|---|
SDK reads, writes, subscriptions, paging, queryAggregate, count, filters, sort, cursor, setMany, set(path, null) | SDK reference |
| Build a web frontend | web app guide |
Local dev server (npm run dev, Vite, localhost), login popup fails, redirect_uri origin is not a registered origin, CORS during local development | develop on localhost |
Refresh timer, setInterval, polling, "keep it fresh", countdown, stale UI | SDK reference |
| Build for React Native / mobile | React Native guide |
App-user email OTP, OAuth, openBoundedWidget, unified login widget, default Turnkey auth | app auth |
Bring-your-own wallet login; walletLogin, authMethod:'phantom', supportsWalletSignIn, unsupported wallet / Wallet Standard | wallet login |
Wallet login lost on refresh, getCurrentUser() null after reload, bounded_last_auth_method, session restore method | wallet login - "Wallet sessions survive reloads" |
| Guests, anonymous users, invite links, account upgrade | anonymous accounts |
Link a user's X account, connect('x'), completeConnection, getConnections, verified X handle, __connections__ | connected accounts |
| Hosted frontend and app URLs | frontend hosting |
Hide or limit the hosted widget, /__bounded/widget.js, openApps.widget.visibility | hide the widget |
| A Next.js app that runs its server (vinext), its secrets and limits | server apps |
CLI developer login or bounded login | developer accounts |
Embedded wallet, auth.wallets, @user.address after email/social login | embedded wallets |
onramp(), buy SOL/USDC by card, Coinbase Onramp, wallet top-up | onramp |
Rules Of Thumb
- Every client write is governed by policy; a
403on a write is a rule denial, not a client bug. See the bounded-backend skill for the rule. - Denied reads return empty
200responses, never403. - Live by default; never poll. Every collection is push-based, so a
setIntervalthat re-reads a path is a bug, not a tuning choice - useuseQuery(React) orsubscribe. Countdowns tick on local clock state, not on a re-read. For the few surfaces that are not live (runQuery,functions.invoke, third-party), poll deliberately: pause on a hidden tab, scope the timer to the state that needs it, back off, and bound it. See sdk-reference.md. - Batch reads for lists of computed values with
runQueryMany; never maprunQueryover a list. See sdk-reference.md. - Put provider API keys in Bounded secrets (backend), never in frontend code.
- If
npm auditreportsuuidadvisory GHSA-w5hq-g745-h8pq through@solana/web3.js -> jayson, use the scoped override recipe. It addresses that advisory; runnpm audit --omit=devon the installed lockfile and investigate any remaining findings separately. - Keep the auth defaults for most apps. Do not add
authModeorauth.walletsto "enable wallets": default Turnkey email/social login already carries@user.address. Deploy"auth": { "wallets": true }only for an EXTERNAL-keypair session (bring-your-own wallet login, a server-SDK keypair client, the CLI keypair data lane). Full rule and the opt-outs: embedded-wallets.md. @user.id(the account id) is identity/ownership;@user.addressis the wallet. Key ownership, membership, and auth guards on@user.id(always present). Reach for@user.addressonly for wallet/onchain semantics - never as the identity key.- Wallet login on a phone needs the Solana Mobile adapter. A phone browser never injects wallet apps; keep
@solana-mobile/wallet-standard-mobileinstalled (legacy-peer-deps=truein.npmrc) and never pre-checkwindow.solanabefore opening the widget. See Solana Mobile.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/bounded-sh/skill/bounded-frontend">View bounded-frontend on skillZs</a>