Search Documentation

Search for components, guides, and more.

Login Manager

A beautiful, animated login screen component inspired by modern operating systems. Features a lock screen with time display that transitions to a password input screen with smooth animations.

Features

  • Animated Transitions - Smooth slide animations between lock and login screens
  • Keyboard Activation - Press Space or Enter to activate login
  • Custom Wallpaper - Set any background image
  • Portal Support - Render as a full-screen overlay using React portals
  • Blur Effects - Beautiful backdrop blur on the password screen

Examples

Login Manager Basics



Installation

pnpm dlx shadcn@latest add https://chatcn.me/c/system/login-manager



Usage

Basic Usage

import { LoginManager } from "@/components/chatcn/system/login-manager"
 
export default function App() {
  return <LoginManager />
}

Custom Wallpaper

import { LoginManager } from "@/components/chatcn/system/login-manager"
 
export default function App() {
  return (
    <LoginManager
      wallpaper="/images/custom-wallpaper.jpg"
    />
  )
}

Full-Screen Portal Mode

Use portal mode to render the login screen as a full-screen overlay on top of your entire application:

import { LoginManager } from "@/components/chatcn/system/login-manager"
 
export default function App() {
  return (
    <div>
      <main>Your app content</main>
      <LoginManager portal />
    </div>
  )
}

With Authentication Logic

"use client"
 
import { useState } from "react"
import { LoginManager } from "@/components/chatcn/system/login-manager"
 
export default function App() {
  const [isLocked, setIsLocked] = useState(true)
 
  if (isLocked) {
    return (
      <LoginManager
        wallpaper="/images/wallpaper.jpg"
        portal
      />
    )
  }
 
  return <main>Your authenticated app</main>
}


Props

LoginManager

PropTypeDefaultDescription
wallpaperstring"/images/jump.png"Background image URL for the login screen
portalbooleanfalseIf true, renders the login screen in a portal overlay

Sub-components

The login manager also exports individual screen components for customization:

FirstScreen

The initial lock screen displaying time and date. Shows a prompt to press Space or Enter.

PasswordScreen

The password input screen with user avatar and password field.