create-txwallet

Scaffold a runnable Sign in with TX Wallet app in one command.

npm create txwallet@latest my-app
# or
npx create-txwallet my-app

You get a Vite + React frontend (@txwallet/react) and a tiny Express backend (@txwallet/auth-express) wired together, with your app id already in .env.

cd my-app
npm install
npm run dev

Open the printed localhost URL → click Sign in with TX Wallet → approve in the wallet → you're signed in. That's the whole loop, locally, in about a minute.

Getting an app id

App registration is gated by signing in with TX Wallet (the wallet is the login). The CLI opens the 30-second register page for you; paste the txapp_... id back when prompted. For CI or scripted setups, skip the prompt:

npx create-txwallet my-app --app-id txapp_XXXXXXXXXXXXXXXXXXXXXXXXXX

Flags

| flag | meaning | |---|---| | --app-id <id> | use an existing app id (skips the browser step) | | --base-url <url> | TX Wallet base URL (default https://txwallet.tesbert.com) | | --yes, -y | no prompts (requires --app-id) |

Going to production

The scaffold runs against your app in sandbox. Before production: verify your domain and request review in the developer portal, set your real TX_WALLET_APP_DOMAIN / TX_WALLET_ALLOWED_ORIGINS, and replace the createSessionForAccount stub in server.js with your real session logic.