# Sembol

> Sembol (@sembol/passkey-react) is an open-source React library where Face ID becomes a self-custodial Stellar smart wallet: an audited OpenZeppelin smart account contract owned by a passkey in the user's device. No seed phrases, no extensions, sponsored fees, fully themeable UI. MIT licensed.

Key facts: wallets are on-chain contracts (not custodial key shares); wallet creation requires a fee relayer (testnet preset includes one); theming is a typed prop compiling to --sembol-* CSS variables; every docs page below is also served as raw Markdown.

## Docs

- [Introduction](https://sembol.xyz/md/docs/index): Sembol is an open-source React library where Face ID becomes a self-custodial Stellar smart account. No seed phrases, no extensions.
- [Quickstart](https://sembol.xyz/md/docs/quickstart): Install @sembol/passkey-react and ship a working Stellar passkey wallet in one component.
- [Configuration](https://sembol.xyz/md/docs/configuration): SembolConfig fields, the testnet preset, relayer requirements, and environment overrides.
- [Components](https://sembol.xyz/md/docs/components): Prebuilt, themeable React components: provider, create, connect, balance, signing modal, signers, recovery, spending limits.
- [Hooks](https://sembol.xyz/md/docs/hooks): Headless typed hooks: wallet state, creation, connection, balance, transfers, signing, signers, recovery, spending policy.
- [Theming](https://sembol.xyz/md/docs/theming): One typed theme prop restyles every component: accent derivation, 19 tokens per scheme, radius, fonts, presets, scoped themes, CSS variables.
- [Signers & recovery](https://sembol.xyz/md/docs/security): On-chain security: backup signers, recovery credentials, spending limits enforced by the smart account contract.
- [Headless & advanced](https://sembol.xyz/md/docs/headless): unstyled components, injectable WebAuthn and storage adapters, kit injection, React Native readiness.
- [Troubleshooting](https://sembol.xyz/md/docs/troubleshooting): Passkeys per domain, iCloud passkeys in Chrome, relayer errors, Buffer polyfill, domain moves.

## Optional

- [Full documentation as one file](https://sembol.xyz/llms-full.txt): all pages concatenated
- [Live demo wallet](https://sembol.xyz/wallet): create a real testnet wallet in the browser
- [Theme builder](https://sembol.xyz/customize): generates the theme prop interactively
- [Storybook](https://storybook.sembol.xyz): every component and state, interactive
- [GitHub](https://github.com/keyboord01/sembol): source, MIT