> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Users & Authentication

> Quickly integrate login functionality into your project with built-in user management and centralized authentication.

## Core Capabilities

<CardGroup cols={3}>
  <Card title="Login Integration" icon="right-to-bracket">
    Add Email and Google login to your YouWare project with minimal setup
  </Card>

  <Card title="User Management" icon="users-gear">
    Maintain a centralized user list with essential management features in YouBase
  </Card>

  <Card title="Dashboard Analytics" icon="chart-line">
    Monitor user activity and usage patterns through a dedicated dashboard
  </Card>
</CardGroup>

***

## Authentication Methods

<CardGroup cols={3}>
  <Card title="Email Login" icon="envelope">
    Built-in email authentication with secure password handling
  </Card>

  <Card title="Google Login" icon="google">
    One-click Google OAuth integration
  </Card>

  <Card title="Temporary Accounts" icon="user-clock">
    Allow users to access your app without registration
  </Card>
</CardGroup>

### Authentication Settings

Configure which login methods your project supports and whether to allow new user registrations.

<Tabs>
  <Tab title="Email Login">
    <Card title="Email Authentication" icon="envelope">
      Traditional email and password authentication.

      **Features:**

      * Sign in with email and password
      * Optional email verification
      * Forgot password flow

      Authentication flows, password handling, and credential storage are fully managed by YouBase.
    </Card>
  </Tab>

  <Tab title="Google Login">
    <Card title="Google OAuth" icon="google">
      One-click login with Google accounts.

      **Features:**

      * Quick sign-in via Google account
      * No password management required
      * Trusted identity provider

      Users can sign in instantly with their existing Google account.
    </Card>
  </Tab>

  <Tab title="Temporary Accounts">
    <Card title="Temporary Accounts" icon="user-clock">
      Let users access your app without registration.

      **Features:**

      * Anonymous login support for frictionless access
      * Automatic user record creation for temporary sessions
      * Temporary users included in analytics

      Ideal for reducing barriers to entry and improving conversion.
    </Card>
  </Tab>
</Tabs>

<Warning>
  Sensitive authentication data (such as passwords or tokens) is never exposed to the frontend.
</Warning>

***

## User Management

The User Management module consists of two main components:

* **User List**: View user details and perform management actions
* **Dashboard**: Monitor total users (registered and temporary), daily activity, and trends

### Dashboard

The Dashboard provides visual insights into your user base:

<CardGroup cols={2}>
  <Card title="User Statistics" icon="users">
    View total counts for registered users and temporary accounts
  </Card>

  <Card title="Daily Trends" icon="chart-area">
    Track daily activity and growth patterns over time
  </Card>
</CardGroup>

### User List

The User List displays all registered users in your project.

<Note>
  **No users yet.**

  Users will appear here once someone signs up or logs in.
</Note>

Each user row displays the following information:

<CardGroup cols={2}>
  <Card title="User ID" icon="fingerprint">
    System-generated unique identifier
  </Card>

  <Card title="Email Address" icon="at">
    User's registered email
  </Card>

  <Card title="Login Method" icon="right-to-bracket">
    Email, Google, or Temporary
  </Card>

  <Card title="Account Status" icon="circle-check">
    Active or Blocked
  </Card>

  <Card title="Created At" icon="calendar">
    Account creation timestamp
  </Card>
</CardGroup>

<Info>
  All timestamps are displayed in the user's local timezone. User IDs are immutable and used internally to associate data with users.
</Info>

### User Operations

User management supports four actions:

<CardGroup cols={2}>
  <Card title="Add User" icon="user-plus">
    Manually create a new user account
  </Card>

  <Card title="Delete User" icon="user-minus">
    Remove a user account (the user can re-register afterwards; useful for removing test data)
  </Card>

  <Card title="Block User" icon="ban">
    Suspend user access (blocked users cannot log in or re-register)
  </Card>

  <Card title="Unblock User" icon="circle-check">
    Restore access for a previously blocked user
  </Card>
</CardGroup>

<Tip>
  **Delete vs Block**: Deleted users can re-register with the same email. Blocked users cannot log in or re-register until unblocked.
</Tip>

***

## Email Security

Configure email-related security options for your project.

<Warning>
  **Email Verification**: Require users to verify their email address before logging in. Enable this option to ensure users provide valid email addresses.
</Warning>

<CardGroup cols={1}>
  <Card title="Email Verification" icon="envelope-circle-check">
    Require users to verify their email before accessing the app
  </Card>

  <Card title="Password Reset Verification" icon="key">
    Require email verification code when resetting passwords
  </Card>

  <Card title="Logout All Devices on Password Change" icon="right-from-bracket">
    Automatically sign out all sessions when a user changes their password
  </Card>
</CardGroup>

***

## Custom UI

The login component uses a platform-provided default style.

To customize the login UI, send prompts to Agent, which modifies and re-renders the UI based on your instructions.

<Info>
  **Example prompt:**

  Update the default login UI to match our current website style.
</Info>

If you later update your Auth configuration, send another prompt to Agent to re-render the login UI based on the latest Auth configuration.

<Info>
  **Example prompt:**

  Re-render the login UI based on the latest Auth configuration.
</Info>

***

## Common Use Cases

Below are some common scenarios where **Users & Authentication** is useful.

You don't need to implement all of these — use them as references to decide whether this module fits your project.

<AccordionGroup>
  <Accordion title="1. Member-only pages or features" icon="lock">
    **Scenario**

    You want some pages or features to be accessible only after login.

    **Examples**

    * A private dashboard
    * A paid or invite-only tool
    * Internal tools for a team

    **What Users & Auth provides**

    * User login and identity
    * Ability to block or allow access per user
  </Accordion>

  <Accordion title="2. Saving user-specific data" icon="floppy-disk">
    **Scenario**

    Different users should see or modify their own data.

    **Examples**

    * A form where each user sees their own submissions
    * A to-do list or notes app
    * An AI tool that remembers past inputs per user

    **What Users & Auth provides**

    * A stable user ID
    * The ability to associate database records with specific users
  </Accordion>

  <Accordion title="3. Personalized experiences" icon="wand-magic-sparkles">
    **Scenario**

    Your app should behave differently depending on who is using it.

    **Examples**

    * Showing "Welcome back" messages
    * Displaying user-specific settings or preferences
    * Restoring previous sessions or history

    **What Users & Auth provides**

    * User identity recognition
    * Persistent accounts across sessions and devices
  </Accordion>

  <Accordion title="4. Controlling access without deleting data" icon="user-lock">
    **Scenario**

    You want to temporarily disable a user without losing their data.

    **Examples**

    * Suspending a user account
    * Restricting access during testing
    * Handling misuse or abuse cases

    **What Users & Auth provides**

    * Block / unblock user access
    * Preservation of all existing user data
  </Accordion>

  <Accordion title="5. Simple login for early-stage products" icon="rocket">
    **Scenario**

    You are building an MVP or prototype and want basic login without managing auth logic.

    **Examples**

    * Early SaaS prototypes
    * Side projects with limited users
    * Internal demos

    **What Users & Auth provides**

    * Fully managed email or Google login
    * Secure password handling without backend setup
  </Accordion>
</AccordionGroup>

***

## When you might not need Users & Auth

<Note>
  If your project:

  * Does not require login
  * Does not store user-specific data
  * Is purely informational or static

  You can keep **Users & Auth** disabled and enable it later when needed.
</Note>

***

<Card title="Unlock Users & Authentication" icon="rocket" color="#10B981" href="https://www.youware.com/subscription?location=docs">
  **Users & Authentication is available on Pro and Ultra plans.** Add login, user management, and analytics to your projects today.

  [View Plans & Pricing →](https://www.youware.com/subscription?location=docs)
</Card>