Villa

Passkey authentication for AI-native apps.

Quick Start

npm install @rockfridrich/villa-sdk

import { villa } from "@rockfridrich/villa-sdk";

const user = await villa.signIn();
// { address: "0x...", nickname: "alice", avatar: "🦊" }

That's it. No API keys, no configuration.

React

npm install @rockfridrich/villa-sdk @rockfridrich/villa-sdk-react

import { useVilla, VillaButton } from "@rockfridrich/villa-sdk-react";

function App() {
  const { user } = useVilla();
  return user ? <p>@{user.nickname}</p> : <VillaButton />;
}

For AI Assistants

curl https://docs.villa.cash/CLAUDE.txt

Works with Claude Code, Cursor, Windsurf, Lovable.

Links

Resource	URL
Docs	docs.villa.cash
AI Context	CLAUDE.txt
SDK	npm
React	npm

Environments

Name	URL	Purpose
Production	villa.cash	Stable
Construction	construction.villa.cash	Preview
Docs	docs.villa.cash	Documentation
PR Preview	villa-shard-{pr}-{date}.up.railway.app	Automatic PR environments

Development

bun install
bun dev           # Start all services
bun verify        # Typecheck + lint + test

Telemetry Dashboard (Local Only)

Internal dashboard for monitoring deployments, CI status, and service health.

cd apps/telemetry
bun dev           # Starts on http://localhost:3003
bun test          # Run Playwright E2E tests

Requires gh CLI authenticated (gh auth login) for GitHub API access. Not deployed - local development tool only.

Infrastructure

All services run on Railway.

License

MIT