bknd-registration_skill

Overview

This skill helps you set up and manage user self-registration in a Bknd application. It covers enabling/disabling registration, default roles, password policy, SDK and REST registration calls, React integration, and handling custom fields after signup. Use it to implement secure, user-friendly registration flows and avoid common pitfalls.

How this skill works

The skill inspects and configures the auth block of your Bknd app to enable self-registration and define password strategies and default roles. It provides example SDK and REST calls to register users, React form patterns using the provided hooks, and guidance for updating user records with custom fields after registration. It also documents error responses and recommended fixes.

When to use it

• Building a frontend registration form with the Bknd SDK or REST API
• Configuring auth settings like allow_register, default_role_register, and password hashing
• Testing registration endpoints from the admin panel or via curl
• Creating invite-only apps by disabling public registration and seeding users
• Adding post-registration custom fields (name, avatar) to the users entity

Best practices

• Enable bcrypt hashing for production and set a sensible minLength (>=8)
• Validate password length and matching client-side to mirror server rules
• Persist tokens by supplying storage (e.g., localStorage) to the Api client
• Define roles in config before assigning default_role_register
• Handle 409, 400, and 403 status codes explicitly in the UI

Example use cases

• Single-page app registration using bknd/react hooks and a RegisterForm component
• Server-side configuration to toggle allow_register for invite-only deployments
• Registering via SDK and immediately updating user profile with custom fields
• Automated tests hitting the REST /api/auth/password/register endpoint
• Admin workflows that create users programmatically when public registration is disabled