Wallet UI

A modern UI component library for Solana apps, built on the Wallet Standard.

This monorepo contains the core packages, documentation, and examples for Wallet UI.

• packages/core: Framework-agnostic state management using Nanostores.
• packages/react: React components and hooks.
• packages/tailwind: Tailwind CSS presets for the components.
• docs: The documentation and project website, built with Astro and Starlight.
• examples: Example applications demonstrating how to use Wallet UI.

For comprehensive documentation and usage guides, please visit wallet-ui.dev.

Getting started

git clone https://github.com/wallet-ui/wallet-ui.git
cd wallet-ui
pnpm install
# If you want to install rules for your AI agents (see below).
pnpm ruler apply --local-only

Development

Build

pnpm run build

Lint

Run the linter:

pnpm run lint

Fix any linting issues:

pnpm run style:fix

Test

pnpm run test

To generate a local HTML coverage dashboard for the published npm packages only, run:

pnpm run test:coverage:packages

This writes a clickable dashboard to tmp/coverage/published-packages/index.html.

AI Agents

We use Ruler to centralize AI agent instructions, coding guidelines, and project context. You can find these resources in the .ruler directory.

To sync the instructions for your preferred AI agents, run:

pnpm ruler apply --local-only

This will update the project's agent-specific configuration files (like AGENTS.md, CLAUDE.md, GEMINI.md, etc.) based on the shared definitions in .ruler.

Support

If you have any questions about this repo, feel free to reach out to Telegram or X.