How to use the playground
Browse remotely
- Visit auth-demo.vendidit.com.
- Use the catalog navigation to find the atom / form / flow you need.
- Each catalog page exercises one component with realistic props and shows the source inline.
- To see a complete end-to-end integration (auth provider, route
wiring, side-effects), open the corresponding page under
src/pages/in the repo.
Log in to see admin features
The demo points at the production auth-server. Log in with a
@vendidit.com email and the admin catalog pages
(AdminUserEditPanel, OrgRoleEditor, MembersList,
AuditLogTable, etc.) become functional.
Recommended workflow when adding auth to a new app
- Find the equivalent demo page. Building a login screen? Open
CompleteLoginFlow’s catalog page. Building a “members of my org” panel? OpenMembersList. - Copy the integration pattern. The catalog page shows the import,
the prop shape, and the surrounding
AuthProvidersetup. - Drop down a layer when needed. If
CompleteLoginFlowis too opinionated, look atLoginForm(a form-only). IfLoginFormis too opinionated, look at the atoms (EmailField,PasswordField,SsoButton). - Wire it in your own app using the imports the catalog shows. Pin
@vendidit/auth-clientand your framework adapter (/preact,/react, etc.).
Run the demo locally
git clone https://github.com/Vendidit/auth-client-democd auth-client-demonpm installnpm run dev # → http://localhost:5173By default the local demo talks to localhost:8080 (the auth-server’s
Docker dev port). Override via .env.local:
VITE_AUTH_SERVER_URL=https://new-auth.vendidit.com/api/v1VITE_APP_CODE=auth-demo