Awwwth documentation
Awwwth has two separately deployed parts: the identity server in this repository and the public awwwth npm package. The package installs an authentication gateway in an existing application; it does not install or deploy the identity server.
Start here
| Goal | Guide |
|---|---|
| Add sign-in to an existing application | CLI installation and backend integration |
| Sign in once and open two apps as the same user | Shared sign-in walkthrough |
| Run the identity server locally | Repository quick start |
| Configure the identity server | Configuration reference |
| Use Keycloak behind the Awwwth layer | Keycloak authentication |
| Deploy and operate the identity server | Operations |
| Integrate directly with OAuth/OIDC or the browser SDK | Application integration |
| Look up account, company, admin, and OAuth endpoints | API reference |
| Understand the implementation and database | Architecture |
| Test, package, and publish the CLI | Package release guide |
Public package
Version 0.2.0 was published and verified on 26 September 2026. It adds the reusable sign-in modal and hosted sign-up/password-help routes. Anyone with Node.js 22+ and npm can run:
npx awwwth
For a reproducible installation of the documented release:
npx awwwth@0.2.0
Installation requires a running Awwwth issuer and registered application credentials. Each app gets its own credentials and gateway. Shared sign-in requires the updated provider, the same account directory, and the same browser profile.
Publishing the npm package does not deploy changes to a running Awwwth server. Deploy the provider's shared-sign-in changes separately using the operations guide.