walletdocs

Features

Sign-up

Create the owner account with a passkey in a few seconds, then optionally let family members create their own private wallets on the same server.

There's no password to choose and no email to confirm. A wallet account is a name and a passkey.

The first account

On a fresh install, every page leads to Set up your wallet. Type your name, then:

  • Create my passkey: on this device, with Touch ID, Face ID, Windows Hello or your password manager; or
  • Save it on my iPhone (QR code): scan the code with the iPhone camera, approve with Face ID, and the passkey lives in iCloud Keychain.

You're signed in right away (a 90-day session) and land on the dashboard's welcome card. This first account is the owner. New users start with 23 default categories and their own settings.

More people

Sign-ups are open: anyone else opens /signup and goes through the same passkey step. Each member has a completely separate wallet: accounts, transactions, budgets, reminders, assistant conversations, Telegram chat. The owner sees everyone under Settings → Members.

To close sign-ups once everyone's in (recommended when the app is reachable from the internet: each account can use your assistant, and its API costs):

WALLET_ALLOW_SIGNUP=0    # in .env, then restart; also accepts false, no, off

/signup then says sign-ups are closed and the registration API refuses with 403. Existing members keep their access.

Signing in

Welcome back: Sign in with a passkey on this device, or Use my iPhone (QR code). No username: the passkey knows which account it belongs to. Add passkeys for your other devices in Settings → Security.

Lost access?

npm run auth:link on the server prints a one-time link (15 minutes) that signs you in and opens Settings → Security, where you can register a new passkey. -- --list shows users and -- --user <id> targets a member. It requires shell access to the server, which is the point.

How the ceremonies work: Auth & security.