{"owner":"reown-com","repo":"appkit","hasSkills":true,"totalSkillsCount":38,"totalTokensCount":20498,"categories":["command-prompt","cursor-rule","root-instruction","claude-rule","plugin-manifest"],"hasMcp":false,"mcpConfig":null,"found":[".cursor/commands/add-documentation.md",".cursor/commands/address-github-pr-comments.md",".cursor/commands/code-review.md",".cursor/commands/debug-issue.md",".cursor/commands/fix-git-issues.md",".cursor/commands/generate-pr-description.md",".cursor/commands/light-review-existing-diffs.md",".cursor/commands/optimize-performance.md",".cursor/rules/appkit-apps.mdc",".cursor/rules/appkit-examples.mdc",".cursor/rules/appkit-monorepo.mdc",".cursor/rules/appkit-packages.mdc","AGENTS.md","CLAUDE.md","packages/adapters/bitcoin/README.md","packages/adapters/ethers/README.md","packages/adapters/ethers5/README.md","packages/adapters/polkadot/README.md","packages/adapters/solana/README.md","packages/adapters/ton/README.md","packages/adapters/tron/README.md","packages/adapters/wagmi/README.md","packages/appkit-utils/README.md","packages/appkit/README.md","packages/cli/README.md","packages/codemod/README.md","packages/common/README.md","packages/controllers/README.md","packages/core-legacy/README.md","packages/experimental/README.md","packages/polyfills/README.md","packages/scaffold-ui/README.md","packages/siwe/README.md","packages/siwx/README.md","packages/testing/README.md","packages/ui/README.md","packages/universal-connector/README.md","packages/wallet/README.md"],"skills":{".cursor/commands/add-documentation.md":"# Add Documentation\n\nPlease add comprehensive documentation for the current code/feature. Include:\n\n## Overview\n\n- What this code/feature does\n- Why it exists and its purpose\n- Key concepts and terminology\n\n## API Documentation\n\n- Function/method signatures\n- Parameters and return values\n- Example usage with code snippets\n- Error handling and edge cases\n\n## Implementation Details\n\n- Architecture overview\n- Important design decisions\n- Dependencies and integrations\n\n## Examples\n\n- Common use cases with full examples\n- Best practices and patterns\n- Common pitfalls to avoid\n\nFormat the documentation according to the project's documentation standards and\ninclude it in the appropriate location (README, docs folder, or inline\ncomments).\n",".cursor/commands/address-github-pr-comments.md":"# Address GitHub PR Comments\n\n## Overview\n\nProcess outstanding reviewer feedback, apply required fixes, and draft clear\nresponses for each GitHub pull-request comment.\n\n## Steps\n\n1. **Sync and audit comments**\n   - Pull the latest branch changes\n   - Open the PR conversation view and read every unresolved comment\n   - Group comments by affected files or themes\n2. **Plan resolutions**\n   - List the requested code edits for each thread\n   - Identify clarifications or additional context you must provide\n   - Note any dependencies or blockers before implementing changes\n3. **Implement fixes**\n   - Apply targeted updates addressing one comment thread at a time\n   - Run relevant tests or linters after impactful changes\n   - Stage changes with commits that reference the addressed feedback\n4. **Draft responses**\n   - Summarize the action taken or reasoning provided for each comment\n   - Link to commits or lines when clarification helps reviewers verify\n   - Highlight any remaining questions or follow-up needs\n\n## Response Checklist\n\n- [ ] All reviewer comments acknowledged\n- [ ] Required code changes implemented and tested\n- [ ] Clarifying explanations prepared for nuanced threads\n- [ ] Follow-up items documented or escalated\n- [ ] PR status updated for reviewers\n",".cursor/commands/code-review.md":"# Code Review\n\n## Overview\n\nPerform a thorough code review that verifies functionality, maintainability, and\nsecurity before approving a change. Focus on architecture, readability,\nperformance implications, and provide actionable suggestions for improvement.\n\n## Steps\n\n1. **Understand the change**\n   - Read the PR description and related issues for context\n   - Identify the scope of files and features impacted\n   - Note any assumptions or questions to clarify with the author\n2. **Validate functionality**\n   - Confirm the code delivers the intended behavior\n   - Exercise edge cases or guard conditions mentally or by running locally\n   - Check error handling paths and logging for clarity\n3. **Assess quality**\n   - Ensure functions are focused, names are descriptive, and code is readable\n   - Watch for duplication, dead code, or missing tests\n   - Verify documentation and comments reflect the latest changes\n4. **Review security and risk**\n   - Look for injection points, insecure defaults, or missing validation\n   - Confirm secrets or credentials are not exposed\n   - Evaluate performance or scalability impacts of the change\n\n## Review Checklist\n\n### Functionality\n\n- [ ] Intended behavior works and matches requirements\n- [ ] Edge cases handled gracefully\n- [ ] Error handling is appropriate and informative\n\n### Code Quality\n\n- [ ] Code structure is clear and maintainable\n- [ ] No unnecessary duplication or dead code\n- [ ] Tests/documentation updated as needed\n\n### Security & Safety\n\n- [ ] No obvious security vulnerabilities introduced\n- [ ] Inputs validated and outputs sanitized\n- [ ] Sensitive data handled correctly\n\n## Additional Review Notes\n\n- Architecture and design decisions considered\n- Performance bottlenecks or regressions assessed\n- Coding standards and best practices followed\n- Resource management, error handling, and logging reviewed\n- Suggested alternatives, additional test cases, or documentation updates\n  captured\n\nProvide constructive feedback with concrete examples and actionable guidance for\nthe author.\n",".cursor/commands/debug-issue.md":"# Debug Issue\n\nHelp debug the current issue in the code. Please:\n\n## Problem Analysis\n\n- Identify the specific problem or error\n- Understand the expected vs actual behavior\n- Trace the execution flow to find the root cause\n\n## Debugging Strategy\n\n- Add appropriate logging statements\n- Suggest debugging tools and techniques\n- Identify key variables and states to monitor\n- Recommend breakpoint locations\n\n## Solution Approach\n\n- Propose potential fixes with explanations\n- Consider multiple solution approaches\n- Evaluate trade-offs of different approaches\n- Provide step-by-step resolution plan\n\n## Prevention\n\n- Suggest ways to prevent similar issues\n- Recommend additional tests or checks\n- Identify code patterns that could be improved\n\nWalk through the debugging process systematically and provide clear, actionable\nsolutions.\n",".cursor/commands/fix-git-issues.md":"# Fix Git Issues\n\nHelp resolve common Git problems and conflicts. Address:\n\n## Merge Conflicts\n\n- Analyze conflicting changes and their context\n- Provide resolution strategies for different conflict types\n- Suggest the best approach to preserve important changes\n- Generate resolved code maintaining functionality\n\n## Branch Management\n\n- Help with branch cleanup and organization\n- Suggest rebasing vs merging strategies\n- Assist with cherry-picking specific commits\n- Guide through complex branch operations\n\n## Commit History\n\n- Help with commit message improvements\n- Assist with squashing and organizing commits\n- Guide through interactive rebase operations\n- Fix commit authorship and metadata\n\n## Repository Issues\n\n- Help recover from detached HEAD state\n- Assist with undoing commits and changes\n- Guide through stash management\n- Resolve submodule and remote issues\n\nProvide step-by-step Git commands with explanations for each situation.\n",".cursor/commands/generate-pr-description.md":"# Generate PR Description\n\nCreate a comprehensive pull request description based on the changes in this\nbranch. Include:\n\n## Summary\n\nProvide a clear, concise summary of what this PR accomplishes.\n\n## Changes Made\n\n- List the key changes made in this PR\n- Include both code and non-code changes\n- Highlight any breaking changes\n\n## Testing\n\n- Describe how the changes were tested\n- Include any new test cases added\n- Note any manual testing performed\n\n## Related Issues\n\n- Link to any related issues or tickets\n- Use closing keywords if this PR resolves issues\n\n## Additional Notes\n\n- Any deployment considerations\n- Follow-up work required\n- Notes for reviewers\n\nFormat this as proper markdown for use in a GitHub PR description.\n",".cursor/commands/light-review-existing-diffs.md":"# Light Review Existing Diffs\n\n## Overview\n\nPerform a quick quality pass on current diffs to surface risky areas, ensure\npolish, and flag follow-up actions for deeper review.\n\n## Steps\n\n1. **Scan recent changes**\n   - List open branches or pending commits requiring review\n   - Skim side-by-side diffs focusing on new or modified files\n   - Note files or modules with large or complex edits\n2. **Assess quality signals**\n   - Watch for TODOs, debug code, or commented blocks needing cleanup\n   - Verify naming, formatting, and imports follow project standards\n   - Check that tests or documentation were updated when behavior changed\n3. **Flag next actions**\n   - Mark sections that warrant full review or pair programming\n   - Capture questions or uncertainties to raise with the author\n   - Document any quick fixes you can apply immediately\n\n## Review Checklist\n\n- [ ] High-risk files identified\n- [ ] Debugging artifacts removed or flagged\n- [ ] Style and conventions validated\n- [ ] Tests/docs updates confirmed or requested\n- [ ] Follow-up items recorded for deeper review\n",".cursor/commands/optimize-performance.md":"# Optimize Performance\n\nAnalyze the current code for performance bottlenecks and provide optimization\nrecommendations. Focus on:\n\n## Performance Analysis\n\n- Identify slow algorithms and inefficient data structures\n- Find memory leaks and excessive allocations\n- Detect unnecessary computations and redundant operations\n- Analyze database queries and API calls\n\n## Optimization Strategies\n\n- Suggest algorithm improvements and better data structures\n- Recommend caching strategies where appropriate\n- Propose lazy loading and pagination solutions\n- Identify opportunities for parallel processing\n\n## Implementation\n\n- Provide optimized code with explanations\n- Include performance impact estimates\n- Suggest profiling and monitoring approaches\n- Consider trade-offs between performance and maintainability\n\nFocus on measurable improvements while maintaining code quality and readability.\n",".cursor/rules/appkit-apps.mdc":"---\ndescription: Focused rules for working in apps (dev, testing, wiring AppKit into apps)\nglobs:\n  - 'apps/**'\nalwaysApply: false\n---\n\n## AppKit Apps Rules\n\nUse these when changing code under `apps/**`.\n\n### Development & Scripts\n\n- Use workspace scripts: `pnpm --filter @apps/<name> dev|build`.\n- Build dependencies first with `pnpm build` if packages changed.\n- Keep app configs minimal; rely on package exports and avoid deep imports.\n\n### Integrating AppKit\n\n- Import via facade or adapter packages, e.g.:\n  ```ts\n  import { createAppKit } from '@reown/appkit'\n  import { ControllersProvider } from '@reown/appkit-controllers/react'\n  ```\n- Prefer framework subpaths when available: `@reown/appkit/react`, `@reown/appkit-controllers/react`.\n\n### Testing\n\n- Vitest for unit/integration; Playwright in `apps/laboratory` for e2e.\n- Co-locate basic tests within app directories where meaningful; heavy e2e in laboratory app.\n\n### SSR & Client Boundaries\n\n- Guard browser-only APIs (e.g., `window`) for SSR routes.\n- Avoid importing `@reown/appkit-ui` directly in server components; use client components wrappers.\n",".cursor/rules/appkit-examples.mdc":"---\ndescription: Focused rules for examples (usage patterns, adapters, CDN builds)\nglobs:\n  - 'examples/**'\nalwaysApply: false\n---\n\n## AppKit Examples Rules\n\nThese rules apply to `examples/**`.\n\n### Usage Patterns\n\n- Import from public entrypoints of packages (`@reown/appkit`, `@reown/appkit-adapter-*`).\n- Do not deep import internal paths.\n- Keep example code minimal, readable, and framework-idiomatic.\n\n### Adapters & Peers\n\n- Respect `peerDependencies`: install `wagmi`/`viem`/`ethers` in examples that need them.\n- Prefer the adapter suited to the framework: wagmi for React, ethers for generic EVM, solana adapter for Solana.\n\n### CDN\n\n- For CDN-based examples, use `@reown/appkit-cdn` outputs and ensure polyfills are present when required.\n",".cursor/rules/appkit-monorepo.mdc":"---\ndescription: Monorepo-wide rules for Reown AppKit: structure, layering, packaging, and TS/SDK best practices\nglobs:\n  - \"packages/**\"\n  - \"apps/**\"\n  - \"examples/**\"\n  - \"services/**\"\n  - \"scripts/**\"\n  - \"turbo.json\"\n  - \"pnpm-workspace.yaml\"\n  - \"vitest.workspace.ts\"\nalwaysApply: true\n---\n\n## Cursor Rules: Reown AppKit Monorepo\n\nThis document orients Cursor to the structure, relationships, and common patterns across the Reown AppKit monorepo. It also encodes TypeScript and SDK development best practices to keep edits consistent, safe, and maintainable.\n\n### Monorepo Overview\n\n- **Package manager**: `pnpm` workspaces (`pnpm-workspace.yaml`)\n- **Build Orchestration**: `turbo` tasks (`turbo.json`) with cached `build`, `typecheck`, `lint`, `test`\n- **Testing**: `vitest` (workspace config in `vitest.workspace.ts`, default `jsdom` env)\n- **Repo roots**:\n  - `packages/` — publishable libraries and internal SDK modules\n  - `apps/` — product and demo applications (`gallery`, `laboratory`, `demo`, `browser-extension`)\n  - `examples/` — integration examples (Next, React, Vue, Svelte, plain HTML)\n  - `services/` — ancillary services (e.g., `id-allocation-service`)\n  - `scripts/`, `patches/`, root configs\n\n### High-Level Architecture and Package Roles\n\n- **SDK Facade**: `@reown/appkit`\n\n  - Public, framework-agnostic entrypoint. Re-exports subdomains and framework layers via subpath exports.\n  - Depends on: `@reown/appkit-common`, `@reown/appkit-controllers`, `@reown/appkit-pay`, `@reown/appkit-polyfills`, `@reown/appkit-scaffold-ui`, `@reown/appkit-ui`, `@reown/appkit-utils`, `@reown/appkit-wallet`, plus ecosystem deps (`valtio`, `viem`, `@walletconnect/universal-provider`).\n  - Provides subpaths like `./react`, `./vue`, `./utils`, `./adapters`, `./connectors`, etc.\n\n- **Domain Foundations**:\n\n  - `@reown/appkit-common`: shared types, math/date utils, light helpers. ESM only.\n  - `@reown/appkit-wallet`: wallet models, schema validation, core wallet utilities (depends on `common`, `polyfills`).\n  - `@reown/appkit-controllers`: stateful logic and business rules, with `valtio` for reactive state. Framework-agnostic; provides optional `react`/`vue` subpaths.\n  - `@reown/appkit-utils`: integration helpers per chain/family (Ethers, Solana, Bitcoin, Wallet Standard). Depends on `common`, `controllers`, `wallet`, `polyfills`.\n\n- **UI Layers**:\n\n  - `@reown/appkit-ui`: low-level UI as Web Components (Lit). Exports many `wui-*` components; no app logic.\n  - `@reown/appkit-scaffold-ui`: mid/high-level UI flows (modal, router containers, pay/onramp flows). Composes `@reown/appkit-ui` and `controllers`.\n  - `@reown/appkit-wallet-button`: focused UI package that composes `ui`, `controllers`, `utils`; optional `@lit/react` wrapper.\n\n- **Authentication and Pay**:\n\n  - `@reown/appkit-siwe`: Sign-In With Ethereum UX + controllers integration.\n  - `@reown/appkit-siwx`: Cross-chain SIWx utilities for EVM, Solana, Bitcoin, etc. No direct UI dependency.\n  - `@reown/appkit-pay`: UI + state for pay flows; composes `ui`, `controllers`, `utils`.\n\n- **Adapters (ecosystem integrations)**: `packages/adapters/*`\n\n  - `@reown/appkit-adapter-wagmi`, `-ethers`, `-ethers5`, `-solana`, `-bitcoin` (and private `-polkadot`).\n  - All depend on `@reown/appkit` + foundations; expose framework subpaths when relevant (`react`, `vue` in some packages).\n  - Use `peerDependencies` for host frameworks/SDKs (e.g., `wagmi`, `viem`, `ethers`) and `optionalDependencies` for optional wallets/providers.\n\n- **Bridging, Polyfills, Experimental, CDN**:\n\n  - `@reown/appkit-universal-connector`: thin bridge to `@walletconnect/universal-provider`.\n  - `@reown/appkit-polyfills`: browser `buffer` and similar shims.\n  - `@reown/appkit-experimental`: gated/unstable features (e.g., smart session). Depends on core packages.\n  - `@reown/appkit-cdn`: prebundled CDN builds (not tree-shaken by consumers). Depends on `appkit` and adapters.\n\n- **Tooling**:\n  - `@reown/appkit-testing`: test harnesses (includes Playwright for e2e; depends on `@reown/appkit`).\n  - `@reown/appkit-cli`: simple scaffolding/utility CLI.\n  - `@reown/appkit-codemod`: upgrade helper for dependency migrations.\n  - `@reown/appkit-core` (in `core-legacy/`): legacy compatibility wrapper around controllers.\n\n### Allowed Dependencies and Import Boundaries\n\n- Favor a layered graph from foundations → controllers → ui/scaffold → appkit (facade) → adapters/apps.\n- Avoid cyclical imports. Do not import upward across layers (e.g., `ui` must not import from `appkit` or app code).\n- Only import via package entrypoints or declared subpath exports; avoid deep, relative cross-package imports.\n  - Good: `import { X } from '@reown/appkit-controllers'`\n  - Good: `import { WuiButton } from '@reown/appkit-ui/wui-button'`\n  - Avoid: `import { X } from '@reown/appkit-controllers/dist/...` (internal paths are not stable)\n- Framework subpaths are explicitly exported (e.g., `./react`, `./vue`) when available; prefer those over bundling framework internals.\n- Keep optional or host-specific libraries as `peerDependencies` (e.g., `wagmi`, `viem`, `ethers`) and mark optional features as `optionalDependencies` to keep the core light.\n\n### Packaging and Build Conventions\n\n- All packages are ESM (`\"type\": \"module\"`).\n- Build outputs:\n  - JS: `dist/esm/...`\n  - Types: `dist/types/...`\n  - `package.json` uses `exports` map and (where relevant) `typesVersions` for editor compatibility.\n- Use `\"sideEffects\": false` when the package is tree-shakeable (most are). Ensure top-level side effects are avoided.\n- Scripts:\n  - `build:clean`: remove `dist`\n  - `build`: `tsc --build` (some use `tsconfig.build.json`)\n  - `watch`: `tsc --watch`\n  - `typecheck`: `tsc --noEmit`\n  - `lint`: ESLint across TS/JS files\n  - `test`: Vitest (most with coverage)\n- Orchestration:\n  - Use `turbo run build --filter={./packages/**/*}` for workspace builds.\n  - `typecheck` and `lint` are cached by turbo; `test` is typically not cached.\n\n### UI Patterns\n\n- Base UI uses Lit Web Components, exported as `wui-*` elements from `@reown/appkit-ui`.\n- Higher-level UI flows and composition live in `@reown/appkit-scaffold-ui` and focus on orchestration (modal, router container, lists, pay/onramp flows).\n- Do not embed business logic into `@reown/appkit-ui`. Use `controllers`/`utils` for non-visual logic and data.\n- If providing React wrappers for Web Components, expose them via explicit subpath exports (e.g., `./react`) and keep them optional to avoid forcing React in core packages.\n\n### State, Data, and External SDKs\n\n- State management is uniform with `valtio`. Controllers own reactive state; UI subscribes.\n- EVM stack uses `viem` and `wagmi` (in adapters). Solana uses `@solana/web3.js` and wallet-standard libs. Bitcoin uses `bitcoinjs-lib`, `sats-connect`.\n- WalletConnect v2 is integrated via `@walletconnect/universal-provider`. Keep provider interactions isolated in `controllers`/`utils`/adapters.\n\n### Testing Conventions\n\n- `vitest` with `jsdom` by default for DOM-related packages; Node for pure utility packages as needed.\n- Place tests under `tests/` per package.\n- `@reown/appkit-testing` includes shared testing utilities and e2e dependencies (e.g., Playwright) but is not a runtime dependency.\n\n### Versioning and Release\n\n- Managed with `changesets`. Some overrides/patches exist under `patches/`.\n- Internal packages use `workspace:*` ranges to synchronize versions.\n- Keep public API changes aggregated through `@reown/appkit` where possible to minimize breaking surface area.\n\n### Adding or Modifying Packages (Checklist)\n\n1. Create a new package under `packages/<name>` with:\n   - `package.json` using ESM, `exports` map, `files: [\"dist\", \"README.md\"]`, and `sideEffects: false` if safe.\n   - `tsconfig.json` and optionally `tsconfig.build.json` with incremental builds.\n   - `vitest.config.ts` if tests are present.\n2. Define clear dependencies:\n   - Internal deps via `workspace:*`.\n   - External host libs as `peerDependencies` (and mark optional when applicable).\n   - Optional providers/wallets as `optionalDependencies`.\n3. Expose subpaths deliberately (e.g., `./react`, `./vue`, `./utils`) only when stable and necessary.\n4. Keep layering intact: do not import up the stack; avoid cross-layer leakage.\n5. Add targeted unit tests for new behavior and update examples if developer UX changes.\n6. Run `pnpm build`, `pnpm run typecheck`, `pnpm run lint`, and `pnpm test` locally.\n\n### Adapter Authoring Guidelines\n\n- Mirror existing adapters for structure and scripts.\n- Depend on `@reown/appkit`, `@reown/appkit-controllers`, `@reown/appkit-utils`, `@reown/appkit-common`, and where needed `@reown/appkit-ui`.\n- Treat ecosystem SDKs as `peerDependencies` (e.g., `wagmi`, `viem`, `ethers`) to defer version control to the host app; use `optionalDependencies` for optional wallet SDKs (e.g., Coinbase, Safe).\n- Keep business logic inside controllers/utilities; adapters should translate between host SDK APIs and AppKit abstractions.\n\n### Import and API Design Best Practices (TypeScript)\n\n- Public APIs must be explicitly exported via the `exports` map and stable subpaths. Avoid deep internal imports.\n- Use `export type` for types-only exports to aid tree-shaking and ergonomics.\n- Prefer narrow, well-named interfaces and parameter objects over positional args.\n- Do not leak implementation-specific types from third-party SDKs across package boundaries; wrap or map to internal domain types.\n- Add `strict` TS configs and avoid `any`. Use discriminated unions for variant states.\n- Use early returns and guard clauses; avoid deep nesting.\n- Validate inputs near boundaries (e.g., adapter entrypoints). Use `zod` when schemas are involved.\n- Errors: throw typed errors or return structured `Result`-like objects where it improves developer ergonomics; never swallow exceptions.\n\n### Performance and Security Notes\n\n- Keep packages tree-shakeable; avoid top-level side effects and large transitive deps in core layers.\n- Use `peerDependencies` to avoid bundling multiple versions of large SDKs.\n- Be mindful of SSR: avoid direct `window` access in shared code; gate browser-only code.\n- Sanitize and validate user inputs in UI flows and adapters. Do not interpolate untrusted values into DOM without escaping.\n- Avoid logging secrets or PII. Use structured logs (debug-only in dev paths).\n\n### Practical Examples\n\nImports (prefer subpaths when they exist):\n\n```ts\nimport { createAppKit } from '@reown/appkit'\nimport { createWagmiAdapter } from '@reown/appkit-adapter-wagmi'\nimport { AccountController } from '@reown/appkit-controllers'\nimport { W3mModal } from '@reown/appkit-scaffold-ui/w3m-modal'\nimport { WuiButton } from '@reown/appkit-ui/wui-button'\n```\n\nReact/Vue subpaths (when provided):\n\n```ts\nimport { ControllersProvider } from '@reown/appkit-controllers/react'\nimport { AppKitProvider } from '@reown/appkit/react'\n```\n\n### What Cursor Should Assume When Editing\n\n- Respect the layering and import boundaries above. If a change requires crossing a boundary, propose an abstraction in a lower layer instead.\n- When adding a new exported module:\n  - Update the package `exports` map and type paths.\n  - Add unit tests and minimal examples.\n  - Keep `sideEffects: false` valid by avoiding module-level effects.\n- For UI changes:\n  - Add new components under `@reown/appkit-ui` with `wui-` prefix, minimal logic.\n  - Compose flows under `@reown/appkit-scaffold-ui`.\n  - Keep controllers/data-fetching outside UI layers.\n- For adapters:\n  - Prefer compile-time type safety over runtime checks; encode invariants in types.\n  - Ensure version constraints are compatible with examples and CDN builds.\n\n### Quick Map of Key Packages\n\n- `@reown/appkit` — SDK facade and top-level exports\n- `@reown/appkit-common` — shared types/utils\n- `@reown/appkit-wallet` — wallet models/utilities\n- `@reown/appkit-controllers` — stateful domain logic (valtio state)\n- `@reown/appkit-utils` — chain/wallet helpers\n- `@reown/appkit-ui` — base UI (Lit Web Components, `wui-*`)\n- `@reown/appkit-scaffold-ui` — modal/router/pay/onramp flows\n- `@reown/appkit-pay` — pay feature surface (UI + controllers)\n- `@reown/appkit-siwe` / `@reown/appkit-siwx` — auth flows and utilities\n- `@reown/appkit-universal-connector` — WalletConnect bridge\n- `@reown/appkit-adapter-*` — ecosystem adapters (Wagmi/Ethers/Ethers5/Solana/Bitcoin)\n- `@reown/appkit-polyfills` — browser polyfills\n- `@reown/appkit-cdn` — CDN bundles\n- `@reown/appkit-testing` — test harnesses\n- `@reown/appkit-cli` / `@reown/appkit-codemod` — dev tooling\n- `@reown/appkit-core` — legacy wrapper around controllers\n\n---\n\nIf a change seems to violate these rules, prefer refactoring toward these boundaries or proposing a clear abstraction that preserves the layering.\n",".cursor/rules/appkit-packages.mdc":"---\ndescription: Focused rules for working in packages (controllers, scaffold-ui views, new packages)\nglobs:\n  - 'packages/**'\nalwaysApply: false\n---\n\n## AppKit Packages Rules\n\nThese rules are scoped to `packages/**` and capture concrete, actionable guidance for day-to-day changes.\n\n### Controllers: State Management\n\n- Use `valtio/vanilla` `proxy` for state and `subscribeKey` for fine-grained subscriptions.\n- Keep controller surface small: `state` object and pure methods that mutate state.\n- Wrap controllers with `withErrorBoundary` to guard external call-sites.\n- Do not import UI code into controllers. Controllers depend only on foundations/utilities.\n- Example references:\n  - Router state shape and navigation: `packages/controllers/src/controllers/RouterController.ts`\n  - Proxy usage per chain: `packages/controllers/src/controllers/ChainController.ts`\n  - Error boundary util: `packages/controllers/src/utils/withErrorBoundary.ts`\n\nWhen updating state:\n\n- Prefer `replace`/`reset`/`push` style APIs for navigation and history changes.\n- Avoid deep nested state updates; compute next values and assign once.\n- Do not catch and swallow errors; either rethrow typed or use the error boundary.\n\n### Scaffold UI: Adding a New View\n\nUse Lit Web Components and the router:\n\n1. Create a view component under `packages/scaffold-ui/src/views/` named `w3m-my-feature-view`.\n2. Export it from the scaffold package (via existing barrel/exports pattern).\n3. Add a new discriminant to `RouterControllerState['view']` in `packages/controllers/src/controllers/RouterController.ts`.\n4. Map the new view in `packages/scaffold-ui/src/modal/w3m-router/index.ts` `viewTemplate` switch:\n   - Case: `'MyFeature'` → `<w3m-my-feature-view></w3m-my-feature-view>`.\n5. Navigate with `RouterController.push('MyFeature')` from actions.\n6. If the view participates in history transitions, no extra work is needed; `w3m-router-container` animates based on `history`.\n\nReferences:\n\n- Router container transitions: `packages/scaffold-ui/src/partials/w3m-router-container/index.ts`\n- Router view switch: `packages/scaffold-ui/src/modal/w3m-router/index.ts`\n- View enum and history: `packages/controllers/src/controllers/RouterController.ts`\n\nView guidelines:\n\n- Keep logic minimal in views; delegate to controllers/helpers.\n- Use `@reown/appkit-ui` primitives (`wui-*`) for visuals.\n- Avoid accessing `window` without SSR guards.\n\n### Adding a New Package\n\n1. Create `packages/<name>/` with ESM config and `exports` map.\n2. Dependencies:\n   - Internal deps as `workspace:*`.\n   - Host libraries as `peerDependencies` and optional wallets/providers as `optionalDependencies`.\n3. Scripts: `build:clean`, `build` (tsc --build), `watch`, `typecheck`, `lint`, `test` (vitest).\n4. Add `sideEffects: false` if safe; avoid top-level side effects.\n5. Expose subpaths deliberately (e.g., `./react`, `./vue`, `./utils`) only when stable.\n6. Add `vitest.config.ts` and `tests/` if applicable.\n7. Update examples or CDN if developer UX changes.\n\nChecklist snippet:\n\n```json\n{\n  \"type\": \"module\",\n  \"sideEffects\": false,\n  \"exports\": { \".\": { \"types\": \"./dist/types/index.d.ts\", \"import\": \"./dist/esm/index.js\" } }\n}\n```\n\n### TypeScript & API\n\n- Use `export type` for types-only exports.\n- Avoid `any`; prefer discriminated unions for variant states.\n- Do not leak third-party types across boundaries; map to internal domain types.\n- Validate adapter inputs with `zod` where schemas are involved.\n\n#### Public API and Breaking Changes\n\n- The `exports` entrypoints (e.g., `packages/appkit/exports/*.ts`) define the public SDK surface used by external developers.\n- Treat any change to exported functions, classes, or types as potentially breaking.\n- Follow semver: breaking changes require a major bump and a clear Changeset entry describing migration.\n- Prefer additive changes over mutations; deprecate first with JSDoc `@deprecated` and keep shims until the next major.\n- Keep exports stable and avoid re-exporting deep internals that may change frequently.\n\n### Security & Performance\n\n- Sanitize user inputs; avoid injecting untrusted values into DOM.\n- Keep packages tree-shakeable and SSR-safe.\n- Use `peerDependencies` for large host SDKs to avoid duplicate bundles.\n","AGENTS.md":"# AGENTS.md\n\nReown AppKit — a multi-chain onchain SDK providing wallet connection, authentication, swaps, on-ramp, and transaction UX for 700+ wallets across EVM, Solana, Bitcoin, Polkadot, and TON. Available for React, Next.js, Vue, Nuxt, Svelte, vanilla JS, React Native, Flutter, and native mobile.\n\n## Quick Reference\n\n- **Package manager**: pnpm workspaces (`pnpm-workspace.yaml`)\n- **Build orchestration**: Turborepo (`turbo.json`)\n- **State management**: valtio (always import from `valtio/vanilla`)\n- **UI framework**: LitElement Web Components\n- **Testing**: Vitest (unit), Playwright (E2E in `apps/laboratory`)\n- **TypeScript**: Strict mode, ESM only, `experimentalDecorators` enabled\n\n## Commands\n\n```bash\npnpm install              # Install dependencies\npnpm build                # Build all packages (run before apps or tests)\npnpm test                 # Unit tests (Vitest)\npnpm typecheck            # Type checking (depends on build)\npnpm lint                 # ESLint\npnpm run prettier:format  # Format code (run before committing)\npnpm changeset            # Create a changeset for versioning\npnpm laboratory           # Run E2E testing app\npnpm demo:dev             # Run demo app\npnpm gallery              # Run Storybook component gallery\n```\n\n## Repository Layout\n\n```\npackages/\n  appkit/              → @reown/appkit             Main SDK facade\n  controllers/         → @reown/appkit-controllers  Valtio state management\n  ui/                  → @reown/appkit-ui           Atomic wui-* Web Components\n  scaffold-ui/         → @reown/appkit-scaffold-ui  High-level w3m-* UI flows\n  common/              → @reown/appkit-common       Shared types and utilities\n  appkit-utils/        → @reown/appkit-utils        Chain-specific helpers\n  wallet/              → @reown/appkit-wallet       Wallet models\n  pay/                 → @reown/appkit-pay          Payment flows\n  siwe/                → @reown/appkit-siwe         Sign-In With Ethereum\n  siwx/                → @reown/appkit-siwx         Cross-chain authentication\n  adapters/\n    wagmi/             → EVM via Wagmi/Viem\n    ethers/            → EVM via ethers v6\n    ethers5/           → EVM via ethers v5\n    solana/            → Solana\n    bitcoin/           → Bitcoin\n    polkadot/          → Polkadot\n    ton/               → TON\napps/\n  laboratory/          → E2E testing (Next.js + Playwright)\n  demo/                → Marketing demo\n  gallery/             → Storybook component gallery\nexamples/              → Integration examples (next-*, react-*, vue-*, svelte-*, html-*)\n```\n\n## Architecture Rules\n\n### Layer Order (dependencies flow downward only)\n\n```\napps & examples\n  ↓\nadapters (wagmi, solana, bitcoin, ethers, ...)\n  ↓\n@reown/appkit (SDK facade)\n  ↓\nscaffold-ui (w3m-*) · pay\n  ↓\nui (wui-*) · controllers · appkit-utils\n  ↓\ncommon · wallet · polyfills\n```\n\n### Import Boundaries\n\n- **ui** (`wui-*`): Cannot import from controllers, scaffold-ui, appkit, or adapters\n- **controllers**: Cannot import from ui, scaffold-ui, appkit, or adapters\n- **scaffold-ui** (`w3m-*`): Uses relative imports within the package, not `@reown/` paths\n- **adapters**: Import from `@reown/appkit` and foundations, never from controllers or ui directly\n- **Cross-package**: Always use package entrypoints or declared subpath exports, never deep internal paths\n\n### Chain Namespaces\n\n| Namespace  | Chain    | Adapter                |\n| ---------- | -------- | ---------------------- |\n| `eip155`   | EVM      | wagmi, ethers, ethers5 |\n| `solana`   | Solana   | solana                 |\n| `bip122`   | Bitcoin  | bitcoin                |\n| `polkadot` | Polkadot | polkadot               |\n| `ton`      | TON      | ton                    |\n\n## Where to Put Things\n\n| What you're building     | Where it goes                                                                                           |\n| ------------------------ | ------------------------------------------------------------------------------------------------------- |\n| New state/business logic | `packages/controllers/src/controllers/` — follow [controller pattern](.agents/context/controllers.md)   |\n| New atomic UI element    | `packages/ui/src/composites/wui-<name>/` — follow [UI guide](.agents/context/ui-components.md)          |\n| New modal view/screen    | `packages/scaffold-ui/src/views/w3m-<name>-view/` — register in RouterController + w3m-router           |\n| Reusable UI section      | `packages/scaffold-ui/src/partials/w3m-<name>/`                                                         |\n| New blockchain adapter   | `packages/adapters/<name>/` — extend AdapterBlueprint, see [adapter guide](.agents/context/adapters.md) |\n| Shared types or utils    | `packages/common/src/`                                                                                  |\n| Chain-specific helpers   | `packages/appkit-utils/src/`                                                                            |\n| Public SDK API           | `packages/appkit/exports/` — treat changes as potentially breaking                                      |\n| Unit tests               | Co-located `tests/` directory in the relevant package                                                   |\n| E2E tests                | `apps/laboratory/tests/` using Page Object Model                                                        |\n| Integration example      | `examples/<framework>-<adapter>/`                                                                       |\n\n## Code Patterns\n\n### Controllers (valtio state)\n\n```typescript\n// packages/controllers/src/controllers/MyController.ts\nimport { proxy, subscribe as sub } from 'valtio/vanilla'\nimport { subscribeKey as subKey } from 'valtio/vanilla/utils'\n\n// -- Types ----\nexport interface MyControllerState {\n  value: string\n}\n\n// -- State ----\nconst state = proxy<MyControllerState>({ value: '' })\n\n// -- Controller ----\nconst controller = {\n  state,\n  subscribe(callback: (s: MyControllerState) => void) {\n    return sub(state, () => callback(state))\n  },\n  subscribeKey<K extends keyof MyControllerState>(key: K, cb: (v: MyControllerState[K]) => void) {\n    return subKey(state, key, cb)\n  },\n  setValue(v: string) {\n    state.value = v\n  }\n}\nexport const MyController = withErrorBoundary(controller)\n```\n\nSection comments (`// -- Types ----`, `// -- State ----`, `// -- Controller ----`) are enforced by DangerJS.\n\n### UI Atoms (wui-\\*)\n\n```typescript\n// packages/ui/src/composites/wui-my-thing/index.ts\n@customElement('wui-my-thing')\nexport class WuiMyThing extends LitElement {\n  public static override styles = [resetStyles, styles] // resetStyles required\n  // -- State & Properties ----\n  @property() public variant = 'default' // @state() NOT allowed\n  // -- Render ----\n  public override render() {\n    return html`<slot></slot>`\n  }\n}\n```\n\n### Scaffold Views (w3m-\\*)\n\n```typescript\n// packages/scaffold-ui/src/views/w3m-my-view/index.ts\n@customElement('w3m-my-view')\nexport class W3mMyView extends LitElement {\n  private unsubscribe: (() => void)[] = [] // Cleanup required\n  @state() private value = SomeController.state.value\n\n  constructor() {\n    super()\n    this.unsubscribe.push(\n      SomeController.subscribeKey('value', v => {\n        this.value = v\n      })\n    )\n  }\n\n  public override disconnectedCallback() {\n    this.unsubscribe.forEach(u => u())\n  }\n}\n```\n\n### Adapters\n\nExtend `AdapterBlueprint` from `packages/controllers/src/controllers/AdapterController/ChainAdapterBlueprint.ts`. Implement: `connect()`, `disconnect()`, `switchNetwork()`, `signMessage()`, `sendTransaction()`, `getBalance()`. Host SDKs go in `peerDependencies`.\n\n## PR Requirements\n\n1. Run `pnpm build && pnpm run prettier:format` before submitting\n2. Use conventional commit format for PR titles (`feat:`, `fix:`, `chore:`, `refactor:`, `test:`, `docs:`)\n3. Bug fixes and new features require tests\n4. Create a changeset: `pnpm changeset`\n5. DangerJS validates import boundaries, naming conventions, section comments, and dependency rules\n\n## Versioning\n\nAll `@reown/appkit-*` packages are versioned together as a fixed group via Changesets. Release channels: `latest`, `alpha`, `beta`, `canary`. `@examples/*` and `@apps/*` are excluded from publishing.\n\n## Detailed Context\n\nFor in-depth guidance on specific topics:\n\n- [Architecture & Initialization Flow](.agents/context/architecture.md) — layer diagram, import boundaries, init sequence, network request policy\n- [Controllers Reference](.agents/context/controllers.md) — valtio patterns, all controllers, state shapes\n- [UI Components Guide](.agents/context/ui-components.md) — wui-_ and w3m-_ patterns, DangerJS rules, adding views\n- [Blockchain Adapters Guide](.agents/context/adapters.md) — AdapterBlueprint, creating new adapters\n- [Testing Guide](.agents/context/testing.md) — Vitest, Playwright, test locations, writing new tests\n- [Package Reference](.agents/context/packages.md) — all packages, build outputs, adding packages\n- [Contributing & PR Guide](.agents/context/contributing.md) — PR checks, changesets, release process\n","CLAUDE.md":"AGENTS.md","packages/adapters/bitcoin/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n� [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・�📚 [Documentation](https://docs.reown.com/appkit/overview) ・� [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・�🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/adapters/ethers/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n� [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・�📚 [Documentation](https://docs.reown.com/appkit/overview) ・� [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・�🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/adapters/ethers5/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/adapters/polkadot/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/adapters/solana/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/adapters/ton/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/adapters/tron/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n� [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・�📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/adapters/wagmi/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/appkit-utils/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/appkit/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/cli/README.md":"# Reown AppKit CLI\n\n**AppKit CLI** is a command-line tool to fast download a funcionaly boilerplate example for Reown Web AppKit SDK.\n\n## Installation\n\nTo install this CLI tool globally for development, you can link it locally using the following commands.\n\n### Prerequisites\n\n- Node.js (v14 or later)\n- npm (v6 or later)\n\n### Clone the Repository\n\nFirst, clone this repository to your local machine:\n\n```bash\ngit clone https://github.com/reown-com/appkit-cli\ncd appkit-cli\n```\n\n### Local Installation\n\nTo test the CLI locally, use `npm link`. This allows you to run the CLI from any location on your machine.\n\n```bash\nnpm install\nsudo npm link\n```\n\n## Usage\n\nOnce linked, you can use the CLI globally by running:\n\n```bash\nappkit-cli\n```\n\nAlso you can run it directly:\n\n```bash\nnpx appkit-cli\n```\n\n### Example Commands\n\nProvide examples of some paramaeters:\n\n```bash\nappkit-cli [project-name]\n```\n\nFor example:\n\n```bash\nappkit-cli my-app\nappkit-cli\n```\n\n## Linking/Unlinking for Local Development\n\n### Linking\n\nIf you want to work on the CLI and test it locally without publishing, use `npm link`:\n\n1. **Navigate to the Project Directory**:\n\n   ```bash\n   cd path/to/appkit-cli\n   ```\n\n2. **Run npm link**:\n   ```bash\n   sudo npm link\n   ```\n\n### Unlinking\n\nTo remove the symlink and unlink the CLI, use:\n\n```bash\nsudo npm unlink -g\n```\n\nThis will unregister the global command `appkit-cli`, but it won’t delete any files in your project directory.\n\n### Quick Demo\n\nhttps://github.com/user-attachments/assets/6c4fbdc3-c0ca-4edd-a730-20cfee878c86\n","packages/codemod/README.md":"# Reown AppKit Codemod\n\n**AppKit Codemod** is a command-line tool designed to update dependencies across multiple `package.json` files in AppKit monorepo efficiently.\n\n### Codemod Features\n\nThe codemod tool allows you to update dependencies across multiple `package.json` files in your project. It supports:\n\n- **Multiple Package Updates**: Pass multiple package names to update them all at once.\n- **Wildcard Patterns**: Use patterns like `@walletconnect/*` to update all packages under a specific organization.\n- **Version Constraint Preservation**: Maintains version constraints like `\">=4.x.x\"` when updating.\n\n## Usage\n\nYou can use the Codemod globally using npx/pnpx:\n\n```bash\npnpx @reown/appkit-codemod <process> <args...>\n```\n\n### Options\n\n- `upgrade`: Updates dependencies to their latest versions across the monorepo.\n  - **Arguments**: One or more package names to upgrade, separated by spaces. Supports wildcards like `@org/*`.\n\nOr you can use the predefined scripts for local usage in the root of the monorepo:\n\n```bash\npnpm codemod:wc # This will upgrade all the @walletconnect/* dependencies\n```\n\n### Example Commands\n\nTo update dependencies using the codemod:\n\n```bash\nnpx appkit-codemod wagmi @wagmi/core @walletconnect/utils\nnpx appkit-codemod @walletconnect/*\n```\n","packages/common/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/controllers/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/core-legacy/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/experimental/README.md":"#### 📚 [Documentation](https://docs.reown.com/2.0/appkit/about)\n\n#### 🔗 [Website](https://reown.com/appkit)\n\n# AppKit Experimental (@reown/appkit-experimental)\n\nThe @reown/appkit-experimental package provides a set of cutting-edge, experimental features for Web3 developers. This package serves as a testing ground for innovative concepts and implementations that are not yet widely adopted or standardized in the blockchain ecosystem.\n\n## Key Characteristics\n\n- **Experimental Nature**: Features in this package are considered experimental and may undergo significant changes.\n- **EIP Implementation**: Includes implementations of non-finalized Ethereum Improvement Proposals (EIPs).\n- **Ecosystem Exploration**: Offers functionalities that are not yet widely adopted in the broader Web3 ecosystem.\n\n## Installation\n\n```bash\nnpm install @reown/appkit-experimental\n```\n\n## Smart Session\n\nThe `@reown/appkit-experimental/smart-session` allows developers to easily integrate session-based permission handling within their dApps. Using the `grantPermissions` method, dApps can send permission requests to connected wallets.\n","packages/polyfills/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/scaffold-ui/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/siwe/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n� [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・�📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/siwx/README.md":"#### 📚 [Documentation](https://docs.reown.com/2.0/appkit/about)\n\n#### 🔗 [Website](https://reown.com/appkit)\n\n# AppKit SIWX\n\nThe chain agnostic tool to enable authentication for AppKit applications.\n\n> [!WARNING]\n> This package is still in development and should not be used in production.\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n","packages/testing/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/ui/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n� [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・�📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/universal-connector/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/wallet/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n"},"files":{".cursor/commands/add-documentation.md":"# Add Documentation\n\nPlease add comprehensive documentation for the current code/feature. Include:\n\n## Overview\n\n- What this code/feature does\n- Why it exists and its purpose\n- Key concepts and terminology\n\n## API Documentation\n\n- Function/method signatures\n- Parameters and return values\n- Example usage with code snippets\n- Error handling and edge cases\n\n## Implementation Details\n\n- Architecture overview\n- Important design decisions\n- Dependencies and integrations\n\n## Examples\n\n- Common use cases with full examples\n- Best practices and patterns\n- Common pitfalls to avoid\n\nFormat the documentation according to the project's documentation standards and\ninclude it in the appropriate location (README, docs folder, or inline\ncomments).\n",".cursor/commands/address-github-pr-comments.md":"# Address GitHub PR Comments\n\n## Overview\n\nProcess outstanding reviewer feedback, apply required fixes, and draft clear\nresponses for each GitHub pull-request comment.\n\n## Steps\n\n1. **Sync and audit comments**\n   - Pull the latest branch changes\n   - Open the PR conversation view and read every unresolved comment\n   - Group comments by affected files or themes\n2. **Plan resolutions**\n   - List the requested code edits for each thread\n   - Identify clarifications or additional context you must provide\n   - Note any dependencies or blockers before implementing changes\n3. **Implement fixes**\n   - Apply targeted updates addressing one comment thread at a time\n   - Run relevant tests or linters after impactful changes\n   - Stage changes with commits that reference the addressed feedback\n4. **Draft responses**\n   - Summarize the action taken or reasoning provided for each comment\n   - Link to commits or lines when clarification helps reviewers verify\n   - Highlight any remaining questions or follow-up needs\n\n## Response Checklist\n\n- [ ] All reviewer comments acknowledged\n- [ ] Required code changes implemented and tested\n- [ ] Clarifying explanations prepared for nuanced threads\n- [ ] Follow-up items documented or escalated\n- [ ] PR status updated for reviewers\n",".cursor/commands/code-review.md":"# Code Review\n\n## Overview\n\nPerform a thorough code review that verifies functionality, maintainability, and\nsecurity before approving a change. Focus on architecture, readability,\nperformance implications, and provide actionable suggestions for improvement.\n\n## Steps\n\n1. **Understand the change**\n   - Read the PR description and related issues for context\n   - Identify the scope of files and features impacted\n   - Note any assumptions or questions to clarify with the author\n2. **Validate functionality**\n   - Confirm the code delivers the intended behavior\n   - Exercise edge cases or guard conditions mentally or by running locally\n   - Check error handling paths and logging for clarity\n3. **Assess quality**\n   - Ensure functions are focused, names are descriptive, and code is readable\n   - Watch for duplication, dead code, or missing tests\n   - Verify documentation and comments reflect the latest changes\n4. **Review security and risk**\n   - Look for injection points, insecure defaults, or missing validation\n   - Confirm secrets or credentials are not exposed\n   - Evaluate performance or scalability impacts of the change\n\n## Review Checklist\n\n### Functionality\n\n- [ ] Intended behavior works and matches requirements\n- [ ] Edge cases handled gracefully\n- [ ] Error handling is appropriate and informative\n\n### Code Quality\n\n- [ ] Code structure is clear and maintainable\n- [ ] No unnecessary duplication or dead code\n- [ ] Tests/documentation updated as needed\n\n### Security & Safety\n\n- [ ] No obvious security vulnerabilities introduced\n- [ ] Inputs validated and outputs sanitized\n- [ ] Sensitive data handled correctly\n\n## Additional Review Notes\n\n- Architecture and design decisions considered\n- Performance bottlenecks or regressions assessed\n- Coding standards and best practices followed\n- Resource management, error handling, and logging reviewed\n- Suggested alternatives, additional test cases, or documentation updates\n  captured\n\nProvide constructive feedback with concrete examples and actionable guidance for\nthe author.\n",".cursor/commands/debug-issue.md":"# Debug Issue\n\nHelp debug the current issue in the code. Please:\n\n## Problem Analysis\n\n- Identify the specific problem or error\n- Understand the expected vs actual behavior\n- Trace the execution flow to find the root cause\n\n## Debugging Strategy\n\n- Add appropriate logging statements\n- Suggest debugging tools and techniques\n- Identify key variables and states to monitor\n- Recommend breakpoint locations\n\n## Solution Approach\n\n- Propose potential fixes with explanations\n- Consider multiple solution approaches\n- Evaluate trade-offs of different approaches\n- Provide step-by-step resolution plan\n\n## Prevention\n\n- Suggest ways to prevent similar issues\n- Recommend additional tests or checks\n- Identify code patterns that could be improved\n\nWalk through the debugging process systematically and provide clear, actionable\nsolutions.\n",".cursor/commands/fix-git-issues.md":"# Fix Git Issues\n\nHelp resolve common Git problems and conflicts. Address:\n\n## Merge Conflicts\n\n- Analyze conflicting changes and their context\n- Provide resolution strategies for different conflict types\n- Suggest the best approach to preserve important changes\n- Generate resolved code maintaining functionality\n\n## Branch Management\n\n- Help with branch cleanup and organization\n- Suggest rebasing vs merging strategies\n- Assist with cherry-picking specific commits\n- Guide through complex branch operations\n\n## Commit History\n\n- Help with commit message improvements\n- Assist with squashing and organizing commits\n- Guide through interactive rebase operations\n- Fix commit authorship and metadata\n\n## Repository Issues\n\n- Help recover from detached HEAD state\n- Assist with undoing commits and changes\n- Guide through stash management\n- Resolve submodule and remote issues\n\nProvide step-by-step Git commands with explanations for each situation.\n",".cursor/commands/generate-pr-description.md":"# Generate PR Description\n\nCreate a comprehensive pull request description based on the changes in this\nbranch. Include:\n\n## Summary\n\nProvide a clear, concise summary of what this PR accomplishes.\n\n## Changes Made\n\n- List the key changes made in this PR\n- Include both code and non-code changes\n- Highlight any breaking changes\n\n## Testing\n\n- Describe how the changes were tested\n- Include any new test cases added\n- Note any manual testing performed\n\n## Related Issues\n\n- Link to any related issues or tickets\n- Use closing keywords if this PR resolves issues\n\n## Additional Notes\n\n- Any deployment considerations\n- Follow-up work required\n- Notes for reviewers\n\nFormat this as proper markdown for use in a GitHub PR description.\n",".cursor/commands/light-review-existing-diffs.md":"# Light Review Existing Diffs\n\n## Overview\n\nPerform a quick quality pass on current diffs to surface risky areas, ensure\npolish, and flag follow-up actions for deeper review.\n\n## Steps\n\n1. **Scan recent changes**\n   - List open branches or pending commits requiring review\n   - Skim side-by-side diffs focusing on new or modified files\n   - Note files or modules with large or complex edits\n2. **Assess quality signals**\n   - Watch for TODOs, debug code, or commented blocks needing cleanup\n   - Verify naming, formatting, and imports follow project standards\n   - Check that tests or documentation were updated when behavior changed\n3. **Flag next actions**\n   - Mark sections that warrant full review or pair programming\n   - Capture questions or uncertainties to raise with the author\n   - Document any quick fixes you can apply immediately\n\n## Review Checklist\n\n- [ ] High-risk files identified\n- [ ] Debugging artifacts removed or flagged\n- [ ] Style and conventions validated\n- [ ] Tests/docs updates confirmed or requested\n- [ ] Follow-up items recorded for deeper review\n",".cursor/commands/optimize-performance.md":"# Optimize Performance\n\nAnalyze the current code for performance bottlenecks and provide optimization\nrecommendations. Focus on:\n\n## Performance Analysis\n\n- Identify slow algorithms and inefficient data structures\n- Find memory leaks and excessive allocations\n- Detect unnecessary computations and redundant operations\n- Analyze database queries and API calls\n\n## Optimization Strategies\n\n- Suggest algorithm improvements and better data structures\n- Recommend caching strategies where appropriate\n- Propose lazy loading and pagination solutions\n- Identify opportunities for parallel processing\n\n## Implementation\n\n- Provide optimized code with explanations\n- Include performance impact estimates\n- Suggest profiling and monitoring approaches\n- Consider trade-offs between performance and maintainability\n\nFocus on measurable improvements while maintaining code quality and readability.\n",".cursor/rules/appkit-apps.mdc":"---\ndescription: Focused rules for working in apps (dev, testing, wiring AppKit into apps)\nglobs:\n  - 'apps/**'\nalwaysApply: false\n---\n\n## AppKit Apps Rules\n\nUse these when changing code under `apps/**`.\n\n### Development & Scripts\n\n- Use workspace scripts: `pnpm --filter @apps/<name> dev|build`.\n- Build dependencies first with `pnpm build` if packages changed.\n- Keep app configs minimal; rely on package exports and avoid deep imports.\n\n### Integrating AppKit\n\n- Import via facade or adapter packages, e.g.:\n  ```ts\n  import { createAppKit } from '@reown/appkit'\n  import { ControllersProvider } from '@reown/appkit-controllers/react'\n  ```\n- Prefer framework subpaths when available: `@reown/appkit/react`, `@reown/appkit-controllers/react`.\n\n### Testing\n\n- Vitest for unit/integration; Playwright in `apps/laboratory` for e2e.\n- Co-locate basic tests within app directories where meaningful; heavy e2e in laboratory app.\n\n### SSR & Client Boundaries\n\n- Guard browser-only APIs (e.g., `window`) for SSR routes.\n- Avoid importing `@reown/appkit-ui` directly in server components; use client components wrappers.\n",".cursor/rules/appkit-examples.mdc":"---\ndescription: Focused rules for examples (usage patterns, adapters, CDN builds)\nglobs:\n  - 'examples/**'\nalwaysApply: false\n---\n\n## AppKit Examples Rules\n\nThese rules apply to `examples/**`.\n\n### Usage Patterns\n\n- Import from public entrypoints of packages (`@reown/appkit`, `@reown/appkit-adapter-*`).\n- Do not deep import internal paths.\n- Keep example code minimal, readable, and framework-idiomatic.\n\n### Adapters & Peers\n\n- Respect `peerDependencies`: install `wagmi`/`viem`/`ethers` in examples that need them.\n- Prefer the adapter suited to the framework: wagmi for React, ethers for generic EVM, solana adapter for Solana.\n\n### CDN\n\n- For CDN-based examples, use `@reown/appkit-cdn` outputs and ensure polyfills are present when required.\n",".cursor/rules/appkit-monorepo.mdc":"---\ndescription: Monorepo-wide rules for Reown AppKit: structure, layering, packaging, and TS/SDK best practices\nglobs:\n  - \"packages/**\"\n  - \"apps/**\"\n  - \"examples/**\"\n  - \"services/**\"\n  - \"scripts/**\"\n  - \"turbo.json\"\n  - \"pnpm-workspace.yaml\"\n  - \"vitest.workspace.ts\"\nalwaysApply: true\n---\n\n## Cursor Rules: Reown AppKit Monorepo\n\nThis document orients Cursor to the structure, relationships, and common patterns across the Reown AppKit monorepo. It also encodes TypeScript and SDK development best practices to keep edits consistent, safe, and maintainable.\n\n### Monorepo Overview\n\n- **Package manager**: `pnpm` workspaces (`pnpm-workspace.yaml`)\n- **Build Orchestration**: `turbo` tasks (`turbo.json`) with cached `build`, `typecheck`, `lint`, `test`\n- **Testing**: `vitest` (workspace config in `vitest.workspace.ts`, default `jsdom` env)\n- **Repo roots**:\n  - `packages/` — publishable libraries and internal SDK modules\n  - `apps/` — product and demo applications (`gallery`, `laboratory`, `demo`, `browser-extension`)\n  - `examples/` — integration examples (Next, React, Vue, Svelte, plain HTML)\n  - `services/` — ancillary services (e.g., `id-allocation-service`)\n  - `scripts/`, `patches/`, root configs\n\n### High-Level Architecture and Package Roles\n\n- **SDK Facade**: `@reown/appkit`\n\n  - Public, framework-agnostic entrypoint. Re-exports subdomains and framework layers via subpath exports.\n  - Depends on: `@reown/appkit-common`, `@reown/appkit-controllers`, `@reown/appkit-pay`, `@reown/appkit-polyfills`, `@reown/appkit-scaffold-ui`, `@reown/appkit-ui`, `@reown/appkit-utils`, `@reown/appkit-wallet`, plus ecosystem deps (`valtio`, `viem`, `@walletconnect/universal-provider`).\n  - Provides subpaths like `./react`, `./vue`, `./utils`, `./adapters`, `./connectors`, etc.\n\n- **Domain Foundations**:\n\n  - `@reown/appkit-common`: shared types, math/date utils, light helpers. ESM only.\n  - `@reown/appkit-wallet`: wallet models, schema validation, core wallet utilities (depends on `common`, `polyfills`).\n  - `@reown/appkit-controllers`: stateful logic and business rules, with `valtio` for reactive state. Framework-agnostic; provides optional `react`/`vue` subpaths.\n  - `@reown/appkit-utils`: integration helpers per chain/family (Ethers, Solana, Bitcoin, Wallet Standard). Depends on `common`, `controllers`, `wallet`, `polyfills`.\n\n- **UI Layers**:\n\n  - `@reown/appkit-ui`: low-level UI as Web Components (Lit). Exports many `wui-*` components; no app logic.\n  - `@reown/appkit-scaffold-ui`: mid/high-level UI flows (modal, router containers, pay/onramp flows). Composes `@reown/appkit-ui` and `controllers`.\n  - `@reown/appkit-wallet-button`: focused UI package that composes `ui`, `controllers`, `utils`; optional `@lit/react` wrapper.\n\n- **Authentication and Pay**:\n\n  - `@reown/appkit-siwe`: Sign-In With Ethereum UX + controllers integration.\n  - `@reown/appkit-siwx`: Cross-chain SIWx utilities for EVM, Solana, Bitcoin, etc. No direct UI dependency.\n  - `@reown/appkit-pay`: UI + state for pay flows; composes `ui`, `controllers`, `utils`.\n\n- **Adapters (ecosystem integrations)**: `packages/adapters/*`\n\n  - `@reown/appkit-adapter-wagmi`, `-ethers`, `-ethers5`, `-solana`, `-bitcoin` (and private `-polkadot`).\n  - All depend on `@reown/appkit` + foundations; expose framework subpaths when relevant (`react`, `vue` in some packages).\n  - Use `peerDependencies` for host frameworks/SDKs (e.g., `wagmi`, `viem`, `ethers`) and `optionalDependencies` for optional wallets/providers.\n\n- **Bridging, Polyfills, Experimental, CDN**:\n\n  - `@reown/appkit-universal-connector`: thin bridge to `@walletconnect/universal-provider`.\n  - `@reown/appkit-polyfills`: browser `buffer` and similar shims.\n  - `@reown/appkit-experimental`: gated/unstable features (e.g., smart session). Depends on core packages.\n  - `@reown/appkit-cdn`: prebundled CDN builds (not tree-shaken by consumers). Depends on `appkit` and adapters.\n\n- **Tooling**:\n  - `@reown/appkit-testing`: test harnesses (includes Playwright for e2e; depends on `@reown/appkit`).\n  - `@reown/appkit-cli`: simple scaffolding/utility CLI.\n  - `@reown/appkit-codemod`: upgrade helper for dependency migrations.\n  - `@reown/appkit-core` (in `core-legacy/`): legacy compatibility wrapper around controllers.\n\n### Allowed Dependencies and Import Boundaries\n\n- Favor a layered graph from foundations → controllers → ui/scaffold → appkit (facade) → adapters/apps.\n- Avoid cyclical imports. Do not import upward across layers (e.g., `ui` must not import from `appkit` or app code).\n- Only import via package entrypoints or declared subpath exports; avoid deep, relative cross-package imports.\n  - Good: `import { X } from '@reown/appkit-controllers'`\n  - Good: `import { WuiButton } from '@reown/appkit-ui/wui-button'`\n  - Avoid: `import { X } from '@reown/appkit-controllers/dist/...` (internal paths are not stable)\n- Framework subpaths are explicitly exported (e.g., `./react`, `./vue`) when available; prefer those over bundling framework internals.\n- Keep optional or host-specific libraries as `peerDependencies` (e.g., `wagmi`, `viem`, `ethers`) and mark optional features as `optionalDependencies` to keep the core light.\n\n### Packaging and Build Conventions\n\n- All packages are ESM (`\"type\": \"module\"`).\n- Build outputs:\n  - JS: `dist/esm/...`\n  - Types: `dist/types/...`\n  - `package.json` uses `exports` map and (where relevant) `typesVersions` for editor compatibility.\n- Use `\"sideEffects\": false` when the package is tree-shakeable (most are). Ensure top-level side effects are avoided.\n- Scripts:\n  - `build:clean`: remove `dist`\n  - `build`: `tsc --build` (some use `tsconfig.build.json`)\n  - `watch`: `tsc --watch`\n  - `typecheck`: `tsc --noEmit`\n  - `lint`: ESLint across TS/JS files\n  - `test`: Vitest (most with coverage)\n- Orchestration:\n  - Use `turbo run build --filter={./packages/**/*}` for workspace builds.\n  - `typecheck` and `lint` are cached by turbo; `test` is typically not cached.\n\n### UI Patterns\n\n- Base UI uses Lit Web Components, exported as `wui-*` elements from `@reown/appkit-ui`.\n- Higher-level UI flows and composition live in `@reown/appkit-scaffold-ui` and focus on orchestration (modal, router container, lists, pay/onramp flows).\n- Do not embed business logic into `@reown/appkit-ui`. Use `controllers`/`utils` for non-visual logic and data.\n- If providing React wrappers for Web Components, expose them via explicit subpath exports (e.g., `./react`) and keep them optional to avoid forcing React in core packages.\n\n### State, Data, and External SDKs\n\n- State management is uniform with `valtio`. Controllers own reactive state; UI subscribes.\n- EVM stack uses `viem` and `wagmi` (in adapters). Solana uses `@solana/web3.js` and wallet-standard libs. Bitcoin uses `bitcoinjs-lib`, `sats-connect`.\n- WalletConnect v2 is integrated via `@walletconnect/universal-provider`. Keep provider interactions isolated in `controllers`/`utils`/adapters.\n\n### Testing Conventions\n\n- `vitest` with `jsdom` by default for DOM-related packages; Node for pure utility packages as needed.\n- Place tests under `tests/` per package.\n- `@reown/appkit-testing` includes shared testing utilities and e2e dependencies (e.g., Playwright) but is not a runtime dependency.\n\n### Versioning and Release\n\n- Managed with `changesets`. Some overrides/patches exist under `patches/`.\n- Internal packages use `workspace:*` ranges to synchronize versions.\n- Keep public API changes aggregated through `@reown/appkit` where possible to minimize breaking surface area.\n\n### Adding or Modifying Packages (Checklist)\n\n1. Create a new package under `packages/<name>` with:\n   - `package.json` using ESM, `exports` map, `files: [\"dist\", \"README.md\"]`, and `sideEffects: false` if safe.\n   - `tsconfig.json` and optionally `tsconfig.build.json` with incremental builds.\n   - `vitest.config.ts` if tests are present.\n2. Define clear dependencies:\n   - Internal deps via `workspace:*`.\n   - External host libs as `peerDependencies` (and mark optional when applicable).\n   - Optional providers/wallets as `optionalDependencies`.\n3. Expose subpaths deliberately (e.g., `./react`, `./vue`, `./utils`) only when stable and necessary.\n4. Keep layering intact: do not import up the stack; avoid cross-layer leakage.\n5. Add targeted unit tests for new behavior and update examples if developer UX changes.\n6. Run `pnpm build`, `pnpm run typecheck`, `pnpm run lint`, and `pnpm test` locally.\n\n### Adapter Authoring Guidelines\n\n- Mirror existing adapters for structure and scripts.\n- Depend on `@reown/appkit`, `@reown/appkit-controllers`, `@reown/appkit-utils`, `@reown/appkit-common`, and where needed `@reown/appkit-ui`.\n- Treat ecosystem SDKs as `peerDependencies` (e.g., `wagmi`, `viem`, `ethers`) to defer version control to the host app; use `optionalDependencies` for optional wallet SDKs (e.g., Coinbase, Safe).\n- Keep business logic inside controllers/utilities; adapters should translate between host SDK APIs and AppKit abstractions.\n\n### Import and API Design Best Practices (TypeScript)\n\n- Public APIs must be explicitly exported via the `exports` map and stable subpaths. Avoid deep internal imports.\n- Use `export type` for types-only exports to aid tree-shaking and ergonomics.\n- Prefer narrow, well-named interfaces and parameter objects over positional args.\n- Do not leak implementation-specific types from third-party SDKs across package boundaries; wrap or map to internal domain types.\n- Add `strict` TS configs and avoid `any`. Use discriminated unions for variant states.\n- Use early returns and guard clauses; avoid deep nesting.\n- Validate inputs near boundaries (e.g., adapter entrypoints). Use `zod` when schemas are involved.\n- Errors: throw typed errors or return structured `Result`-like objects where it improves developer ergonomics; never swallow exceptions.\n\n### Performance and Security Notes\n\n- Keep packages tree-shakeable; avoid top-level side effects and large transitive deps in core layers.\n- Use `peerDependencies` to avoid bundling multiple versions of large SDKs.\n- Be mindful of SSR: avoid direct `window` access in shared code; gate browser-only code.\n- Sanitize and validate user inputs in UI flows and adapters. Do not interpolate untrusted values into DOM without escaping.\n- Avoid logging secrets or PII. Use structured logs (debug-only in dev paths).\n\n### Practical Examples\n\nImports (prefer subpaths when they exist):\n\n```ts\nimport { createAppKit } from '@reown/appkit'\nimport { createWagmiAdapter } from '@reown/appkit-adapter-wagmi'\nimport { AccountController } from '@reown/appkit-controllers'\nimport { W3mModal } from '@reown/appkit-scaffold-ui/w3m-modal'\nimport { WuiButton } from '@reown/appkit-ui/wui-button'\n```\n\nReact/Vue subpaths (when provided):\n\n```ts\nimport { ControllersProvider } from '@reown/appkit-controllers/react'\nimport { AppKitProvider } from '@reown/appkit/react'\n```\n\n### What Cursor Should Assume When Editing\n\n- Respect the layering and import boundaries above. If a change requires crossing a boundary, propose an abstraction in a lower layer instead.\n- When adding a new exported module:\n  - Update the package `exports` map and type paths.\n  - Add unit tests and minimal examples.\n  - Keep `sideEffects: false` valid by avoiding module-level effects.\n- For UI changes:\n  - Add new components under `@reown/appkit-ui` with `wui-` prefix, minimal logic.\n  - Compose flows under `@reown/appkit-scaffold-ui`.\n  - Keep controllers/data-fetching outside UI layers.\n- For adapters:\n  - Prefer compile-time type safety over runtime checks; encode invariants in types.\n  - Ensure version constraints are compatible with examples and CDN builds.\n\n### Quick Map of Key Packages\n\n- `@reown/appkit` — SDK facade and top-level exports\n- `@reown/appkit-common` — shared types/utils\n- `@reown/appkit-wallet` — wallet models/utilities\n- `@reown/appkit-controllers` — stateful domain logic (valtio state)\n- `@reown/appkit-utils` — chain/wallet helpers\n- `@reown/appkit-ui` — base UI (Lit Web Components, `wui-*`)\n- `@reown/appkit-scaffold-ui` — modal/router/pay/onramp flows\n- `@reown/appkit-pay` — pay feature surface (UI + controllers)\n- `@reown/appkit-siwe` / `@reown/appkit-siwx` — auth flows and utilities\n- `@reown/appkit-universal-connector` — WalletConnect bridge\n- `@reown/appkit-adapter-*` — ecosystem adapters (Wagmi/Ethers/Ethers5/Solana/Bitcoin)\n- `@reown/appkit-polyfills` — browser polyfills\n- `@reown/appkit-cdn` — CDN bundles\n- `@reown/appkit-testing` — test harnesses\n- `@reown/appkit-cli` / `@reown/appkit-codemod` — dev tooling\n- `@reown/appkit-core` — legacy wrapper around controllers\n\n---\n\nIf a change seems to violate these rules, prefer refactoring toward these boundaries or proposing a clear abstraction that preserves the layering.\n",".cursor/rules/appkit-packages.mdc":"---\ndescription: Focused rules for working in packages (controllers, scaffold-ui views, new packages)\nglobs:\n  - 'packages/**'\nalwaysApply: false\n---\n\n## AppKit Packages Rules\n\nThese rules are scoped to `packages/**` and capture concrete, actionable guidance for day-to-day changes.\n\n### Controllers: State Management\n\n- Use `valtio/vanilla` `proxy` for state and `subscribeKey` for fine-grained subscriptions.\n- Keep controller surface small: `state` object and pure methods that mutate state.\n- Wrap controllers with `withErrorBoundary` to guard external call-sites.\n- Do not import UI code into controllers. Controllers depend only on foundations/utilities.\n- Example references:\n  - Router state shape and navigation: `packages/controllers/src/controllers/RouterController.ts`\n  - Proxy usage per chain: `packages/controllers/src/controllers/ChainController.ts`\n  - Error boundary util: `packages/controllers/src/utils/withErrorBoundary.ts`\n\nWhen updating state:\n\n- Prefer `replace`/`reset`/`push` style APIs for navigation and history changes.\n- Avoid deep nested state updates; compute next values and assign once.\n- Do not catch and swallow errors; either rethrow typed or use the error boundary.\n\n### Scaffold UI: Adding a New View\n\nUse Lit Web Components and the router:\n\n1. Create a view component under `packages/scaffold-ui/src/views/` named `w3m-my-feature-view`.\n2. Export it from the scaffold package (via existing barrel/exports pattern).\n3. Add a new discriminant to `RouterControllerState['view']` in `packages/controllers/src/controllers/RouterController.ts`.\n4. Map the new view in `packages/scaffold-ui/src/modal/w3m-router/index.ts` `viewTemplate` switch:\n   - Case: `'MyFeature'` → `<w3m-my-feature-view></w3m-my-feature-view>`.\n5. Navigate with `RouterController.push('MyFeature')` from actions.\n6. If the view participates in history transitions, no extra work is needed; `w3m-router-container` animates based on `history`.\n\nReferences:\n\n- Router container transitions: `packages/scaffold-ui/src/partials/w3m-router-container/index.ts`\n- Router view switch: `packages/scaffold-ui/src/modal/w3m-router/index.ts`\n- View enum and history: `packages/controllers/src/controllers/RouterController.ts`\n\nView guidelines:\n\n- Keep logic minimal in views; delegate to controllers/helpers.\n- Use `@reown/appkit-ui` primitives (`wui-*`) for visuals.\n- Avoid accessing `window` without SSR guards.\n\n### Adding a New Package\n\n1. Create `packages/<name>/` with ESM config and `exports` map.\n2. Dependencies:\n   - Internal deps as `workspace:*`.\n   - Host libraries as `peerDependencies` and optional wallets/providers as `optionalDependencies`.\n3. Scripts: `build:clean`, `build` (tsc --build), `watch`, `typecheck`, `lint`, `test` (vitest).\n4. Add `sideEffects: false` if safe; avoid top-level side effects.\n5. Expose subpaths deliberately (e.g., `./react`, `./vue`, `./utils`) only when stable.\n6. Add `vitest.config.ts` and `tests/` if applicable.\n7. Update examples or CDN if developer UX changes.\n\nChecklist snippet:\n\n```json\n{\n  \"type\": \"module\",\n  \"sideEffects\": false,\n  \"exports\": { \".\": { \"types\": \"./dist/types/index.d.ts\", \"import\": \"./dist/esm/index.js\" } }\n}\n```\n\n### TypeScript & API\n\n- Use `export type` for types-only exports.\n- Avoid `any`; prefer discriminated unions for variant states.\n- Do not leak third-party types across boundaries; map to internal domain types.\n- Validate adapter inputs with `zod` where schemas are involved.\n\n#### Public API and Breaking Changes\n\n- The `exports` entrypoints (e.g., `packages/appkit/exports/*.ts`) define the public SDK surface used by external developers.\n- Treat any change to exported functions, classes, or types as potentially breaking.\n- Follow semver: breaking changes require a major bump and a clear Changeset entry describing migration.\n- Prefer additive changes over mutations; deprecate first with JSDoc `@deprecated` and keep shims until the next major.\n- Keep exports stable and avoid re-exporting deep internals that may change frequently.\n\n### Security & Performance\n\n- Sanitize user inputs; avoid injecting untrusted values into DOM.\n- Keep packages tree-shakeable and SSR-safe.\n- Use `peerDependencies` for large host SDKs to avoid duplicate bundles.\n","AGENTS.md":"# AGENTS.md\n\nReown AppKit — a multi-chain onchain SDK providing wallet connection, authentication, swaps, on-ramp, and transaction UX for 700+ wallets across EVM, Solana, Bitcoin, Polkadot, and TON. Available for React, Next.js, Vue, Nuxt, Svelte, vanilla JS, React Native, Flutter, and native mobile.\n\n## Quick Reference\n\n- **Package manager**: pnpm workspaces (`pnpm-workspace.yaml`)\n- **Build orchestration**: Turborepo (`turbo.json`)\n- **State management**: valtio (always import from `valtio/vanilla`)\n- **UI framework**: LitElement Web Components\n- **Testing**: Vitest (unit), Playwright (E2E in `apps/laboratory`)\n- **TypeScript**: Strict mode, ESM only, `experimentalDecorators` enabled\n\n## Commands\n\n```bash\npnpm install              # Install dependencies\npnpm build                # Build all packages (run before apps or tests)\npnpm test                 # Unit tests (Vitest)\npnpm typecheck            # Type checking (depends on build)\npnpm lint                 # ESLint\npnpm run prettier:format  # Format code (run before committing)\npnpm changeset            # Create a changeset for versioning\npnpm laboratory           # Run E2E testing app\npnpm demo:dev             # Run demo app\npnpm gallery              # Run Storybook component gallery\n```\n\n## Repository Layout\n\n```\npackages/\n  appkit/              → @reown/appkit             Main SDK facade\n  controllers/         → @reown/appkit-controllers  Valtio state management\n  ui/                  → @reown/appkit-ui           Atomic wui-* Web Components\n  scaffold-ui/         → @reown/appkit-scaffold-ui  High-level w3m-* UI flows\n  common/              → @reown/appkit-common       Shared types and utilities\n  appkit-utils/        → @reown/appkit-utils        Chain-specific helpers\n  wallet/              → @reown/appkit-wallet       Wallet models\n  pay/                 → @reown/appkit-pay          Payment flows\n  siwe/                → @reown/appkit-siwe         Sign-In With Ethereum\n  siwx/                → @reown/appkit-siwx         Cross-chain authentication\n  adapters/\n    wagmi/             → EVM via Wagmi/Viem\n    ethers/            → EVM via ethers v6\n    ethers5/           → EVM via ethers v5\n    solana/            → Solana\n    bitcoin/           → Bitcoin\n    polkadot/          → Polkadot\n    ton/               → TON\napps/\n  laboratory/          → E2E testing (Next.js + Playwright)\n  demo/                → Marketing demo\n  gallery/             → Storybook component gallery\nexamples/              → Integration examples (next-*, react-*, vue-*, svelte-*, html-*)\n```\n\n## Architecture Rules\n\n### Layer Order (dependencies flow downward only)\n\n```\napps & examples\n  ↓\nadapters (wagmi, solana, bitcoin, ethers, ...)\n  ↓\n@reown/appkit (SDK facade)\n  ↓\nscaffold-ui (w3m-*) · pay\n  ↓\nui (wui-*) · controllers · appkit-utils\n  ↓\ncommon · wallet · polyfills\n```\n\n### Import Boundaries\n\n- **ui** (`wui-*`): Cannot import from controllers, scaffold-ui, appkit, or adapters\n- **controllers**: Cannot import from ui, scaffold-ui, appkit, or adapters\n- **scaffold-ui** (`w3m-*`): Uses relative imports within the package, not `@reown/` paths\n- **adapters**: Import from `@reown/appkit` and foundations, never from controllers or ui directly\n- **Cross-package**: Always use package entrypoints or declared subpath exports, never deep internal paths\n\n### Chain Namespaces\n\n| Namespace  | Chain    | Adapter                |\n| ---------- | -------- | ---------------------- |\n| `eip155`   | EVM      | wagmi, ethers, ethers5 |\n| `solana`   | Solana   | solana                 |\n| `bip122`   | Bitcoin  | bitcoin                |\n| `polkadot` | Polkadot | polkadot               |\n| `ton`      | TON      | ton                    |\n\n## Where to Put Things\n\n| What you're building     | Where it goes                                                                                           |\n| ------------------------ | ------------------------------------------------------------------------------------------------------- |\n| New state/business logic | `packages/controllers/src/controllers/` — follow [controller pattern](.agents/context/controllers.md)   |\n| New atomic UI element    | `packages/ui/src/composites/wui-<name>/` — follow [UI guide](.agents/context/ui-components.md)          |\n| New modal view/screen    | `packages/scaffold-ui/src/views/w3m-<name>-view/` — register in RouterController + w3m-router           |\n| Reusable UI section      | `packages/scaffold-ui/src/partials/w3m-<name>/`                                                         |\n| New blockchain adapter   | `packages/adapters/<name>/` — extend AdapterBlueprint, see [adapter guide](.agents/context/adapters.md) |\n| Shared types or utils    | `packages/common/src/`                                                                                  |\n| Chain-specific helpers   | `packages/appkit-utils/src/`                                                                            |\n| Public SDK API           | `packages/appkit/exports/` — treat changes as potentially breaking                                      |\n| Unit tests               | Co-located `tests/` directory in the relevant package                                                   |\n| E2E tests                | `apps/laboratory/tests/` using Page Object Model                                                        |\n| Integration example      | `examples/<framework>-<adapter>/`                                                                       |\n\n## Code Patterns\n\n### Controllers (valtio state)\n\n```typescript\n// packages/controllers/src/controllers/MyController.ts\nimport { proxy, subscribe as sub } from 'valtio/vanilla'\nimport { subscribeKey as subKey } from 'valtio/vanilla/utils'\n\n// -- Types ----\nexport interface MyControllerState {\n  value: string\n}\n\n// -- State ----\nconst state = proxy<MyControllerState>({ value: '' })\n\n// -- Controller ----\nconst controller = {\n  state,\n  subscribe(callback: (s: MyControllerState) => void) {\n    return sub(state, () => callback(state))\n  },\n  subscribeKey<K extends keyof MyControllerState>(key: K, cb: (v: MyControllerState[K]) => void) {\n    return subKey(state, key, cb)\n  },\n  setValue(v: string) {\n    state.value = v\n  }\n}\nexport const MyController = withErrorBoundary(controller)\n```\n\nSection comments (`// -- Types ----`, `// -- State ----`, `// -- Controller ----`) are enforced by DangerJS.\n\n### UI Atoms (wui-\\*)\n\n```typescript\n// packages/ui/src/composites/wui-my-thing/index.ts\n@customElement('wui-my-thing')\nexport class WuiMyThing extends LitElement {\n  public static override styles = [resetStyles, styles] // resetStyles required\n  // -- State & Properties ----\n  @property() public variant = 'default' // @state() NOT allowed\n  // -- Render ----\n  public override render() {\n    return html`<slot></slot>`\n  }\n}\n```\n\n### Scaffold Views (w3m-\\*)\n\n```typescript\n// packages/scaffold-ui/src/views/w3m-my-view/index.ts\n@customElement('w3m-my-view')\nexport class W3mMyView extends LitElement {\n  private unsubscribe: (() => void)[] = [] // Cleanup required\n  @state() private value = SomeController.state.value\n\n  constructor() {\n    super()\n    this.unsubscribe.push(\n      SomeController.subscribeKey('value', v => {\n        this.value = v\n      })\n    )\n  }\n\n  public override disconnectedCallback() {\n    this.unsubscribe.forEach(u => u())\n  }\n}\n```\n\n### Adapters\n\nExtend `AdapterBlueprint` from `packages/controllers/src/controllers/AdapterController/ChainAdapterBlueprint.ts`. Implement: `connect()`, `disconnect()`, `switchNetwork()`, `signMessage()`, `sendTransaction()`, `getBalance()`. Host SDKs go in `peerDependencies`.\n\n## PR Requirements\n\n1. Run `pnpm build && pnpm run prettier:format` before submitting\n2. Use conventional commit format for PR titles (`feat:`, `fix:`, `chore:`, `refactor:`, `test:`, `docs:`)\n3. Bug fixes and new features require tests\n4. Create a changeset: `pnpm changeset`\n5. DangerJS validates import boundaries, naming conventions, section comments, and dependency rules\n\n## Versioning\n\nAll `@reown/appkit-*` packages are versioned together as a fixed group via Changesets. Release channels: `latest`, `alpha`, `beta`, `canary`. `@examples/*` and `@apps/*` are excluded from publishing.\n\n## Detailed Context\n\nFor in-depth guidance on specific topics:\n\n- [Architecture & Initialization Flow](.agents/context/architecture.md) — layer diagram, import boundaries, init sequence, network request policy\n- [Controllers Reference](.agents/context/controllers.md) — valtio patterns, all controllers, state shapes\n- [UI Components Guide](.agents/context/ui-components.md) — wui-_ and w3m-_ patterns, DangerJS rules, adding views\n- [Blockchain Adapters Guide](.agents/context/adapters.md) — AdapterBlueprint, creating new adapters\n- [Testing Guide](.agents/context/testing.md) — Vitest, Playwright, test locations, writing new tests\n- [Package Reference](.agents/context/packages.md) — all packages, build outputs, adding packages\n- [Contributing & PR Guide](.agents/context/contributing.md) — PR checks, changesets, release process\n","CLAUDE.md":"AGENTS.md","packages/adapters/bitcoin/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n� [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・�📚 [Documentation](https://docs.reown.com/appkit/overview) ・� [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・�🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/adapters/ethers/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n� [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・�📚 [Documentation](https://docs.reown.com/appkit/overview) ・� [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・�🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/adapters/ethers5/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/adapters/polkadot/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/adapters/solana/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/adapters/ton/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/adapters/tron/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n� [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・�📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/adapters/wagmi/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/appkit-utils/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/appkit/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/cli/README.md":"# Reown AppKit CLI\n\n**AppKit CLI** is a command-line tool to fast download a funcionaly boilerplate example for Reown Web AppKit SDK.\n\n## Installation\n\nTo install this CLI tool globally for development, you can link it locally using the following commands.\n\n### Prerequisites\n\n- Node.js (v14 or later)\n- npm (v6 or later)\n\n### Clone the Repository\n\nFirst, clone this repository to your local machine:\n\n```bash\ngit clone https://github.com/reown-com/appkit-cli\ncd appkit-cli\n```\n\n### Local Installation\n\nTo test the CLI locally, use `npm link`. This allows you to run the CLI from any location on your machine.\n\n```bash\nnpm install\nsudo npm link\n```\n\n## Usage\n\nOnce linked, you can use the CLI globally by running:\n\n```bash\nappkit-cli\n```\n\nAlso you can run it directly:\n\n```bash\nnpx appkit-cli\n```\n\n### Example Commands\n\nProvide examples of some paramaeters:\n\n```bash\nappkit-cli [project-name]\n```\n\nFor example:\n\n```bash\nappkit-cli my-app\nappkit-cli\n```\n\n## Linking/Unlinking for Local Development\n\n### Linking\n\nIf you want to work on the CLI and test it locally without publishing, use `npm link`:\n\n1. **Navigate to the Project Directory**:\n\n   ```bash\n   cd path/to/appkit-cli\n   ```\n\n2. **Run npm link**:\n   ```bash\n   sudo npm link\n   ```\n\n### Unlinking\n\nTo remove the symlink and unlink the CLI, use:\n\n```bash\nsudo npm unlink -g\n```\n\nThis will unregister the global command `appkit-cli`, but it won’t delete any files in your project directory.\n\n### Quick Demo\n\nhttps://github.com/user-attachments/assets/6c4fbdc3-c0ca-4edd-a730-20cfee878c86\n","packages/codemod/README.md":"# Reown AppKit Codemod\n\n**AppKit Codemod** is a command-line tool designed to update dependencies across multiple `package.json` files in AppKit monorepo efficiently.\n\n### Codemod Features\n\nThe codemod tool allows you to update dependencies across multiple `package.json` files in your project. It supports:\n\n- **Multiple Package Updates**: Pass multiple package names to update them all at once.\n- **Wildcard Patterns**: Use patterns like `@walletconnect/*` to update all packages under a specific organization.\n- **Version Constraint Preservation**: Maintains version constraints like `\">=4.x.x\"` when updating.\n\n## Usage\n\nYou can use the Codemod globally using npx/pnpx:\n\n```bash\npnpx @reown/appkit-codemod <process> <args...>\n```\n\n### Options\n\n- `upgrade`: Updates dependencies to their latest versions across the monorepo.\n  - **Arguments**: One or more package names to upgrade, separated by spaces. Supports wildcards like `@org/*`.\n\nOr you can use the predefined scripts for local usage in the root of the monorepo:\n\n```bash\npnpm codemod:wc # This will upgrade all the @walletconnect/* dependencies\n```\n\n### Example Commands\n\nTo update dependencies using the codemod:\n\n```bash\nnpx appkit-codemod wagmi @wagmi/core @walletconnect/utils\nnpx appkit-codemod @walletconnect/*\n```\n","packages/common/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/controllers/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/core-legacy/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/experimental/README.md":"#### 📚 [Documentation](https://docs.reown.com/2.0/appkit/about)\n\n#### 🔗 [Website](https://reown.com/appkit)\n\n# AppKit Experimental (@reown/appkit-experimental)\n\nThe @reown/appkit-experimental package provides a set of cutting-edge, experimental features for Web3 developers. This package serves as a testing ground for innovative concepts and implementations that are not yet widely adopted or standardized in the blockchain ecosystem.\n\n## Key Characteristics\n\n- **Experimental Nature**: Features in this package are considered experimental and may undergo significant changes.\n- **EIP Implementation**: Includes implementations of non-finalized Ethereum Improvement Proposals (EIPs).\n- **Ecosystem Exploration**: Offers functionalities that are not yet widely adopted in the broader Web3 ecosystem.\n\n## Installation\n\n```bash\nnpm install @reown/appkit-experimental\n```\n\n## Smart Session\n\nThe `@reown/appkit-experimental/smart-session` allows developers to easily integrate session-based permission handling within their dApps. Using the `grantPermissions` method, dApps can send permission requests to connected wallets.\n","packages/polyfills/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/scaffold-ui/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/siwe/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n� [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・�📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/siwx/README.md":"#### 📚 [Documentation](https://docs.reown.com/2.0/appkit/about)\n\n#### 🔗 [Website](https://reown.com/appkit)\n\n# AppKit SIWX\n\nThe chain agnostic tool to enable authentication for AppKit applications.\n\n> [!WARNING]\n> This package is still in development and should not be used in production.\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n","packages/testing/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/ui/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n� [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・�📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/universal-connector/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","packages/wallet/README.md":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n"},"items":[{"name":"AGENTS.md","path":"AGENTS.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/AGENTS.md","title":"AI Agent Protocol & Instructions","category":"root-instruction","format":"markdown","content":"# AGENTS.md\n\nReown AppKit — a multi-chain onchain SDK providing wallet connection, authentication, swaps, on-ramp, and transaction UX for 700+ wallets across EVM, Solana, Bitcoin, Polkadot, and TON. Available for React, Next.js, Vue, Nuxt, Svelte, vanilla JS, React Native, Flutter, and native mobile.\n\n## Quick Reference\n\n- **Package manager**: pnpm workspaces (`pnpm-workspace.yaml`)\n- **Build orchestration**: Turborepo (`turbo.json`)\n- **State management**: valtio (always import from `valtio/vanilla`)\n- **UI framework**: LitElement Web Components\n- **Testing**: Vitest (unit), Playwright (E2E in `apps/laboratory`)\n- **TypeScript**: Strict mode, ESM only, `experimentalDecorators` enabled\n\n## Commands\n\n```bash\npnpm install              # Install dependencies\npnpm build                # Build all packages (run before apps or tests)\npnpm test                 # Unit tests (Vitest)\npnpm typecheck            # Type checking (depends on build)\npnpm lint                 # ESLint\npnpm run prettier:format  # Format code (run before committing)\npnpm changeset            # Create a changeset for versioning\npnpm laboratory           # Run E2E testing app\npnpm demo:dev             # Run demo app\npnpm gallery              # Run Storybook component gallery\n```\n\n## Repository Layout\n\n```\npackages/\n  appkit/              → @reown/appkit             Main SDK facade\n  controllers/         → @reown/appkit-controllers  Valtio state management\n  ui/                  → @reown/appkit-ui           Atomic wui-* Web Components\n  scaffold-ui/         → @reown/appkit-scaffold-ui  High-level w3m-* UI flows\n  common/              → @reown/appkit-common       Shared types and utilities\n  appkit-utils/        → @reown/appkit-utils        Chain-specific helpers\n  wallet/              → @reown/appkit-wallet       Wallet models\n  pay/                 → @reown/appkit-pay          Payment flows\n  siwe/                → @reown/appkit-siwe         Sign-In With Ethereum\n  siwx/                → @reown/appkit-siwx         Cross-chain authentication\n  adapters/\n    wagmi/             → EVM via Wagmi/Viem\n    ethers/            → EVM via ethers v6\n    ethers5/           → EVM via ethers v5\n    solana/            → Solana\n    bitcoin/           → Bitcoin\n    polkadot/          → Polkadot\n    ton/               → TON\napps/\n  laboratory/          → E2E testing (Next.js + Playwright)\n  demo/                → Marketing demo\n  gallery/             → Storybook component gallery\nexamples/              → Integration examples (next-*, react-*, vue-*, svelte-*, html-*)\n```\n\n## Architecture Rules\n\n### Layer Order (dependencies flow downward only)\n\n```\napps & examples\n  ↓\nadapters (wagmi, solana, bitcoin, ethers, ...)\n  ↓\n@reown/appkit (SDK facade)\n  ↓\nscaffold-ui (w3m-*) · pay\n  ↓\nui (wui-*) · controllers · appkit-utils\n  ↓\ncommon · wallet · polyfills\n```\n\n### Import Boundaries\n\n- **ui** (`wui-*`): Cannot import from controllers, scaffold-ui, appkit, or adapters\n- **controllers**: Cannot import from ui, scaffold-ui, appkit, or adapters\n- **scaffold-ui** (`w3m-*`): Uses relative imports within the package, not `@reown/` paths\n- **adapters**: Import from `@reown/appkit` and foundations, never from controllers or ui directly\n- **Cross-package**: Always use package entrypoints or declared subpath exports, never deep internal paths\n\n### Chain Namespaces\n\n| Namespace  | Chain    | Adapter                |\n| ---------- | -------- | ---------------------- |\n| `eip155`   | EVM      | wagmi, ethers, ethers5 |\n| `solana`   | Solana   | solana                 |\n| `bip122`   | Bitcoin  | bitcoin                |\n| `polkadot` | Polkadot | polkadot               |\n| `ton`      | TON      | ton                    |\n\n## Where to Put Things\n\n| What you're building     | Where it goes                                                                                           |\n| ------------------------ | ------------------------------------------------------------------------------------------------------- |\n| New state/business logic | `packages/controllers/src/controllers/` — follow [controller pattern](.agents/context/controllers.md)   |\n| New atomic UI element    | `packages/ui/src/composites/wui-<name>/` — follow [UI guide](.agents/context/ui-components.md)          |\n| New modal view/screen    | `packages/scaffold-ui/src/views/w3m-<name>-view/` — register in RouterController + w3m-router           |\n| Reusable UI section      | `packages/scaffold-ui/src/partials/w3m-<name>/`                                                         |\n| New blockchain adapter   | `packages/adapters/<name>/` — extend AdapterBlueprint, see [adapter guide](.agents/context/adapters.md) |\n| Shared types or utils    | `packages/common/src/`                                                                                  |\n| Chain-specific helpers   | `packages/appkit-utils/src/`                                                                            |\n| Public SDK API           | `packages/appkit/exports/` — treat changes as potentially breaking                                      |\n| Unit tests               | Co-located `tests/` directory in the relevant package                                                   |\n| E2E tests                | `apps/laboratory/tests/` using Page Object Model                                                        |\n| Integration example      | `examples/<framework>-<adapter>/`                                                                       |\n\n## Code Patterns\n\n### Controllers (valtio state)\n\n```typescript\n// packages/controllers/src/controllers/MyController.ts\nimport { proxy, subscribe as sub } from 'valtio/vanilla'\nimport { subscribeKey as subKey } from 'valtio/vanilla/utils'\n\n// -- Types ----\nexport interface MyControllerState {\n  value: string\n}\n\n// -- State ----\nconst state = proxy<MyControllerState>({ value: '' })\n\n// -- Controller ----\nconst controller = {\n  state,\n  subscribe(callback: (s: MyControllerState) => void) {\n    return sub(state, () => callback(state))\n  },\n  subscribeKey<K extends keyof MyControllerState>(key: K, cb: (v: MyControllerState[K]) => void) {\n    return subKey(state, key, cb)\n  },\n  setValue(v: string) {\n    state.value = v\n  }\n}\nexport const MyController = withErrorBoundary(controller)\n```\n\nSection comments (`// -- Types ----`, `// -- State ----`, `// -- Controller ----`) are enforced by DangerJS.\n\n### UI Atoms (wui-\\*)\n\n```typescript\n// packages/ui/src/composites/wui-my-thing/index.ts\n@customElement('wui-my-thing')\nexport class WuiMyThing extends LitElement {\n  public static override styles = [resetStyles, styles] // resetStyles required\n  // -- State & Properties ----\n  @property() public variant = 'default' // @state() NOT allowed\n  // -- Render ----\n  public override render() {\n    return html`<slot></slot>`\n  }\n}\n```\n\n### Scaffold Views (w3m-\\*)\n\n```typescript\n// packages/scaffold-ui/src/views/w3m-my-view/index.ts\n@customElement('w3m-my-view')\nexport class W3mMyView extends LitElement {\n  private unsubscribe: (() => void)[] = [] // Cleanup required\n  @state() private value = SomeController.state.value\n\n  constructor() {\n    super()\n    this.unsubscribe.push(\n      SomeController.subscribeKey('value', v => {\n        this.value = v\n      })\n    )\n  }\n\n  public override disconnectedCallback() {\n    this.unsubscribe.forEach(u => u())\n  }\n}\n```\n\n### Adapters\n\nExtend `AdapterBlueprint` from `packages/controllers/src/controllers/AdapterController/ChainAdapterBlueprint.ts`. Implement: `connect()`, `disconnect()`, `switchNetwork()`, `signMessage()`, `sendTransaction()`, `getBalance()`. Host SDKs go in `peerDependencies`.\n\n## PR Requirements\n\n1. Run `pnpm build && pnpm run prettier:format` before submitting\n2. Use conventional commit format for PR titles (`feat:`, `fix:`, `chore:`, `refactor:`, `test:`, `docs:`)\n3. Bug fixes and new features require tests\n4. Create a changeset: `pnpm changeset`\n5. DangerJS validates import boundaries, naming conventions, section comments, and dependency rules\n\n## Versioning\n\nAll `@reown/appkit-*` packages are versioned together as a fixed group via Changesets. Release channels: `latest`, `alpha`, `beta`, `canary`. `@examples/*` and `@apps/*` are excluded from publishing.\n\n## Detailed Context\n\nFor in-depth guidance on specific topics:\n\n- [Architecture & Initialization Flow](.agents/context/architecture.md) — layer diagram, import boundaries, init sequence, network request policy\n- [Controllers Reference](.agents/context/controllers.md) — valtio patterns, all controllers, state shapes\n- [UI Components Guide](.agents/context/ui-components.md) — wui-_ and w3m-_ patterns, DangerJS rules, adding views\n- [Blockchain Adapters Guide](.agents/context/adapters.md) — AdapterBlueprint, creating new adapters\n- [Testing Guide](.agents/context/testing.md) — Vitest, Playwright, test locations, writing new tests\n- [Package Reference](.agents/context/packages.md) — all packages, build outputs, adding packages\n- [Contributing & PR Guide](.agents/context/contributing.md) — PR checks, changesets, release process\n","isInternal":false,"tokens":2125,"sizeBytes":9151},{"name":"CLAUDE.md","path":"CLAUDE.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/CLAUDE.md","title":"Claude Agent Guidelines & System Prompt","category":"claude-rule","format":"markdown","content":"AGENTS.md","isInternal":false,"tokens":3,"sizeBytes":9},{"name":"appkit-apps.mdc","path":".cursor/rules/appkit-apps.mdc","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/.cursor/rules/appkit-apps.mdc","title":"Cursor Rule: appkit-apps","category":"cursor-rule","format":"mdc","content":"---\ndescription: Focused rules for working in apps (dev, testing, wiring AppKit into apps)\nglobs:\n  - 'apps/**'\nalwaysApply: false\n---\n\n## AppKit Apps Rules\n\nUse these when changing code under `apps/**`.\n\n### Development & Scripts\n\n- Use workspace scripts: `pnpm --filter @apps/<name> dev|build`.\n- Build dependencies first with `pnpm build` if packages changed.\n- Keep app configs minimal; rely on package exports and avoid deep imports.\n\n### Integrating AppKit\n\n- Import via facade or adapter packages, e.g.:\n  ```ts\n  import { createAppKit } from '@reown/appkit'\n  import { ControllersProvider } from '@reown/appkit-controllers/react'\n  ```\n- Prefer framework subpaths when available: `@reown/appkit/react`, `@reown/appkit-controllers/react`.\n\n### Testing\n\n- Vitest for unit/integration; Playwright in `apps/laboratory` for e2e.\n- Co-locate basic tests within app directories where meaningful; heavy e2e in laboratory app.\n\n### SSR & Client Boundaries\n\n- Guard browser-only APIs (e.g., `window`) for SSR routes.\n- Avoid importing `@reown/appkit-ui` directly in server components; use client components wrappers.\n","frontmatter":{"description":"Focused rules for working in apps (dev, testing, wiring AppKit into apps)","globs":["apps/**"],"alwaysApply":false},"isInternal":false,"tokens":274,"sizeBytes":1115},{"name":"appkit-examples.mdc","path":".cursor/rules/appkit-examples.mdc","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/.cursor/rules/appkit-examples.mdc","title":"Cursor Rule: appkit-examples","category":"cursor-rule","format":"mdc","content":"---\ndescription: Focused rules for examples (usage patterns, adapters, CDN builds)\nglobs:\n  - 'examples/**'\nalwaysApply: false\n---\n\n## AppKit Examples Rules\n\nThese rules apply to `examples/**`.\n\n### Usage Patterns\n\n- Import from public entrypoints of packages (`@reown/appkit`, `@reown/appkit-adapter-*`).\n- Do not deep import internal paths.\n- Keep example code minimal, readable, and framework-idiomatic.\n\n### Adapters & Peers\n\n- Respect `peerDependencies`: install `wagmi`/`viem`/`ethers` in examples that need them.\n- Prefer the adapter suited to the framework: wagmi for React, ethers for generic EVM, solana adapter for Solana.\n\n### CDN\n\n- For CDN-based examples, use `@reown/appkit-cdn` outputs and ensure polyfills are present when required.\n","frontmatter":{"description":"Focused rules for examples (usage patterns, adapters, CDN builds)","globs":["examples/**"],"alwaysApply":false},"isInternal":false,"tokens":189,"sizeBytes":750},{"name":"appkit-monorepo.mdc","path":".cursor/rules/appkit-monorepo.mdc","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/.cursor/rules/appkit-monorepo.mdc","title":"Cursor Rule: appkit-monorepo","category":"cursor-rule","format":"mdc","content":"---\ndescription: Monorepo-wide rules for Reown AppKit: structure, layering, packaging, and TS/SDK best practices\nglobs:\n  - \"packages/**\"\n  - \"apps/**\"\n  - \"examples/**\"\n  - \"services/**\"\n  - \"scripts/**\"\n  - \"turbo.json\"\n  - \"pnpm-workspace.yaml\"\n  - \"vitest.workspace.ts\"\nalwaysApply: true\n---\n\n## Cursor Rules: Reown AppKit Monorepo\n\nThis document orients Cursor to the structure, relationships, and common patterns across the Reown AppKit monorepo. It also encodes TypeScript and SDK development best practices to keep edits consistent, safe, and maintainable.\n\n### Monorepo Overview\n\n- **Package manager**: `pnpm` workspaces (`pnpm-workspace.yaml`)\n- **Build Orchestration**: `turbo` tasks (`turbo.json`) with cached `build`, `typecheck`, `lint`, `test`\n- **Testing**: `vitest` (workspace config in `vitest.workspace.ts`, default `jsdom` env)\n- **Repo roots**:\n  - `packages/` — publishable libraries and internal SDK modules\n  - `apps/` — product and demo applications (`gallery`, `laboratory`, `demo`, `browser-extension`)\n  - `examples/` — integration examples (Next, React, Vue, Svelte, plain HTML)\n  - `services/` — ancillary services (e.g., `id-allocation-service`)\n  - `scripts/`, `patches/`, root configs\n\n### High-Level Architecture and Package Roles\n\n- **SDK Facade**: `@reown/appkit`\n\n  - Public, framework-agnostic entrypoint. Re-exports subdomains and framework layers via subpath exports.\n  - Depends on: `@reown/appkit-common`, `@reown/appkit-controllers`, `@reown/appkit-pay`, `@reown/appkit-polyfills`, `@reown/appkit-scaffold-ui`, `@reown/appkit-ui`, `@reown/appkit-utils`, `@reown/appkit-wallet`, plus ecosystem deps (`valtio`, `viem`, `@walletconnect/universal-provider`).\n  - Provides subpaths like `./react`, `./vue`, `./utils`, `./adapters`, `./connectors`, etc.\n\n- **Domain Foundations**:\n\n  - `@reown/appkit-common`: shared types, math/date utils, light helpers. ESM only.\n  - `@reown/appkit-wallet`: wallet models, schema validation, core wallet utilities (depends on `common`, `polyfills`).\n  - `@reown/appkit-controllers`: stateful logic and business rules, with `valtio` for reactive state. Framework-agnostic; provides optional `react`/`vue` subpaths.\n  - `@reown/appkit-utils`: integration helpers per chain/family (Ethers, Solana, Bitcoin, Wallet Standard). Depends on `common`, `controllers`, `wallet`, `polyfills`.\n\n- **UI Layers**:\n\n  - `@reown/appkit-ui`: low-level UI as Web Components (Lit). Exports many `wui-*` components; no app logic.\n  - `@reown/appkit-scaffold-ui`: mid/high-level UI flows (modal, router containers, pay/onramp flows). Composes `@reown/appkit-ui` and `controllers`.\n  - `@reown/appkit-wallet-button`: focused UI package that composes `ui`, `controllers`, `utils`; optional `@lit/react` wrapper.\n\n- **Authentication and Pay**:\n\n  - `@reown/appkit-siwe`: Sign-In With Ethereum UX + controllers integration.\n  - `@reown/appkit-siwx`: Cross-chain SIWx utilities for EVM, Solana, Bitcoin, etc. No direct UI dependency.\n  - `@reown/appkit-pay`: UI + state for pay flows; composes `ui`, `controllers`, `utils`.\n\n- **Adapters (ecosystem integrations)**: `packages/adapters/*`\n\n  - `@reown/appkit-adapter-wagmi`, `-ethers`, `-ethers5`, `-solana`, `-bitcoin` (and private `-polkadot`).\n  - All depend on `@reown/appkit` + foundations; expose framework subpaths when relevant (`react`, `vue` in some packages).\n  - Use `peerDependencies` for host frameworks/SDKs (e.g., `wagmi`, `viem`, `ethers`) and `optionalDependencies` for optional wallets/providers.\n\n- **Bridging, Polyfills, Experimental, CDN**:\n\n  - `@reown/appkit-universal-connector`: thin bridge to `@walletconnect/universal-provider`.\n  - `@reown/appkit-polyfills`: browser `buffer` and similar shims.\n  - `@reown/appkit-experimental`: gated/unstable features (e.g., smart session). Depends on core packages.\n  - `@reown/appkit-cdn`: prebundled CDN builds (not tree-shaken by consumers). Depends on `appkit` and adapters.\n\n- **Tooling**:\n  - `@reown/appkit-testing`: test harnesses (includes Playwright for e2e; depends on `@reown/appkit`).\n  - `@reown/appkit-cli`: simple scaffolding/utility CLI.\n  - `@reown/appkit-codemod`: upgrade helper for dependency migrations.\n  - `@reown/appkit-core` (in `core-legacy/`): legacy compatibility wrapper around controllers.\n\n### Allowed Dependencies and Import Boundaries\n\n- Favor a layered graph from foundations → controllers → ui/scaffold → appkit (facade) → adapters/apps.\n- Avoid cyclical imports. Do not import upward across layers (e.g., `ui` must not import from `appkit` or app code).\n- Only import via package entrypoints or declared subpath exports; avoid deep, relative cross-package imports.\n  - Good: `import { X } from '@reown/appkit-controllers'`\n  - Good: `import { WuiButton } from '@reown/appkit-ui/wui-button'`\n  - Avoid: `import { X } from '@reown/appkit-controllers/dist/...` (internal paths are not stable)\n- Framework subpaths are explicitly exported (e.g., `./react`, `./vue`) when available; prefer those over bundling framework internals.\n- Keep optional or host-specific libraries as `peerDependencies` (e.g., `wagmi`, `viem`, `ethers`) and mark optional features as `optionalDependencies` to keep the core light.\n\n### Packaging and Build Conventions\n\n- All packages are ESM (`\"type\": \"module\"`).\n- Build outputs:\n  - JS: `dist/esm/...`\n  - Types: `dist/types/...`\n  - `package.json` uses `exports` map and (where relevant) `typesVersions` for editor compatibility.\n- Use `\"sideEffects\": false` when the package is tree-shakeable (most are). Ensure top-level side effects are avoided.\n- Scripts:\n  - `build:clean`: remove `dist`\n  - `build`: `tsc --build` (some use `tsconfig.build.json`)\n  - `watch`: `tsc --watch`\n  - `typecheck`: `tsc --noEmit`\n  - `lint`: ESLint across TS/JS files\n  - `test`: Vitest (most with coverage)\n- Orchestration:\n  - Use `turbo run build --filter={./packages/**/*}` for workspace builds.\n  - `typecheck` and `lint` are cached by turbo; `test` is typically not cached.\n\n### UI Patterns\n\n- Base UI uses Lit Web Components, exported as `wui-*` elements from `@reown/appkit-ui`.\n- Higher-level UI flows and composition live in `@reown/appkit-scaffold-ui` and focus on orchestration (modal, router container, lists, pay/onramp flows).\n- Do not embed business logic into `@reown/appkit-ui`. Use `controllers`/`utils` for non-visual logic and data.\n- If providing React wrappers for Web Components, expose them via explicit subpath exports (e.g., `./react`) and keep them optional to avoid forcing React in core packages.\n\n### State, Data, and External SDKs\n\n- State management is uniform with `valtio`. Controllers own reactive state; UI subscribes.\n- EVM stack uses `viem` and `wagmi` (in adapters). Solana uses `@solana/web3.js` and wallet-standard libs. Bitcoin uses `bitcoinjs-lib`, `sats-connect`.\n- WalletConnect v2 is integrated via `@walletconnect/universal-provider`. Keep provider interactions isolated in `controllers`/`utils`/adapters.\n\n### Testing Conventions\n\n- `vitest` with `jsdom` by default for DOM-related packages; Node for pure utility packages as needed.\n- Place tests under `tests/` per package.\n- `@reown/appkit-testing` includes shared testing utilities and e2e dependencies (e.g., Playwright) but is not a runtime dependency.\n\n### Versioning and Release\n\n- Managed with `changesets`. Some overrides/patches exist under `patches/`.\n- Internal packages use `workspace:*` ranges to synchronize versions.\n- Keep public API changes aggregated through `@reown/appkit` where possible to minimize breaking surface area.\n\n### Adding or Modifying Packages (Checklist)\n\n1. Create a new package under `packages/<name>` with:\n   - `package.json` using ESM, `exports` map, `files: [\"dist\", \"README.md\"]`, and `sideEffects: false` if safe.\n   - `tsconfig.json` and optionally `tsconfig.build.json` with incremental builds.\n   - `vitest.config.ts` if tests are present.\n2. Define clear dependencies:\n   - Internal deps via `workspace:*`.\n   - External host libs as `peerDependencies` (and mark optional when applicable).\n   - Optional providers/wallets as `optionalDependencies`.\n3. Expose subpaths deliberately (e.g., `./react`, `./vue`, `./utils`) only when stable and necessary.\n4. Keep layering intact: do not import up the stack; avoid cross-layer leakage.\n5. Add targeted unit tests for new behavior and update examples if developer UX changes.\n6. Run `pnpm build`, `pnpm run typecheck`, `pnpm run lint`, and `pnpm test` locally.\n\n### Adapter Authoring Guidelines\n\n- Mirror existing adapters for structure and scripts.\n- Depend on `@reown/appkit`, `@reown/appkit-controllers`, `@reown/appkit-utils`, `@reown/appkit-common`, and where needed `@reown/appkit-ui`.\n- Treat ecosystem SDKs as `peerDependencies` (e.g., `wagmi`, `viem`, `ethers`) to defer version control to the host app; use `optionalDependencies` for optional wallet SDKs (e.g., Coinbase, Safe).\n- Keep business logic inside controllers/utilities; adapters should translate between host SDK APIs and AppKit abstractions.\n\n### Import and API Design Best Practices (TypeScript)\n\n- Public APIs must be explicitly exported via the `exports` map and stable subpaths. Avoid deep internal imports.\n- Use `export type` for types-only exports to aid tree-shaking and ergonomics.\n- Prefer narrow, well-named interfaces and parameter objects over positional args.\n- Do not leak implementation-specific types from third-party SDKs across package boundaries; wrap or map to internal domain types.\n- Add `strict` TS configs and avoid `any`. Use discriminated unions for variant states.\n- Use early returns and guard clauses; avoid deep nesting.\n- Validate inputs near boundaries (e.g., adapter entrypoints). Use `zod` when schemas are involved.\n- Errors: throw typed errors or return structured `Result`-like objects where it improves developer ergonomics; never swallow exceptions.\n\n### Performance and Security Notes\n\n- Keep packages tree-shakeable; avoid top-level side effects and large transitive deps in core layers.\n- Use `peerDependencies` to avoid bundling multiple versions of large SDKs.\n- Be mindful of SSR: avoid direct `window` access in shared code; gate browser-only code.\n- Sanitize and validate user inputs in UI flows and adapters. Do not interpolate untrusted values into DOM without escaping.\n- Avoid logging secrets or PII. Use structured logs (debug-only in dev paths).\n\n### Practical Examples\n\nImports (prefer subpaths when they exist):\n\n```ts\nimport { createAppKit } from '@reown/appkit'\nimport { createWagmiAdapter } from '@reown/appkit-adapter-wagmi'\nimport { AccountController } from '@reown/appkit-controllers'\nimport { W3mModal } from '@reown/appkit-scaffold-ui/w3m-modal'\nimport { WuiButton } from '@reown/appkit-ui/wui-button'\n```\n\nReact/Vue subpaths (when provided):\n\n```ts\nimport { ControllersProvider } from '@reown/appkit-controllers/react'\nimport { AppKitProvider } from '@reown/appkit/react'\n```\n\n### What Cursor Should Assume When Editing\n\n- Respect the layering and import boundaries above. If a change requires crossing a boundary, propose an abstraction in a lower layer instead.\n- When adding a new exported module:\n  - Update the package `exports` map and type paths.\n  - Add unit tests and minimal examples.\n  - Keep `sideEffects: false` valid by avoiding module-level effects.\n- For UI changes:\n  - Add new components under `@reown/appkit-ui` with `wui-` prefix, minimal logic.\n  - Compose flows under `@reown/appkit-scaffold-ui`.\n  - Keep controllers/data-fetching outside UI layers.\n- For adapters:\n  - Prefer compile-time type safety over runtime checks; encode invariants in types.\n  - Ensure version constraints are compatible with examples and CDN builds.\n\n### Quick Map of Key Packages\n\n- `@reown/appkit` — SDK facade and top-level exports\n- `@reown/appkit-common` — shared types/utils\n- `@reown/appkit-wallet` — wallet models/utilities\n- `@reown/appkit-controllers` — stateful domain logic (valtio state)\n- `@reown/appkit-utils` — chain/wallet helpers\n- `@reown/appkit-ui` — base UI (Lit Web Components, `wui-*`)\n- `@reown/appkit-scaffold-ui` — modal/router/pay/onramp flows\n- `@reown/appkit-pay` — pay feature surface (UI + controllers)\n- `@reown/appkit-siwe` / `@reown/appkit-siwx` — auth flows and utilities\n- `@reown/appkit-universal-connector` — WalletConnect bridge\n- `@reown/appkit-adapter-*` — ecosystem adapters (Wagmi/Ethers/Ethers5/Solana/Bitcoin)\n- `@reown/appkit-polyfills` — browser polyfills\n- `@reown/appkit-cdn` — CDN bundles\n- `@reown/appkit-testing` — test harnesses\n- `@reown/appkit-cli` / `@reown/appkit-codemod` — dev tooling\n- `@reown/appkit-core` — legacy wrapper around controllers\n\n---\n\nIf a change seems to violate these rules, prefer refactoring toward these boundaries or proposing a clear abstraction that preserves the layering.\n","isInternal":false,"tokens":3335,"sizeBytes":12835},{"name":"appkit-packages.mdc","path":".cursor/rules/appkit-packages.mdc","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/.cursor/rules/appkit-packages.mdc","title":"Cursor Rule: appkit-packages","category":"cursor-rule","format":"mdc","content":"---\ndescription: Focused rules for working in packages (controllers, scaffold-ui views, new packages)\nglobs:\n  - 'packages/**'\nalwaysApply: false\n---\n\n## AppKit Packages Rules\n\nThese rules are scoped to `packages/**` and capture concrete, actionable guidance for day-to-day changes.\n\n### Controllers: State Management\n\n- Use `valtio/vanilla` `proxy` for state and `subscribeKey` for fine-grained subscriptions.\n- Keep controller surface small: `state` object and pure methods that mutate state.\n- Wrap controllers with `withErrorBoundary` to guard external call-sites.\n- Do not import UI code into controllers. Controllers depend only on foundations/utilities.\n- Example references:\n  - Router state shape and navigation: `packages/controllers/src/controllers/RouterController.ts`\n  - Proxy usage per chain: `packages/controllers/src/controllers/ChainController.ts`\n  - Error boundary util: `packages/controllers/src/utils/withErrorBoundary.ts`\n\nWhen updating state:\n\n- Prefer `replace`/`reset`/`push` style APIs for navigation and history changes.\n- Avoid deep nested state updates; compute next values and assign once.\n- Do not catch and swallow errors; either rethrow typed or use the error boundary.\n\n### Scaffold UI: Adding a New View\n\nUse Lit Web Components and the router:\n\n1. Create a view component under `packages/scaffold-ui/src/views/` named `w3m-my-feature-view`.\n2. Export it from the scaffold package (via existing barrel/exports pattern).\n3. Add a new discriminant to `RouterControllerState['view']` in `packages/controllers/src/controllers/RouterController.ts`.\n4. Map the new view in `packages/scaffold-ui/src/modal/w3m-router/index.ts` `viewTemplate` switch:\n   - Case: `'MyFeature'` → `<w3m-my-feature-view></w3m-my-feature-view>`.\n5. Navigate with `RouterController.push('MyFeature')` from actions.\n6. If the view participates in history transitions, no extra work is needed; `w3m-router-container` animates based on `history`.\n\nReferences:\n\n- Router container transitions: `packages/scaffold-ui/src/partials/w3m-router-container/index.ts`\n- Router view switch: `packages/scaffold-ui/src/modal/w3m-router/index.ts`\n- View enum and history: `packages/controllers/src/controllers/RouterController.ts`\n\nView guidelines:\n\n- Keep logic minimal in views; delegate to controllers/helpers.\n- Use `@reown/appkit-ui` primitives (`wui-*`) for visuals.\n- Avoid accessing `window` without SSR guards.\n\n### Adding a New Package\n\n1. Create `packages/<name>/` with ESM config and `exports` map.\n2. Dependencies:\n   - Internal deps as `workspace:*`.\n   - Host libraries as `peerDependencies` and optional wallets/providers as `optionalDependencies`.\n3. Scripts: `build:clean`, `build` (tsc --build), `watch`, `typecheck`, `lint`, `test` (vitest).\n4. Add `sideEffects: false` if safe; avoid top-level side effects.\n5. Expose subpaths deliberately (e.g., `./react`, `./vue`, `./utils`) only when stable.\n6. Add `vitest.config.ts` and `tests/` if applicable.\n7. Update examples or CDN if developer UX changes.\n\nChecklist snippet:\n\n```json\n{\n  \"type\": \"module\",\n  \"sideEffects\": false,\n  \"exports\": { \".\": { \"types\": \"./dist/types/index.d.ts\", \"import\": \"./dist/esm/index.js\" } }\n}\n```\n\n### TypeScript & API\n\n- Use `export type` for types-only exports.\n- Avoid `any`; prefer discriminated unions for variant states.\n- Do not leak third-party types across boundaries; map to internal domain types.\n- Validate adapter inputs with `zod` where schemas are involved.\n\n#### Public API and Breaking Changes\n\n- The `exports` entrypoints (e.g., `packages/appkit/exports/*.ts`) define the public SDK surface used by external developers.\n- Treat any change to exported functions, classes, or types as potentially breaking.\n- Follow semver: breaking changes require a major bump and a clear Changeset entry describing migration.\n- Prefer additive changes over mutations; deprecate first with JSDoc `@deprecated` and keep shims until the next major.\n- Keep exports stable and avoid re-exporting deep internals that may change frequently.\n\n### Security & Performance\n\n- Sanitize user inputs; avoid injecting untrusted values into DOM.\n- Keep packages tree-shakeable and SSR-safe.\n- Use `peerDependencies` for large host SDKs to avoid duplicate bundles.\n","frontmatter":{"description":"Focused rules for working in packages (controllers, scaffold-ui views, new packages)","globs":["packages/**"],"alwaysApply":false},"isInternal":false,"tokens":984,"sizeBytes":4241},{"name":"add-documentation.md","path":".cursor/commands/add-documentation.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/.cursor/commands/add-documentation.md","title":"Command: /add-documentation","category":"command-prompt","format":"markdown","content":"# Add Documentation\n\nPlease add comprehensive documentation for the current code/feature. Include:\n\n## Overview\n\n- What this code/feature does\n- Why it exists and its purpose\n- Key concepts and terminology\n\n## API Documentation\n\n- Function/method signatures\n- Parameters and return values\n- Example usage with code snippets\n- Error handling and edge cases\n\n## Implementation Details\n\n- Architecture overview\n- Important design decisions\n- Dependencies and integrations\n\n## Examples\n\n- Common use cases with full examples\n- Best practices and patterns\n- Common pitfalls to avoid\n\nFormat the documentation according to the project's documentation standards and\ninclude it in the appropriate location (README, docs folder, or inline\ncomments).\n","isInternal":false,"tokens":142,"sizeBytes":741},{"name":"address-github-pr-comments.md","path":".cursor/commands/address-github-pr-comments.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/.cursor/commands/address-github-pr-comments.md","title":"Command: /address-github-pr-comments","category":"command-prompt","format":"markdown","content":"# Address GitHub PR Comments\n\n## Overview\n\nProcess outstanding reviewer feedback, apply required fixes, and draft clear\nresponses for each GitHub pull-request comment.\n\n## Steps\n\n1. **Sync and audit comments**\n   - Pull the latest branch changes\n   - Open the PR conversation view and read every unresolved comment\n   - Group comments by affected files or themes\n2. **Plan resolutions**\n   - List the requested code edits for each thread\n   - Identify clarifications or additional context you must provide\n   - Note any dependencies or blockers before implementing changes\n3. **Implement fixes**\n   - Apply targeted updates addressing one comment thread at a time\n   - Run relevant tests or linters after impactful changes\n   - Stage changes with commits that reference the addressed feedback\n4. **Draft responses**\n   - Summarize the action taken or reasoning provided for each comment\n   - Link to commits or lines when clarification helps reviewers verify\n   - Highlight any remaining questions or follow-up needs\n\n## Response Checklist\n\n- [ ] All reviewer comments acknowledged\n- [ ] Required code changes implemented and tested\n- [ ] Clarifying explanations prepared for nuanced threads\n- [ ] Follow-up items documented or escalated\n- [ ] PR status updated for reviewers\n","isInternal":false,"tokens":252,"sizeBytes":1276},{"name":"code-review.md","path":".cursor/commands/code-review.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/.cursor/commands/code-review.md","title":"Command: /code-review","category":"command-prompt","format":"markdown","content":"# Code Review\n\n## Overview\n\nPerform a thorough code review that verifies functionality, maintainability, and\nsecurity before approving a change. Focus on architecture, readability,\nperformance implications, and provide actionable suggestions for improvement.\n\n## Steps\n\n1. **Understand the change**\n   - Read the PR description and related issues for context\n   - Identify the scope of files and features impacted\n   - Note any assumptions or questions to clarify with the author\n2. **Validate functionality**\n   - Confirm the code delivers the intended behavior\n   - Exercise edge cases or guard conditions mentally or by running locally\n   - Check error handling paths and logging for clarity\n3. **Assess quality**\n   - Ensure functions are focused, names are descriptive, and code is readable\n   - Watch for duplication, dead code, or missing tests\n   - Verify documentation and comments reflect the latest changes\n4. **Review security and risk**\n   - Look for injection points, insecure defaults, or missing validation\n   - Confirm secrets or credentials are not exposed\n   - Evaluate performance or scalability impacts of the change\n\n## Review Checklist\n\n### Functionality\n\n- [ ] Intended behavior works and matches requirements\n- [ ] Edge cases handled gracefully\n- [ ] Error handling is appropriate and informative\n\n### Code Quality\n\n- [ ] Code structure is clear and maintainable\n- [ ] No unnecessary duplication or dead code\n- [ ] Tests/documentation updated as needed\n\n### Security & Safety\n\n- [ ] No obvious security vulnerabilities introduced\n- [ ] Inputs validated and outputs sanitized\n- [ ] Sensitive data handled correctly\n\n## Additional Review Notes\n\n- Architecture and design decisions considered\n- Performance bottlenecks or regressions assessed\n- Coding standards and best practices followed\n- Resource management, error handling, and logging reviewed\n- Suggested alternatives, additional test cases, or documentation updates\n  captured\n\nProvide constructive feedback with concrete examples and actionable guidance for\nthe author.\n","isInternal":false,"tokens":395,"sizeBytes":2051},{"name":"debug-issue.md","path":".cursor/commands/debug-issue.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/.cursor/commands/debug-issue.md","title":"Command: /debug-issue","category":"command-prompt","format":"markdown","content":"# Debug Issue\n\nHelp debug the current issue in the code. Please:\n\n## Problem Analysis\n\n- Identify the specific problem or error\n- Understand the expected vs actual behavior\n- Trace the execution flow to find the root cause\n\n## Debugging Strategy\n\n- Add appropriate logging statements\n- Suggest debugging tools and techniques\n- Identify key variables and states to monitor\n- Recommend breakpoint locations\n\n## Solution Approach\n\n- Propose potential fixes with explanations\n- Consider multiple solution approaches\n- Evaluate trade-offs of different approaches\n- Provide step-by-step resolution plan\n\n## Prevention\n\n- Suggest ways to prevent similar issues\n- Recommend additional tests or checks\n- Identify code patterns that could be improved\n\nWalk through the debugging process systematically and provide clear, actionable\nsolutions.\n","isInternal":false,"tokens":156,"sizeBytes":833},{"name":"fix-git-issues.md","path":".cursor/commands/fix-git-issues.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/.cursor/commands/fix-git-issues.md","title":"Command: /fix-git-issues","category":"command-prompt","format":"markdown","content":"# Fix Git Issues\n\nHelp resolve common Git problems and conflicts. Address:\n\n## Merge Conflicts\n\n- Analyze conflicting changes and their context\n- Provide resolution strategies for different conflict types\n- Suggest the best approach to preserve important changes\n- Generate resolved code maintaining functionality\n\n## Branch Management\n\n- Help with branch cleanup and organization\n- Suggest rebasing vs merging strategies\n- Assist with cherry-picking specific commits\n- Guide through complex branch operations\n\n## Commit History\n\n- Help with commit message improvements\n- Assist with squashing and organizing commits\n- Guide through interactive rebase operations\n- Fix commit authorship and metadata\n\n## Repository Issues\n\n- Help recover from detached HEAD state\n- Assist with undoing commits and changes\n- Guide through stash management\n- Resolve submodule and remote issues\n\nProvide step-by-step Git commands with explanations for each situation.\n","isInternal":false,"tokens":175,"sizeBytes":949},{"name":"generate-pr-description.md","path":".cursor/commands/generate-pr-description.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/.cursor/commands/generate-pr-description.md","title":"Command: /generate-pr-description","category":"command-prompt","format":"markdown","content":"# Generate PR Description\n\nCreate a comprehensive pull request description based on the changes in this\nbranch. Include:\n\n## Summary\n\nProvide a clear, concise summary of what this PR accomplishes.\n\n## Changes Made\n\n- List the key changes made in this PR\n- Include both code and non-code changes\n- Highlight any breaking changes\n\n## Testing\n\n- Describe how the changes were tested\n- Include any new test cases added\n- Note any manual testing performed\n\n## Related Issues\n\n- Link to any related issues or tickets\n- Use closing keywords if this PR resolves issues\n\n## Additional Notes\n\n- Any deployment considerations\n- Follow-up work required\n- Notes for reviewers\n\nFormat this as proper markdown for use in a GitHub PR description.\n","isInternal":false,"tokens":149,"sizeBytes":731},{"name":"light-review-existing-diffs.md","path":".cursor/commands/light-review-existing-diffs.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/.cursor/commands/light-review-existing-diffs.md","title":"Command: /light-review-existing-diffs","category":"command-prompt","format":"markdown","content":"# Light Review Existing Diffs\n\n## Overview\n\nPerform a quick quality pass on current diffs to surface risky areas, ensure\npolish, and flag follow-up actions for deeper review.\n\n## Steps\n\n1. **Scan recent changes**\n   - List open branches or pending commits requiring review\n   - Skim side-by-side diffs focusing on new or modified files\n   - Note files or modules with large or complex edits\n2. **Assess quality signals**\n   - Watch for TODOs, debug code, or commented blocks needing cleanup\n   - Verify naming, formatting, and imports follow project standards\n   - Check that tests or documentation were updated when behavior changed\n3. **Flag next actions**\n   - Mark sections that warrant full review or pair programming\n   - Capture questions or uncertainties to raise with the author\n   - Document any quick fixes you can apply immediately\n\n## Review Checklist\n\n- [ ] High-risk files identified\n- [ ] Debugging artifacts removed or flagged\n- [ ] Style and conventions validated\n- [ ] Tests/docs updates confirmed or requested\n- [ ] Follow-up items recorded for deeper review\n","isInternal":false,"tokens":228,"sizeBytes":1079},{"name":"optimize-performance.md","path":".cursor/commands/optimize-performance.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/.cursor/commands/optimize-performance.md","title":"Command: /optimize-performance","category":"command-prompt","format":"markdown","content":"# Optimize Performance\n\nAnalyze the current code for performance bottlenecks and provide optimization\nrecommendations. Focus on:\n\n## Performance Analysis\n\n- Identify slow algorithms and inefficient data structures\n- Find memory leaks and excessive allocations\n- Detect unnecessary computations and redundant operations\n- Analyze database queries and API calls\n\n## Optimization Strategies\n\n- Suggest algorithm improvements and better data structures\n- Recommend caching strategies where appropriate\n- Propose lazy loading and pagination solutions\n- Identify opportunities for parallel processing\n\n## Implementation\n\n- Provide optimized code with explanations\n- Include performance impact estimates\n- Suggest profiling and monitoring approaches\n- Consider trade-offs between performance and maintainability\n\nFocus on measurable improvements while maintaining code quality and readability.\n","isInternal":false,"tokens":145,"sizeBytes":887},{"name":"README.md","path":"packages/adapters/bitcoin/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/adapters/bitcoin/README.md","title":"bitcoin Documentation","category":"plugin-manifest","format":"markdown","content":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n� [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・�📚 [Documentation](https://docs.reown.com/appkit/overview) ・� [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・�🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","isInternal":false,"tokens":544,"sizeBytes":1979},{"name":"README.md","path":"packages/adapters/ethers/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/adapters/ethers/README.md","title":"ethers Documentation","category":"plugin-manifest","format":"markdown","content":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n� [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・�📚 [Documentation](https://docs.reown.com/appkit/overview) ・� [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・�🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","isInternal":false,"tokens":544,"sizeBytes":1979},{"name":"README.md","path":"packages/adapters/ethers5/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/adapters/ethers5/README.md","title":"ethers5 Documentation","category":"plugin-manifest","format":"markdown","content":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","isInternal":false,"tokens":545,"sizeBytes":1975},{"name":"README.md","path":"packages/adapters/polkadot/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/adapters/polkadot/README.md","title":"polkadot Documentation","category":"plugin-manifest","format":"markdown","content":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","isInternal":false,"tokens":545,"sizeBytes":1975},{"name":"README.md","path":"packages/adapters/solana/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/adapters/solana/README.md","title":"solana Documentation","category":"plugin-manifest","format":"markdown","content":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","isInternal":false,"tokens":545,"sizeBytes":1975},{"name":"README.md","path":"packages/adapters/ton/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/adapters/ton/README.md","title":"ton Documentation","category":"plugin-manifest","format":"markdown","content":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","isInternal":false,"tokens":545,"sizeBytes":1975},{"name":"README.md","path":"packages/adapters/tron/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/adapters/tron/README.md","title":"tron Documentation","category":"plugin-manifest","format":"markdown","content":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n� [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・�📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","isInternal":false,"tokens":544,"sizeBytes":1977},{"name":"README.md","path":"packages/adapters/wagmi/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/adapters/wagmi/README.md","title":"wagmi Documentation","category":"plugin-manifest","format":"markdown","content":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","isInternal":false,"tokens":545,"sizeBytes":1975},{"name":"README.md","path":"packages/appkit-utils/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/appkit-utils/README.md","title":"appkit-utils Documentation","category":"plugin-manifest","format":"markdown","content":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","isInternal":false,"tokens":545,"sizeBytes":1975},{"name":"README.md","path":"packages/appkit/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/appkit/README.md","title":"appkit Documentation","category":"plugin-manifest","format":"markdown","content":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","isInternal":false,"tokens":545,"sizeBytes":1975},{"name":"README.md","path":"packages/cli/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/cli/README.md","title":"cli Documentation","category":"plugin-manifest","format":"markdown","content":"# Reown AppKit CLI\n\n**AppKit CLI** is a command-line tool to fast download a funcionaly boilerplate example for Reown Web AppKit SDK.\n\n## Installation\n\nTo install this CLI tool globally for development, you can link it locally using the following commands.\n\n### Prerequisites\n\n- Node.js (v14 or later)\n- npm (v6 or later)\n\n### Clone the Repository\n\nFirst, clone this repository to your local machine:\n\n```bash\ngit clone https://github.com/reown-com/appkit-cli\ncd appkit-cli\n```\n\n### Local Installation\n\nTo test the CLI locally, use `npm link`. This allows you to run the CLI from any location on your machine.\n\n```bash\nnpm install\nsudo npm link\n```\n\n## Usage\n\nOnce linked, you can use the CLI globally by running:\n\n```bash\nappkit-cli\n```\n\nAlso you can run it directly:\n\n```bash\nnpx appkit-cli\n```\n\n### Example Commands\n\nProvide examples of some paramaeters:\n\n```bash\nappkit-cli [project-name]\n```\n\nFor example:\n\n```bash\nappkit-cli my-app\nappkit-cli\n```\n\n## Linking/Unlinking for Local Development\n\n### Linking\n\nIf you want to work on the CLI and test it locally without publishing, use `npm link`:\n\n1. **Navigate to the Project Directory**:\n\n   ```bash\n   cd path/to/appkit-cli\n   ```\n\n2. **Run npm link**:\n   ```bash\n   sudo npm link\n   ```\n\n### Unlinking\n\nTo remove the symlink and unlink the CLI, use:\n\n```bash\nsudo npm unlink -g\n```\n\nThis will unregister the global command `appkit-cli`, but it won’t delete any files in your project directory.\n\n### Quick Demo\n\nhttps://github.com/user-attachments/assets/6c4fbdc3-c0ca-4edd-a730-20cfee878c86\n","isInternal":false,"tokens":407,"sizeBytes":1548},{"name":"README.md","path":"packages/codemod/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/codemod/README.md","title":"codemod Documentation","category":"plugin-manifest","format":"markdown","content":"# Reown AppKit Codemod\n\n**AppKit Codemod** is a command-line tool designed to update dependencies across multiple `package.json` files in AppKit monorepo efficiently.\n\n### Codemod Features\n\nThe codemod tool allows you to update dependencies across multiple `package.json` files in your project. It supports:\n\n- **Multiple Package Updates**: Pass multiple package names to update them all at once.\n- **Wildcard Patterns**: Use patterns like `@walletconnect/*` to update all packages under a specific organization.\n- **Version Constraint Preservation**: Maintains version constraints like `\">=4.x.x\"` when updating.\n\n## Usage\n\nYou can use the Codemod globally using npx/pnpx:\n\n```bash\npnpx @reown/appkit-codemod <process> <args...>\n```\n\n### Options\n\n- `upgrade`: Updates dependencies to their latest versions across the monorepo.\n  - **Arguments**: One or more package names to upgrade, separated by spaces. Supports wildcards like `@org/*`.\n\nOr you can use the predefined scripts for local usage in the root of the monorepo:\n\n```bash\npnpm codemod:wc # This will upgrade all the @walletconnect/* dependencies\n```\n\n### Example Commands\n\nTo update dependencies using the codemod:\n\n```bash\nnpx appkit-codemod wagmi @wagmi/core @walletconnect/utils\nnpx appkit-codemod @walletconnect/*\n```\n","isInternal":false,"tokens":307,"sizeBytes":1283},{"name":"README.md","path":"packages/common/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/common/README.md","title":"common Documentation","category":"plugin-manifest","format":"markdown","content":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","isInternal":false,"tokens":545,"sizeBytes":1975},{"name":"README.md","path":"packages/controllers/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/controllers/README.md","title":"controllers Documentation","category":"plugin-manifest","format":"markdown","content":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","isInternal":false,"tokens":545,"sizeBytes":1975},{"name":"README.md","path":"packages/core-legacy/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/core-legacy/README.md","title":"core-legacy Documentation","category":"plugin-manifest","format":"markdown","content":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","isInternal":false,"tokens":545,"sizeBytes":1975},{"name":"README.md","path":"packages/experimental/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/experimental/README.md","title":"experimental Documentation","category":"plugin-manifest","format":"markdown","content":"#### 📚 [Documentation](https://docs.reown.com/2.0/appkit/about)\n\n#### 🔗 [Website](https://reown.com/appkit)\n\n# AppKit Experimental (@reown/appkit-experimental)\n\nThe @reown/appkit-experimental package provides a set of cutting-edge, experimental features for Web3 developers. This package serves as a testing ground for innovative concepts and implementations that are not yet widely adopted or standardized in the blockchain ecosystem.\n\n## Key Characteristics\n\n- **Experimental Nature**: Features in this package are considered experimental and may undergo significant changes.\n- **EIP Implementation**: Includes implementations of non-finalized Ethereum Improvement Proposals (EIPs).\n- **Ecosystem Exploration**: Offers functionalities that are not yet widely adopted in the broader Web3 ecosystem.\n\n## Installation\n\n```bash\nnpm install @reown/appkit-experimental\n```\n\n## Smart Session\n\nThe `@reown/appkit-experimental/smart-session` allows developers to easily integrate session-based permission handling within their dApps. Using the `grantPermissions` method, dApps can send permission requests to connected wallets.\n","isInternal":false,"tokens":226,"sizeBytes":1127},{"name":"README.md","path":"packages/polyfills/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/polyfills/README.md","title":"polyfills Documentation","category":"plugin-manifest","format":"markdown","content":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","isInternal":false,"tokens":545,"sizeBytes":1975},{"name":"README.md","path":"packages/scaffold-ui/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/scaffold-ui/README.md","title":"scaffold-ui Documentation","category":"plugin-manifest","format":"markdown","content":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","isInternal":false,"tokens":545,"sizeBytes":1975},{"name":"README.md","path":"packages/siwe/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/siwe/README.md","title":"siwe Documentation","category":"plugin-manifest","format":"markdown","content":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n� [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・�📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","isInternal":false,"tokens":544,"sizeBytes":1977},{"name":"README.md","path":"packages/siwx/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/siwx/README.md","title":"siwx Documentation","category":"plugin-manifest","format":"markdown","content":"#### 📚 [Documentation](https://docs.reown.com/2.0/appkit/about)\n\n#### 🔗 [Website](https://reown.com/appkit)\n\n# AppKit SIWX\n\nThe chain agnostic tool to enable authentication for AppKit applications.\n\n> [!WARNING]\n> This package is still in development and should not be used in production.\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n","isInternal":false,"tokens":111,"sizeBytes":424},{"name":"README.md","path":"packages/testing/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/testing/README.md","title":"testing Documentation","category":"plugin-manifest","format":"markdown","content":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","isInternal":false,"tokens":545,"sizeBytes":1975},{"name":"README.md","path":"packages/ui/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/ui/README.md","title":"ui Documentation","category":"plugin-manifest","format":"markdown","content":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n� [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・�📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","isInternal":false,"tokens":544,"sizeBytes":1977},{"name":"README.md","path":"packages/universal-connector/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/universal-connector/README.md","title":"universal-connector Documentation","category":"plugin-manifest","format":"markdown","content":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","isInternal":false,"tokens":545,"sizeBytes":1975},{"name":"README.md","path":"packages/wallet/README.md","rawUrl":"https://raw.githubusercontent.com/reown-com/appkit/HEAD/packages/wallet/README.md","title":"wallet Documentation","category":"plugin-manifest","format":"markdown","content":"# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n","isInternal":false,"tokens":545,"sizeBytes":1975}],"systemPromptSnippet":"<yakaai_skills repo=\"reown-com/appkit\">\n<!-- File: AGENTS.md (Tokens: ~2125 | Category: root-instruction) -->\n# AGENTS.md\n\nReown AppKit — a multi-chain onchain SDK providing wallet connection, authentication, swaps, on-ramp, and transaction UX for 700+ wallets across EVM, Solana, Bitcoin, Polkadot, and TON. Available for React, Next.js, Vue, Nuxt, Svelte, vanilla JS, React Native, Flutter, and native mobile.\n\n## Quick Reference\n\n- **Package manager**: pnpm workspaces (`pnpm-workspace.yaml`)\n- **Build orchestration**: Turborepo (`turbo.json`)\n- **State management**: valtio (always import from `valtio/vanilla`)\n- **UI framework**: LitElement Web Components\n- **Testing**: Vitest (unit), Playwright (E2E in `apps/laboratory`)\n- **TypeScript**: Strict mode, ESM only, `experimentalDecorators` enabled\n\n## Commands\n\n```bash\npnpm install              # Install dependencies\npnpm build                # Build all packages (run before apps or tests)\npnpm test                 # Unit tests (Vitest)\npnpm typecheck            # Type checking (depends on build)\npnpm lint                 # ESLint\npnpm run prettier:format  # Format code (run before committing)\npnpm changeset            # Create a changeset for versioning\npnpm laboratory           # Run E2E testing app\npnpm demo:dev             # Run demo app\npnpm gallery              # Run Storybook component gallery\n```\n\n## Repository Layout\n\n```\npackages/\n  appkit/              → @reown/appkit             Main SDK facade\n  controllers/         → @reown/appkit-controllers  Valtio state management\n  ui/                  → @reown/appkit-ui           Atomic wui-* Web Components\n  scaffold-ui/         → @reown/appkit-scaffold-ui  High-level w3m-* UI flows\n  common/              → @reown/appkit-common       Shared types and utilities\n  appkit-utils/        → @reown/appkit-utils        Chain-specific helpers\n  wallet/              → @reown/appkit-wallet       Wallet models\n  pay/                 → @reown/appkit-pay          Payment flows\n  siwe/                → @reown/appkit-siwe         Sign-In With Ethereum\n  siwx/                → @reown/appkit-siwx         Cross-chain authentication\n  adapters/\n    wagmi/             → EVM via Wagmi/Viem\n    ethers/            → EVM via ethers v6\n    ethers5/           → EVM via ethers v5\n    solana/            → Solana\n    bitcoin/           → Bitcoin\n    polkadot/          → Polkadot\n    ton/               → TON\napps/\n  laboratory/          → E2E testing (Next.js + Playwright)\n  demo/                → Marketing demo\n  gallery/             → Storybook component gallery\nexamples/              → Integration examples (next-*, react-*, vue-*, svelte-*, html-*)\n```\n\n## Architecture Rules\n\n### Layer Order (dependencies flow downward only)\n\n```\napps & examples\n  ↓\nadapters (wagmi, solana, bitcoin, ethers, ...)\n  ↓\n@reown/appkit (SDK facade)\n  ↓\nscaffold-ui (w3m-*) · pay\n  ↓\nui (wui-*) · controllers · appkit-utils\n  ↓\ncommon · wallet · polyfills\n```\n\n### Import Boundaries\n\n- **ui** (`wui-*`): Cannot import from controllers, scaffold-ui, appkit, or adapters\n- **controllers**: Cannot import from ui, scaffold-ui, appkit, or adapters\n- **scaffold-ui** (`w3m-*`): Uses relative imports within the package, not `@reown/` paths\n- **adapters**: Import from `@reown/appkit` and foundations, never from controllers or ui directly\n- **Cross-package**: Always use package entrypoints or declared subpath exports, never deep internal paths\n\n### Chain Namespaces\n\n| Namespace  | Chain    | Adapter                |\n| ---------- | -------- | ---------------------- |\n| `eip155`   | EVM      | wagmi, ethers, ethers5 |\n| `solana`   | Solana   | solana                 |\n| `bip122`   | Bitcoin  | bitcoin                |\n| `polkadot` | Polkadot | polkadot               |\n| `ton`      | TON      | ton                    |\n\n## Where to Put Things\n\n| What you're building     | Where it goes                                                                                           |\n| ------------------------ | ------------------------------------------------------------------------------------------------------- |\n| New state/business logic | `packages/controllers/src/controllers/` — follow [controller pattern](.agents/context/controllers.md)   |\n| New atomic UI element    | `packages/ui/src/composites/wui-<name>/` — follow [UI guide](.agents/context/ui-components.md)          |\n| New modal view/screen    | `packages/scaffold-ui/src/views/w3m-<name>-view/` — register in RouterController + w3m-router           |\n| Reusable UI section      | `packages/scaffold-ui/src/partials/w3m-<name>/`                                                         |\n| New blockchain adapter   | `packages/adapters/<name>/` — extend AdapterBlueprint, see [adapter guide](.agents/context/adapters.md) |\n| Shared types or utils    | `packages/common/src/`                                                                                  |\n| Chain-specific helpers   | `packages/appkit-utils/src/`                                                                            |\n| Public SDK API           | `packages/appkit/exports/` — treat changes as potentially breaking                                      |\n| Unit tests               | Co-located `tests/` directory in the relevant package                                                   |\n| E2E tests                | `apps/laboratory/tests/` using Page Object Model                                                        |\n| Integration example      | `examples/<framework>-<adapter>/`                                                                       |\n\n## Code Patterns\n\n### Controllers (valtio state)\n\n```typescript\n// packages/controllers/src/controllers/MyController.ts\nimport { proxy, subscribe as sub } from 'valtio/vanilla'\nimport { subscribeKey as subKey } from 'valtio/vanilla/utils'\n\n// -- Types ----\nexport interface MyControllerState {\n  value: string\n}\n\n// -- State ----\nconst state = proxy<MyControllerState>({ value: '' })\n\n// -- Controller ----\nconst controller = {\n  state,\n  subscribe(callback: (s: MyControllerState) => void) {\n    return sub(state, () => callback(state))\n  },\n  subscribeKey<K extends keyof MyControllerState>(key: K, cb: (v: MyControllerState[K]) => void) {\n    return subKey(state, key, cb)\n  },\n  setValue(v: string) {\n    state.value = v\n  }\n}\nexport const MyController = withErrorBoundary(controller)\n```\n\nSection comments (`// -- Types ----`, `// -- State ----`, `// -- Controller ----`) are enforced by DangerJS.\n\n### UI Atoms (wui-\\*)\n\n```typescript\n// packages/ui/src/composites/wui-my-thing/index.ts\n@customElement('wui-my-thing')\nexport class WuiMyThing extends LitElement {\n  public static override styles = [resetStyles, styles] // resetStyles required\n  // -- State & Properties ----\n  @property() public variant = 'default' // @state() NOT allowed\n  // -- Render ----\n  public override render() {\n    return html`<slot></slot>`\n  }\n}\n```\n\n### Scaffold Views (w3m-\\*)\n\n```typescript\n// packages/scaffold-ui/src/views/w3m-my-view/index.ts\n@customElement('w3m-my-view')\nexport class W3mMyView extends LitElement {\n  private unsubscribe: (() => void)[] = [] // Cleanup required\n  @state() private value = SomeController.state.value\n\n  constructor() {\n    super()\n    this.unsubscribe.push(\n      SomeController.subscribeKey('value', v => {\n        this.value = v\n      })\n    )\n  }\n\n  public override disconnectedCallback() {\n    this.unsubscribe.forEach(u => u())\n  }\n}\n```\n\n### Adapters\n\nExtend `AdapterBlueprint` from `packages/controllers/src/controllers/AdapterController/ChainAdapterBlueprint.ts`. Implement: `connect()`, `disconnect()`, `switchNetwork()`, `signMessage()`, `sendTransaction()`, `getBalance()`. Host SDKs go in `peerDependencies`.\n\n## PR Requirements\n\n1. Run `pnpm build && pnpm run prettier:format` before submitting\n2. Use conventional commit format for PR titles (`feat:`, `fix:`, `chore:`, `refactor:`, `test:`, `docs:`)\n3. Bug fixes and new features require tests\n4. Create a changeset: `pnpm changeset`\n5. DangerJS validates import boundaries, naming conventions, section comments, and dependency rules\n\n## Versioning\n\nAll `@reown/appkit-*` packages are versioned together as a fixed group via Changesets. Release channels: `latest`, `alpha`, `beta`, `canary`. `@examples/*` and `@apps/*` are excluded from publishing.\n\n## Detailed Context\n\nFor in-depth guidance on specific topics:\n\n- [Architecture & Initialization Flow](.agents/context/architecture.md) — layer diagram, import boundaries, init sequence, network request policy\n- [Controllers Reference](.agents/context/controllers.md) — valtio patterns, all controllers, state shapes\n- [UI Components Guide](.agents/context/ui-components.md) — wui-_ and w3m-_ patterns, DangerJS rules, adding views\n- [Blockchain Adapters Guide](.agents/context/adapters.md) — AdapterBlueprint, creating new adapters\n- [Testing Guide](.agents/context/testing.md) — Vitest, Playwright, test locations, writing new tests\n- [Package Reference](.agents/context/packages.md) — all packages, build outputs, adding packages\n- [Contributing & PR Guide](.agents/context/contributing.md) — PR checks, changesets, release process\n\n<!-- File: CLAUDE.md (Tokens: ~3 | Category: claude-rule) -->\nAGENTS.md\n\n<!-- File: .cursor/rules/appkit-apps.mdc (Tokens: ~274 | Category: cursor-rule) -->\n---\ndescription: Focused rules for working in apps (dev, testing, wiring AppKit into apps)\nglobs:\n  - 'apps/**'\nalwaysApply: false\n---\n\n## AppKit Apps Rules\n\nUse these when changing code under `apps/**`.\n\n### Development & Scripts\n\n- Use workspace scripts: `pnpm --filter @apps/<name> dev|build`.\n- Build dependencies first with `pnpm build` if packages changed.\n- Keep app configs minimal; rely on package exports and avoid deep imports.\n\n### Integrating AppKit\n\n- Import via facade or adapter packages, e.g.:\n  ```ts\n  import { createAppKit } from '@reown/appkit'\n  import { ControllersProvider } from '@reown/appkit-controllers/react'\n  ```\n- Prefer framework subpaths when available: `@reown/appkit/react`, `@reown/appkit-controllers/react`.\n\n### Testing\n\n- Vitest for unit/integration; Playwright in `apps/laboratory` for e2e.\n- Co-locate basic tests within app directories where meaningful; heavy e2e in laboratory app.\n\n### SSR & Client Boundaries\n\n- Guard browser-only APIs (e.g., `window`) for SSR routes.\n- Avoid importing `@reown/appkit-ui` directly in server components; use client components wrappers.\n\n<!-- File: .cursor/rules/appkit-examples.mdc (Tokens: ~189 | Category: cursor-rule) -->\n---\ndescription: Focused rules for examples (usage patterns, adapters, CDN builds)\nglobs:\n  - 'examples/**'\nalwaysApply: false\n---\n\n## AppKit Examples Rules\n\nThese rules apply to `examples/**`.\n\n### Usage Patterns\n\n- Import from public entrypoints of packages (`@reown/appkit`, `@reown/appkit-adapter-*`).\n- Do not deep import internal paths.\n- Keep example code minimal, readable, and framework-idiomatic.\n\n### Adapters & Peers\n\n- Respect `peerDependencies`: install `wagmi`/`viem`/`ethers` in examples that need them.\n- Prefer the adapter suited to the framework: wagmi for React, ethers for generic EVM, solana adapter for Solana.\n\n### CDN\n\n- For CDN-based examples, use `@reown/appkit-cdn` outputs and ensure polyfills are present when required.\n\n<!-- File: .cursor/rules/appkit-monorepo.mdc (Tokens: ~3335 | Category: cursor-rule) -->\n---\ndescription: Monorepo-wide rules for Reown AppKit: structure, layering, packaging, and TS/SDK best practices\nglobs:\n  - \"packages/**\"\n  - \"apps/**\"\n  - \"examples/**\"\n  - \"services/**\"\n  - \"scripts/**\"\n  - \"turbo.json\"\n  - \"pnpm-workspace.yaml\"\n  - \"vitest.workspace.ts\"\nalwaysApply: true\n---\n\n## Cursor Rules: Reown AppKit Monorepo\n\nThis document orients Cursor to the structure, relationships, and common patterns across the Reown AppKit monorepo. It also encodes TypeScript and SDK development best practices to keep edits consistent, safe, and maintainable.\n\n### Monorepo Overview\n\n- **Package manager**: `pnpm` workspaces (`pnpm-workspace.yaml`)\n- **Build Orchestration**: `turbo` tasks (`turbo.json`) with cached `build`, `typecheck`, `lint`, `test`\n- **Testing**: `vitest` (workspace config in `vitest.workspace.ts`, default `jsdom` env)\n- **Repo roots**:\n  - `packages/` — publishable libraries and internal SDK modules\n  - `apps/` — product and demo applications (`gallery`, `laboratory`, `demo`, `browser-extension`)\n  - `examples/` — integration examples (Next, React, Vue, Svelte, plain HTML)\n  - `services/` — ancillary services (e.g., `id-allocation-service`)\n  - `scripts/`, `patches/`, root configs\n\n### High-Level Architecture and Package Roles\n\n- **SDK Facade**: `@reown/appkit`\n\n  - Public, framework-agnostic entrypoint. Re-exports subdomains and framework layers via subpath exports.\n  - Depends on: `@reown/appkit-common`, `@reown/appkit-controllers`, `@reown/appkit-pay`, `@reown/appkit-polyfills`, `@reown/appkit-scaffold-ui`, `@reown/appkit-ui`, `@reown/appkit-utils`, `@reown/appkit-wallet`, plus ecosystem deps (`valtio`, `viem`, `@walletconnect/universal-provider`).\n  - Provides subpaths like `./react`, `./vue`, `./utils`, `./adapters`, `./connectors`, etc.\n\n- **Domain Foundations**:\n\n  - `@reown/appkit-common`: shared types, math/date utils, light helpers. ESM only.\n  - `@reown/appkit-wallet`: wallet models, schema validation, core wallet utilities (depends on `common`, `polyfills`).\n  - `@reown/appkit-controllers`: stateful logic and business rules, with `valtio` for reactive state. Framework-agnostic; provides optional `react`/`vue` subpaths.\n  - `@reown/appkit-utils`: integration helpers per chain/family (Ethers, Solana, Bitcoin, Wallet Standard). Depends on `common`, `controllers`, `wallet`, `polyfills`.\n\n- **UI Layers**:\n\n  - `@reown/appkit-ui`: low-level UI as Web Components (Lit). Exports many `wui-*` components; no app logic.\n  - `@reown/appkit-scaffold-ui`: mid/high-level UI flows (modal, router containers, pay/onramp flows). Composes `@reown/appkit-ui` and `controllers`.\n  - `@reown/appkit-wallet-button`: focused UI package that composes `ui`, `controllers`, `utils`; optional `@lit/react` wrapper.\n\n- **Authentication and Pay**:\n\n  - `@reown/appkit-siwe`: Sign-In With Ethereum UX + controllers integration.\n  - `@reown/appkit-siwx`: Cross-chain SIWx utilities for EVM, Solana, Bitcoin, etc. No direct UI dependency.\n  - `@reown/appkit-pay`: UI + state for pay flows; composes `ui`, `controllers`, `utils`.\n\n- **Adapters (ecosystem integrations)**: `packages/adapters/*`\n\n  - `@reown/appkit-adapter-wagmi`, `-ethers`, `-ethers5`, `-solana`, `-bitcoin` (and private `-polkadot`).\n  - All depend on `@reown/appkit` + foundations; expose framework subpaths when relevant (`react`, `vue` in some packages).\n  - Use `peerDependencies` for host frameworks/SDKs (e.g., `wagmi`, `viem`, `ethers`) and `optionalDependencies` for optional wallets/providers.\n\n- **Bridging, Polyfills, Experimental, CDN**:\n\n  - `@reown/appkit-universal-connector`: thin bridge to `@walletconnect/universal-provider`.\n  - `@reown/appkit-polyfills`: browser `buffer` and similar shims.\n  - `@reown/appkit-experimental`: gated/unstable features (e.g., smart session). Depends on core packages.\n  - `@reown/appkit-cdn`: prebundled CDN builds (not tree-shaken by consumers). Depends on `appkit` and adapters.\n\n- **Tooling**:\n  - `@reown/appkit-testing`: test harnesses (includes Playwright for e2e; depends on `@reown/appkit`).\n  - `@reown/appkit-cli`: simple scaffolding/utility CLI.\n  - `@reown/appkit-codemod`: upgrade helper for dependency migrations.\n  - `@reown/appkit-core` (in `core-legacy/`): legacy compatibility wrapper around controllers.\n\n### Allowed Dependencies and Import Boundaries\n\n- Favor a layered graph from foundations → controllers → ui/scaffold → appkit (facade) → adapters/apps.\n- Avoid cyclical imports. Do not import upward across layers (e.g., `ui` must not import from `appkit` or app code).\n- Only import via package entrypoints or declared subpath exports; avoid deep, relative cross-package imports.\n  - Good: `import { X } from '@reown/appkit-controllers'`\n  - Good: `import { WuiButton } from '@reown/appkit-ui/wui-button'`\n  - Avoid: `import { X } from '@reown/appkit-controllers/dist/...` (internal paths are not stable)\n- Framework subpaths are explicitly exported (e.g., `./react`, `./vue`) when available; prefer those over bundling framework internals.\n- Keep optional or host-specific libraries as `peerDependencies` (e.g., `wagmi`, `viem`, `ethers`) and mark optional features as `optionalDependencies` to keep the core light.\n\n### Packaging and Build Conventions\n\n- All packages are ESM (`\"type\": \"module\"`).\n- Build outputs:\n  - JS: `dist/esm/...`\n  - Types: `dist/types/...`\n  - `package.json` uses `exports` map and (where relevant) `typesVersions` for editor compatibility.\n- Use `\"sideEffects\": false` when the package is tree-shakeable (most are). Ensure top-level side effects are avoided.\n- Scripts:\n  - `build:clean`: remove `dist`\n  - `build`: `tsc --build` (some use `tsconfig.build.json`)\n  - `watch`: `tsc --watch`\n  - `typecheck`: `tsc --noEmit`\n  - `lint`: ESLint across TS/JS files\n  - `test`: Vitest (most with coverage)\n- Orchestration:\n  - Use `turbo run build --filter={./packages/**/*}` for workspace builds.\n  - `typecheck` and `lint` are cached by turbo; `test` is typically not cached.\n\n### UI Patterns\n\n- Base UI uses Lit Web Components, exported as `wui-*` elements from `@reown/appkit-ui`.\n- Higher-level UI flows and composition live in `@reown/appkit-scaffold-ui` and focus on orchestration (modal, router container, lists, pay/onramp flows).\n- Do not embed business logic into `@reown/appkit-ui`. Use `controllers`/`utils` for non-visual logic and data.\n- If providing React wrappers for Web Components, expose them via explicit subpath exports (e.g., `./react`) and keep them optional to avoid forcing React in core packages.\n\n### State, Data, and External SDKs\n\n- State management is uniform with `valtio`. Controllers own reactive state; UI subscribes.\n- EVM stack uses `viem` and `wagmi` (in adapters). Solana uses `@solana/web3.js` and wallet-standard libs. Bitcoin uses `bitcoinjs-lib`, `sats-connect`.\n- WalletConnect v2 is integrated via `@walletconnect/universal-provider`. Keep provider interactions isolated in `controllers`/`utils`/adapters.\n\n### Testing Conventions\n\n- `vitest` with `jsdom` by default for DOM-related packages; Node for pure utility packages as needed.\n- Place tests under `tests/` per package.\n- `@reown/appkit-testing` includes shared testing utilities and e2e dependencies (e.g., Playwright) but is not a runtime dependency.\n\n### Versioning and Release\n\n- Managed with `changesets`. Some overrides/patches exist under `patches/`.\n- Internal packages use `workspace:*` ranges to synchronize versions.\n- Keep public API changes aggregated through `@reown/appkit` where possible to minimize breaking surface area.\n\n### Adding or Modifying Packages (Checklist)\n\n1. Create a new package under `packages/<name>` with:\n   - `package.json` using ESM, `exports` map, `files: [\"dist\", \"README.md\"]`, and `sideEffects: false` if safe.\n   - `tsconfig.json` and optionally `tsconfig.build.json` with incremental builds.\n   - `vitest.config.ts` if tests are present.\n2. Define clear dependencies:\n   - Internal deps via `workspace:*`.\n   - External host libs as `peerDependencies` (and mark optional when applicable).\n   - Optional providers/wallets as `optionalDependencies`.\n3. Expose subpaths deliberately (e.g., `./react`, `./vue`, `./utils`) only when stable and necessary.\n4. Keep layering intact: do not import up the stack; avoid cross-layer leakage.\n5. Add targeted unit tests for new behavior and update examples if developer UX changes.\n6. Run `pnpm build`, `pnpm run typecheck`, `pnpm run lint`, and `pnpm test` locally.\n\n### Adapter Authoring Guidelines\n\n- Mirror existing adapters for structure and scripts.\n- Depend on `@reown/appkit`, `@reown/appkit-controllers`, `@reown/appkit-utils`, `@reown/appkit-common`, and where needed `@reown/appkit-ui`.\n- Treat ecosystem SDKs as `peerDependencies` (e.g., `wagmi`, `viem`, `ethers`) to defer version control to the host app; use `optionalDependencies` for optional wallet SDKs (e.g., Coinbase, Safe).\n- Keep business logic inside controllers/utilities; adapters should translate between host SDK APIs and AppKit abstractions.\n\n### Import and API Design Best Practices (TypeScript)\n\n- Public APIs must be explicitly exported via the `exports` map and stable subpaths. Avoid deep internal imports.\n- Use `export type` for types-only exports to aid tree-shaking and ergonomics.\n- Prefer narrow, well-named interfaces and parameter objects over positional args.\n- Do not leak implementation-specific types from third-party SDKs across package boundaries; wrap or map to internal domain types.\n- Add `strict` TS configs and avoid `any`. Use discriminated unions for variant states.\n- Use early returns and guard clauses; avoid deep nesting.\n- Validate inputs near boundaries (e.g., adapter entrypoints). Use `zod` when schemas are involved.\n- Errors: throw typed errors or return structured `Result`-like objects where it improves developer ergonomics; never swallow exceptions.\n\n### Performance and Security Notes\n\n- Keep packages tree-shakeable; avoid top-level side effects and large transitive deps in core layers.\n- Use `peerDependencies` to avoid bundling multiple versions of large SDKs.\n- Be mindful of SSR: avoid direct `window` access in shared code; gate browser-only code.\n- Sanitize and validate user inputs in UI flows and adapters. Do not interpolate untrusted values into DOM without escaping.\n- Avoid logging secrets or PII. Use structured logs (debug-only in dev paths).\n\n### Practical Examples\n\nImports (prefer subpaths when they exist):\n\n```ts\nimport { createAppKit } from '@reown/appkit'\nimport { createWagmiAdapter } from '@reown/appkit-adapter-wagmi'\nimport { AccountController } from '@reown/appkit-controllers'\nimport { W3mModal } from '@reown/appkit-scaffold-ui/w3m-modal'\nimport { WuiButton } from '@reown/appkit-ui/wui-button'\n```\n\nReact/Vue subpaths (when provided):\n\n```ts\nimport { ControllersProvider } from '@reown/appkit-controllers/react'\nimport { AppKitProvider } from '@reown/appkit/react'\n```\n\n### What Cursor Should Assume When Editing\n\n- Respect the layering and import boundaries above. If a change requires crossing a boundary, propose an abstraction in a lower layer instead.\n- When adding a new exported module:\n  - Update the package `exports` map and type paths.\n  - Add unit tests and minimal examples.\n  - Keep `sideEffects: false` valid by avoiding module-level effects.\n- For UI changes:\n  - Add new components under `@reown/appkit-ui` with `wui-` prefix, minimal logic.\n  - Compose flows under `@reown/appkit-scaffold-ui`.\n  - Keep controllers/data-fetching outside UI layers.\n- For adapters:\n  - Prefer compile-time type safety over runtime checks; encode invariants in types.\n  - Ensure version constraints are compatible with examples and CDN builds.\n\n### Quick Map of Key Packages\n\n- `@reown/appkit` — SDK facade and top-level exports\n- `@reown/appkit-common` — shared types/utils\n- `@reown/appkit-wallet` — wallet models/utilities\n- `@reown/appkit-controllers` — stateful domain logic (valtio state)\n- `@reown/appkit-utils` — chain/wallet helpers\n- `@reown/appkit-ui` — base UI (Lit Web Components, `wui-*`)\n- `@reown/appkit-scaffold-ui` — modal/router/pay/onramp flows\n- `@reown/appkit-pay` — pay feature surface (UI + controllers)\n- `@reown/appkit-siwe` / `@reown/appkit-siwx` — auth flows and utilities\n- `@reown/appkit-universal-connector` — WalletConnect bridge\n- `@reown/appkit-adapter-*` — ecosystem adapters (Wagmi/Ethers/Ethers5/Solana/Bitcoin)\n- `@reown/appkit-polyfills` — browser polyfills\n- `@reown/appkit-cdn` — CDN bundles\n- `@reown/appkit-testing` — test harnesses\n- `@reown/appkit-cli` / `@reown/appkit-codemod` — dev tooling\n- `@reown/appkit-core` — legacy wrapper around controllers\n\n---\n\nIf a change seems to violate these rules, prefer refactoring toward these boundaries or proposing a clear abstraction that preserves the layering.\n\n<!-- File: .cursor/rules/appkit-packages.mdc (Tokens: ~984 | Category: cursor-rule) -->\n---\ndescription: Focused rules for working in packages (controllers, scaffold-ui views, new packages)\nglobs:\n  - 'packages/**'\nalwaysApply: false\n---\n\n## AppKit Packages Rules\n\nThese rules are scoped to `packages/**` and capture concrete, actionable guidance for day-to-day changes.\n\n### Controllers: State Management\n\n- Use `valtio/vanilla` `proxy` for state and `subscribeKey` for fine-grained subscriptions.\n- Keep controller surface small: `state` object and pure methods that mutate state.\n- Wrap controllers with `withErrorBoundary` to guard external call-sites.\n- Do not import UI code into controllers. Controllers depend only on foundations/utilities.\n- Example references:\n  - Router state shape and navigation: `packages/controllers/src/controllers/RouterController.ts`\n  - Proxy usage per chain: `packages/controllers/src/controllers/ChainController.ts`\n  - Error boundary util: `packages/controllers/src/utils/withErrorBoundary.ts`\n\nWhen updating state:\n\n- Prefer `replace`/`reset`/`push` style APIs for navigation and history changes.\n- Avoid deep nested state updates; compute next values and assign once.\n- Do not catch and swallow errors; either rethrow typed or use the error boundary.\n\n### Scaffold UI: Adding a New View\n\nUse Lit Web Components and the router:\n\n1. Create a view component under `packages/scaffold-ui/src/views/` named `w3m-my-feature-view`.\n2. Export it from the scaffold package (via existing barrel/exports pattern).\n3. Add a new discriminant to `RouterControllerState['view']` in `packages/controllers/src/controllers/RouterController.ts`.\n4. Map the new view in `packages/scaffold-ui/src/modal/w3m-router/index.ts` `viewTemplate` switch:\n   - Case: `'MyFeature'` → `<w3m-my-feature-view></w3m-my-feature-view>`.\n5. Navigate with `RouterController.push('MyFeature')` from actions.\n6. If the view participates in history transitions, no extra work is needed; `w3m-router-container` animates based on `history`.\n\nReferences:\n\n- Router container transitions: `packages/scaffold-ui/src/partials/w3m-router-container/index.ts`\n- Router view switch: `packages/scaffold-ui/src/modal/w3m-router/index.ts`\n- View enum and history: `packages/controllers/src/controllers/RouterController.ts`\n\nView guidelines:\n\n- Keep logic minimal in views; delegate to controllers/helpers.\n- Use `@reown/appkit-ui` primitives (`wui-*`) for visuals.\n- Avoid accessing `window` without SSR guards.\n\n### Adding a New Package\n\n1. Create `packages/<name>/` with ESM config and `exports` map.\n2. Dependencies:\n   - Internal deps as `workspace:*`.\n   - Host libraries as `peerDependencies` and optional wallets/providers as `optionalDependencies`.\n3. Scripts: `build:clean`, `build` (tsc --build), `watch`, `typecheck`, `lint`, `test` (vitest).\n4. Add `sideEffects: false` if safe; avoid top-level side effects.\n5. Expose subpaths deliberately (e.g., `./react`, `./vue`, `./utils`) only when stable.\n6. Add `vitest.config.ts` and `tests/` if applicable.\n7. Update examples or CDN if developer UX changes.\n\nChecklist snippet:\n\n```json\n{\n  \"type\": \"module\",\n  \"sideEffects\": false,\n  \"exports\": { \".\": { \"types\": \"./dist/types/index.d.ts\", \"import\": \"./dist/esm/index.js\" } }\n}\n```\n\n### TypeScript & API\n\n- Use `export type` for types-only exports.\n- Avoid `any`; prefer discriminated unions for variant states.\n- Do not leak third-party types across boundaries; map to internal domain types.\n- Validate adapter inputs with `zod` where schemas are involved.\n\n#### Public API and Breaking Changes\n\n- The `exports` entrypoints (e.g., `packages/appkit/exports/*.ts`) define the public SDK surface used by external developers.\n- Treat any change to exported functions, classes, or types as potentially breaking.\n- Follow semver: breaking changes require a major bump and a clear Changeset entry describing migration.\n- Prefer additive changes over mutations; deprecate first with JSDoc `@deprecated` and keep shims until the next major.\n- Keep exports stable and avoid re-exporting deep internals that may change frequently.\n\n### Security & Performance\n\n- Sanitize user inputs; avoid injecting untrusted values into DOM.\n- Keep packages tree-shakeable and SSR-safe.\n- Use `peerDependencies` for large host SDKs to avoid duplicate bundles.\n\n<!-- File: .cursor/commands/add-documentation.md (Tokens: ~142 | Category: command-prompt) -->\n# Add Documentation\n\nPlease add comprehensive documentation for the current code/feature. Include:\n\n## Overview\n\n- What this code/feature does\n- Why it exists and its purpose\n- Key concepts and terminology\n\n## API Documentation\n\n- Function/method signatures\n- Parameters and return values\n- Example usage with code snippets\n- Error handling and edge cases\n\n## Implementation Details\n\n- Architecture overview\n- Important design decisions\n- Dependencies and integrations\n\n## Examples\n\n- Common use cases with full examples\n- Best practices and patterns\n- Common pitfalls to avoid\n\nFormat the documentation according to the project's documentation standards and\ninclude it in the appropriate location (README, docs folder, or inline\ncomments).\n\n<!-- File: .cursor/commands/address-github-pr-comments.md (Tokens: ~252 | Category: command-prompt) -->\n# Address GitHub PR Comments\n\n## Overview\n\nProcess outstanding reviewer feedback, apply required fixes, and draft clear\nresponses for each GitHub pull-request comment.\n\n## Steps\n\n1. **Sync and audit comments**\n   - Pull the latest branch changes\n   - Open the PR conversation view and read every unresolved comment\n   - Group comments by affected files or themes\n2. **Plan resolutions**\n   - List the requested code edits for each thread\n   - Identify clarifications or additional context you must provide\n   - Note any dependencies or blockers before implementing changes\n3. **Implement fixes**\n   - Apply targeted updates addressing one comment thread at a time\n   - Run relevant tests or linters after impactful changes\n   - Stage changes with commits that reference the addressed feedback\n4. **Draft responses**\n   - Summarize the action taken or reasoning provided for each comment\n   - Link to commits or lines when clarification helps reviewers verify\n   - Highlight any remaining questions or follow-up needs\n\n## Response Checklist\n\n- [ ] All reviewer comments acknowledged\n- [ ] Required code changes implemented and tested\n- [ ] Clarifying explanations prepared for nuanced threads\n- [ ] Follow-up items documented or escalated\n- [ ] PR status updated for reviewers\n\n<!-- File: .cursor/commands/code-review.md (Tokens: ~395 | Category: command-prompt) -->\n# Code Review\n\n## Overview\n\nPerform a thorough code review that verifies functionality, maintainability, and\nsecurity before approving a change. Focus on architecture, readability,\nperformance implications, and provide actionable suggestions for improvement.\n\n## Steps\n\n1. **Understand the change**\n   - Read the PR description and related issues for context\n   - Identify the scope of files and features impacted\n   - Note any assumptions or questions to clarify with the author\n2. **Validate functionality**\n   - Confirm the code delivers the intended behavior\n   - Exercise edge cases or guard conditions mentally or by running locally\n   - Check error handling paths and logging for clarity\n3. **Assess quality**\n   - Ensure functions are focused, names are descriptive, and code is readable\n   - Watch for duplication, dead code, or missing tests\n   - Verify documentation and comments reflect the latest changes\n4. **Review security and risk**\n   - Look for injection points, insecure defaults, or missing validation\n   - Confirm secrets or credentials are not exposed\n   - Evaluate performance or scalability impacts of the change\n\n## Review Checklist\n\n### Functionality\n\n- [ ] Intended behavior works and matches requirements\n- [ ] Edge cases handled gracefully\n- [ ] Error handling is appropriate and informative\n\n### Code Quality\n\n- [ ] Code structure is clear and maintainable\n- [ ] No unnecessary duplication or dead code\n- [ ] Tests/documentation updated as needed\n\n### Security & Safety\n\n- [ ] No obvious security vulnerabilities introduced\n- [ ] Inputs validated and outputs sanitized\n- [ ] Sensitive data handled correctly\n\n## Additional Review Notes\n\n- Architecture and design decisions considered\n- Performance bottlenecks or regressions assessed\n- Coding standards and best practices followed\n- Resource management, error handling, and logging reviewed\n- Suggested alternatives, additional test cases, or documentation updates\n  captured\n\nProvide constructive feedback with concrete examples and actionable guidance for\nthe author.\n\n<!-- File: .cursor/commands/debug-issue.md (Tokens: ~156 | Category: command-prompt) -->\n# Debug Issue\n\nHelp debug the current issue in the code. Please:\n\n## Problem Analysis\n\n- Identify the specific problem or error\n- Understand the expected vs actual behavior\n- Trace the execution flow to find the root cause\n\n## Debugging Strategy\n\n- Add appropriate logging statements\n- Suggest debugging tools and techniques\n- Identify key variables and states to monitor\n- Recommend breakpoint locations\n\n## Solution Approach\n\n- Propose potential fixes with explanations\n- Consider multiple solution approaches\n- Evaluate trade-offs of different approaches\n- Provide step-by-step resolution plan\n\n## Prevention\n\n- Suggest ways to prevent similar issues\n- Recommend additional tests or checks\n- Identify code patterns that could be improved\n\nWalk through the debugging process systematically and provide clear, actionable\nsolutions.\n\n<!-- File: .cursor/commands/fix-git-issues.md (Tokens: ~175 | Category: command-prompt) -->\n# Fix Git Issues\n\nHelp resolve common Git problems and conflicts. Address:\n\n## Merge Conflicts\n\n- Analyze conflicting changes and their context\n- Provide resolution strategies for different conflict types\n- Suggest the best approach to preserve important changes\n- Generate resolved code maintaining functionality\n\n## Branch Management\n\n- Help with branch cleanup and organization\n- Suggest rebasing vs merging strategies\n- Assist with cherry-picking specific commits\n- Guide through complex branch operations\n\n## Commit History\n\n- Help with commit message improvements\n- Assist with squashing and organizing commits\n- Guide through interactive rebase operations\n- Fix commit authorship and metadata\n\n## Repository Issues\n\n- Help recover from detached HEAD state\n- Assist with undoing commits and changes\n- Guide through stash management\n- Resolve submodule and remote issues\n\nProvide step-by-step Git commands with explanations for each situation.\n\n<!-- File: .cursor/commands/generate-pr-description.md (Tokens: ~149 | Category: command-prompt) -->\n# Generate PR Description\n\nCreate a comprehensive pull request description based on the changes in this\nbranch. Include:\n\n## Summary\n\nProvide a clear, concise summary of what this PR accomplishes.\n\n## Changes Made\n\n- List the key changes made in this PR\n- Include both code and non-code changes\n- Highlight any breaking changes\n\n## Testing\n\n- Describe how the changes were tested\n- Include any new test cases added\n- Note any manual testing performed\n\n## Related Issues\n\n- Link to any related issues or tickets\n- Use closing keywords if this PR resolves issues\n\n## Additional Notes\n\n- Any deployment considerations\n- Follow-up work required\n- Notes for reviewers\n\nFormat this as proper markdown for use in a GitHub PR description.\n\n<!-- File: .cursor/commands/light-review-existing-diffs.md (Tokens: ~228 | Category: command-prompt) -->\n# Light Review Existing Diffs\n\n## Overview\n\nPerform a quick quality pass on current diffs to surface risky areas, ensure\npolish, and flag follow-up actions for deeper review.\n\n## Steps\n\n1. **Scan recent changes**\n   - List open branches or pending commits requiring review\n   - Skim side-by-side diffs focusing on new or modified files\n   - Note files or modules with large or complex edits\n2. **Assess quality signals**\n   - Watch for TODOs, debug code, or commented blocks needing cleanup\n   - Verify naming, formatting, and imports follow project standards\n   - Check that tests or documentation were updated when behavior changed\n3. **Flag next actions**\n   - Mark sections that warrant full review or pair programming\n   - Capture questions or uncertainties to raise with the author\n   - Document any quick fixes you can apply immediately\n\n## Review Checklist\n\n- [ ] High-risk files identified\n- [ ] Debugging artifacts removed or flagged\n- [ ] Style and conventions validated\n- [ ] Tests/docs updates confirmed or requested\n- [ ] Follow-up items recorded for deeper review\n\n<!-- File: .cursor/commands/optimize-performance.md (Tokens: ~145 | Category: command-prompt) -->\n# Optimize Performance\n\nAnalyze the current code for performance bottlenecks and provide optimization\nrecommendations. Focus on:\n\n## Performance Analysis\n\n- Identify slow algorithms and inefficient data structures\n- Find memory leaks and excessive allocations\n- Detect unnecessary computations and redundant operations\n- Analyze database queries and API calls\n\n## Optimization Strategies\n\n- Suggest algorithm improvements and better data structures\n- Recommend caching strategies where appropriate\n- Propose lazy loading and pagination solutions\n- Identify opportunities for parallel processing\n\n## Implementation\n\n- Provide optimized code with explanations\n- Include performance impact estimates\n- Suggest profiling and monitoring approaches\n- Consider trade-offs between performance and maintainability\n\nFocus on measurable improvements while maintaining code quality and readability.\n\n<!-- File: packages/adapters/bitcoin/README.md (Tokens: ~544 | Category: plugin-manifest) -->\n# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n� [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・�📚 [Documentation](https://docs.reown.com/appkit/overview) ・� [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・�🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n\n<!-- File: packages/adapters/ethers/README.md (Tokens: ~544 | Category: plugin-manifest) -->\n# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n� [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・�📚 [Documentation](https://docs.reown.com/appkit/overview) ・� [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・�🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n\n<!-- File: packages/adapters/ethers5/README.md (Tokens: ~545 | Category: plugin-manifest) -->\n# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n\n<!-- File: packages/adapters/polkadot/README.md (Tokens: ~545 | Category: plugin-manifest) -->\n# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n\n<!-- File: packages/adapters/solana/README.md (Tokens: ~545 | Category: plugin-manifest) -->\n# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n\n<!-- File: packages/adapters/ton/README.md (Tokens: ~545 | Category: plugin-manifest) -->\n# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n\n<!-- File: packages/adapters/tron/README.md (Tokens: ~544 | Category: plugin-manifest) -->\n# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n� [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・�📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n\n<!-- File: packages/adapters/wagmi/README.md (Tokens: ~545 | Category: plugin-manifest) -->\n# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n\n<!-- File: packages/appkit-utils/README.md (Tokens: ~545 | Category: plugin-manifest) -->\n# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n\n<!-- File: packages/appkit/README.md (Tokens: ~545 | Category: plugin-manifest) -->\n# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n\n<!-- File: packages/cli/README.md (Tokens: ~407 | Category: plugin-manifest) -->\n# Reown AppKit CLI\n\n**AppKit CLI** is a command-line tool to fast download a funcionaly boilerplate example for Reown Web AppKit SDK.\n\n## Installation\n\nTo install this CLI tool globally for development, you can link it locally using the following commands.\n\n### Prerequisites\n\n- Node.js (v14 or later)\n- npm (v6 or later)\n\n### Clone the Repository\n\nFirst, clone this repository to your local machine:\n\n```bash\ngit clone https://github.com/reown-com/appkit-cli\ncd appkit-cli\n```\n\n### Local Installation\n\nTo test the CLI locally, use `npm link`. This allows you to run the CLI from any location on your machine.\n\n```bash\nnpm install\nsudo npm link\n```\n\n## Usage\n\nOnce linked, you can use the CLI globally by running:\n\n```bash\nappkit-cli\n```\n\nAlso you can run it directly:\n\n```bash\nnpx appkit-cli\n```\n\n### Example Commands\n\nProvide examples of some paramaeters:\n\n```bash\nappkit-cli [project-name]\n```\n\nFor example:\n\n```bash\nappkit-cli my-app\nappkit-cli\n```\n\n## Linking/Unlinking for Local Development\n\n### Linking\n\nIf you want to work on the CLI and test it locally without publishing, use `npm link`:\n\n1. **Navigate to the Project Directory**:\n\n   ```bash\n   cd path/to/appkit-cli\n   ```\n\n2. **Run npm link**:\n   ```bash\n   sudo npm link\n   ```\n\n### Unlinking\n\nTo remove the symlink and unlink the CLI, use:\n\n```bash\nsudo npm unlink -g\n```\n\nThis will unregister the global command `appkit-cli`, but it won’t delete any files in your project directory.\n\n### Quick Demo\n\nhttps://github.com/user-attachments/assets/6c4fbdc3-c0ca-4edd-a730-20cfee878c86\n\n<!-- File: packages/codemod/README.md (Tokens: ~307 | Category: plugin-manifest) -->\n# Reown AppKit Codemod\n\n**AppKit Codemod** is a command-line tool designed to update dependencies across multiple `package.json` files in AppKit monorepo efficiently.\n\n### Codemod Features\n\nThe codemod tool allows you to update dependencies across multiple `package.json` files in your project. It supports:\n\n- **Multiple Package Updates**: Pass multiple package names to update them all at once.\n- **Wildcard Patterns**: Use patterns like `@walletconnect/*` to update all packages under a specific organization.\n- **Version Constraint Preservation**: Maintains version constraints like `\">=4.x.x\"` when updating.\n\n## Usage\n\nYou can use the Codemod globally using npx/pnpx:\n\n```bash\npnpx @reown/appkit-codemod <process> <args...>\n```\n\n### Options\n\n- `upgrade`: Updates dependencies to their latest versions across the monorepo.\n  - **Arguments**: One or more package names to upgrade, separated by spaces. Supports wildcards like `@org/*`.\n\nOr you can use the predefined scripts for local usage in the root of the monorepo:\n\n```bash\npnpm codemod:wc # This will upgrade all the @walletconnect/* dependencies\n```\n\n### Example Commands\n\nTo update dependencies using the codemod:\n\n```bash\nnpx appkit-codemod wagmi @wagmi/core @walletconnect/utils\nnpx appkit-codemod @walletconnect/*\n```\n\n<!-- File: packages/common/README.md (Tokens: ~545 | Category: plugin-manifest) -->\n# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n\n<!-- File: packages/controllers/README.md (Tokens: ~545 | Category: plugin-manifest) -->\n# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n\n<!-- File: packages/core-legacy/README.md (Tokens: ~545 | Category: plugin-manifest) -->\n# AppKit\n\nThe full stack toolkit to build onchain app UX.\n\nOnboard millions of users to your app in minutes with social & email embedded wallets, web3 wallet login, crypto swaps, on-ramp and more.\n\n🛝 [Demo](https://demo.reown.com) ・🧪 [Laboratory](https://appkit-lab.reown.com) ・📚 [Documentation](https://docs.reown.com/appkit/overview) ・💻 [AppKit Web Examples](https://github.com/reown-com/appkit-web-examples) ・🔗 [Website](https://reown.com/appkit) ・🛟 [Contact us on Discord](https://discord.gg/reown)\n\n<p align=\"center\">\n  <img src=\"https://github.com/reown-com/appkit/blob/HEAD/.github/assets/header.png\" alt=\"\" border=\"0\">\n</p>\n\n## Features\n\nRefer to the \"Features\" section of the [AppKit docs](https://docs.reown.com/appkit/features).\n\n- Swaps\n- On-Ramp\n- Multi Chain\n- Multi Wallets\n- Smart Accounts\n- Telegram Mini Apps\n- Sponsored Transactions\n- Networks: EVM Chains, Solana, Bitcoin\n- AppKit Core: Chain Agnostic\n- Authentication: Email & Social Login, One-Click Auth & Sign with X (SIWX)\n\n## AppKit Available SDKs\n\n- [React](https://docs.reown.com/appkit/react/core/installation)\n- [Next](https://docs.reown.com/appkit/next/core/installation)\n- [Vue](https://docs.reown.com/appkit/vue/core/installation)\n- [Nuxt](https://docs.reown.com/appkit/nuxt/core/installation)\n- [Svelte](https://docs.reown.com/appkit/svelte/core/installation)\n- [Javascript](https://docs.reown.com/appkit/javascript/core/installation)\n- [React Native](https://docs.reown.com/appkit/react-native/core/installation)\n- [Flutter](https://docs.reown.com/appkit/flutter/core/installation)\n- [Android](https://docs.reown.com/appkit/android/core/installation)\n- [iOS](https://docs.reown.com/appkit/ios/core/installation)\n- [Unity](https://docs.reown.com/appkit/unity/core/installation)\n\n> [!NOTE]\n> If you are using Web3Modal v1–v5, please use our [migration guides](https://docs.reown.com/appkit/upgrade/to-reown-appkit-web#migrate-from-web3modal-v5-to-reown-appkit).\n\n<!-- File: packages/experimental/README.md (Tokens: ~226 | Category: plugin-manifest) -->\n#### 📚 [Documentation](https://docs.reown.com/2.0/appkit/about)\n\n#### 🔗 [Website](https://reown.com/appkit)\n\n# AppKit Experimental (@reown/appkit-experimental)\n\nThe @reown/appkit-experimental package provides a set of cutting-edge, experimental features for Web3 developers. This package serves as a testing ground for innovative concepts and implementations that are not yet widely adopted or standardized in the blockchain ecosystem.\n\n## Key Characteristics\n\n- **Experimental Nature**: Features in this package are considered experimental and may undergo significant changes.\n- **EIP Implementation**: Includes implementations of non-finalized Ethereum Improvement Proposals (EIPs).\n- **Ecosystem Exploration**: Offers functionalities that are not yet widely adopted in the broader Web3 ecosystem.\n\n## Installation\n\n```bash\nnpm install @reown/appkit-experimental\n```\n\n## Smart Session\n\nThe `@reown/appkit-experimental/smart-session` allows developers to easily integrate session-based permission handling within their dApps. Using the `grantPermissions` method, dApps can send permission requests to connected wallets.\n\n<!-- ... +8 more modular skills available via /api/skills/reown-com/appkit?path={path} -->\n</yakaai_skills>"}