CWA 2 is a prerelease (2.0.0-alpha), heading for a beta. It runs production sites; configuration can still change between releases, always with upgrade notes. View versions and support

Cwa Layer

Auth Pages

The auth pages the CWA layer provides automatically, their composables, and how to override each one with your own design.

The CWA layer ships complete auth pages for every standard authentication flow. They work immediately after installation. Authentication explains each flow and its composable.

Provided Pages

Route	Component	Composable
`/login`	`<CwaAuthLoginPage>`	`useLogin()`
`/forgot-password`	`<CwaAuthForgotPasswordPage>`	`useForgotPassword()`
`/reset-password/[username]/[token]`	`<CwaAuthResetPasswordPage>`	`useResetPassword()`
`/verify-email/[username]/[token]`	— (auto-verifies on mount)	`useVerifyEmail()`
`/confirm-new-email/[username]/[newEmail]/[token]`	— (auto-confirms on mount)	`useVerifyEmail()`

Create the same path in app/app/pages/ and your file wins over the layer's. Build it with the page's composable from the table above so it keeps the same API wiring, and set cwa: { disabled: true } in definePageMeta. Customising the Login Page has a full example and explains why the flag is required and layout isn't.

Authentication: reading auth state, each composable, protecting pages with cwa-auth and cwa-admin, and building a registration page
cwa.auth: the methods the composables call

Overview

The CWA layer — what the module auto-provides, how to override it, and how to use its reusable components in your own pages.

Admin Panel

The built-in CWA admin — pages, edit mode, the resource manager, and how to extend it with custom manager tabs.

Auth Pages

Provided Pages

Overriding a Page

Related