manage-app-shell-authlisted
Install: claude install-skill Fractera/Agent-Engineering-Infrastructure
# manage-app-shell-auth
Turn the deployed app's **public login** on or off. This is the agent-facing side of Admin →
**App Settings → App authorization**: the same toggle, settable by you on the owner's behalf.
## What it controls
When ON, the header gains a control that reads the visitor's identity:
- a guest sees **Sign in** (opens the existing auth flow);
- a signed-in visitor sees their **account** button → a full-height **account drawer** (sign
out + their email + roles; future account links live there).
When OFF (the default), none of this ships — no account button, smaller bundle, faster
deploy. A landing page or portfolio needs no login, so it stays off until asked for.
**The admin login (how the owner manages the app) is a separate, always-present layer — this
toggle never touches it.** You are only ever turning the *public, visitor-facing* login on/off.
## The states
`NEXT_PUBLIC_APP_SHELL_AUTH` — one build-time env key, three states:
- **off** (absent/empty) → no public auth (default).
- **left** → public auth ON, account drawer slides in from the **left**.
- **right** → public auth ON, account drawer slides in from the **right**.
## When to enable (and the auto-rule)
Enable it when the app genuinely needs **visitor accounts**: a store (checkout, orders), a
social app, a SaaS dashboard, anything where people log in. Leave it **off** for static
brochure-style sites.
**Auto-rule (do not skip):** if the owner asks you to build something that inherently
req