SIGN IN SIGN UP
payloadcms / payload UNCLAIMED

Payload is the open-source, fullstack Next.js framework, giving you instant backend superpowers. Get a full TypeScript backend and admin panel instantly. Use Payload as a headless CMS or for building powerful applications.

0 0 16 TypeScript

docs: add dev note about auth strategy hot-reload requirement (#14122)

### What?
Added a documentation note informing developers that custom
authentication strategies require a full server restart and are not
hot-reloaded during development.

### Why?
During development, developers may expect auth strategies to hot-reload
like other code changes in Payload. When changes don't take effect
immediately, it leads to confusion and wasted debugging time trying to
figure out why their strategy modifications aren't working.

This small documentation addition can save developers significant time
and frustration.

### How?
- Added an informational `<Banner>` component in
`docs/authentication/custom-strategies.mdx`
- Placed it immediately after the existing warning banner at the top of
the page
- Includes a clear note about the restart requirement and suggests using
`nodemon` for auto-restart

**Before:**
Only had the warning banner about this being an advanced feature.

**After:**
Now includes an additional info banner that explicitly states auth
strategies require restart and are not hot-reloaded.

Fixes: N/A (proactive documentation improvement)
I
Ilham Saputrajati committed
c4da4539ab87c9067d6839a147ae4933c6ea3639
Parent: 8c748d6
Committed by GitHub <noreply@github.com> on 4/2/2026, 3:37:54 PM