Features Overview
π οΈ Frameworks & Libraries:
- π Next.js 15.2 (App Router)
- βοΈ React 19
- π¦ Payload CMS 3.0
- π¨ Tailwind CSS v4
- π§© Shadcn/ui
- π§ @react-email for responsive emails
π Authentication:
- π Auth.js or Better Auth with custom adapters for Payload
- Frontend authentication components:
- Sign-in
- Sign-up
- Reset Password
- Verify Password
- Profile page
- Profile/Sign-in header menu item
- Custom styled "Verify Password" and "Reset Password" emails
π Form & Validation:
- πͺ React Hook Form
- β Zod
πΌοΈ Image Optimization:
- Custom Image Optimize Endpoint (Force Aspect Ratio)
βοΈ Code Quality & Tools:
- π§Ή ESLint 9
- β¨ Prettier
- π Structured Naming Conventions for exports and files.
π’ Deployment & Infrastructure:
- π³ Docker Compose production-ready, up-to-date setup (fully tested)
- π Self-hosted first (complete data control)
Pre-Configured Payload CMS Features π¦
- βοΈ Live Preview: Real-time preview with breakpoints for mobile, tablet, desktop
- π Draft Mode: Draft management separate from live content
- π Form Builder: Forms with React Hook Form and Zod validation
- βοΈ Email Integration: Emails via Resend with custom templates
- π Nested Content: Organized with Nested Docs Plugin
- π SEO Optimization: Built-in sitemap.ts and robots.txt
- βͺοΈ Unlimited Redirects: Regex-supported middleware redirects
- π Reusable Blocks: Global content sharing
- π Lexical Editor:
- Custom classes per HTML tag (reduces backend complexity)
- Responsive font sizes per breakpoint
- Corrected HTML for OL and UL lists
Additional Payload Adjustments ποΈ
- π₯οΈ Custom Admin UI: Styled for enhanced management
- π₯οΈ Enhanced Field Width Control: Width property without row field
β¨ Template Specific Features
- π Unique Grid Component: Easy-to-use responsive grid
- π§ Configurable Header Menu: Fixed & contracted on scroll
- π Automatic Content Hashing: Unique asset hashes for immutable caching
- ποΈ Enhanced Image Component: Dynamic aspect ratios, width, height via custom Sharp endpoint
- π View Transitions: Smooth view animations
- π₯ Transition Component: Element animations (scroll compatible with RSC)
- π Single H1 Enforcement: Improved SEO/accessibility
- π Simplified Querying: Improved querying between collections
- π οΈ Lexical HTML Fixes: Corrected OL and UL outputs
- π Dark Mode Toggle: Theme customization
- βοΈ Editable Header & Footer: CMS editable
- π Custom Section Component: Consistent block spacing
- π οΈ Custom Fields:
- Path field (cross-collection unique π€―)
- Tailwind Color field
- Dynamic Icon field (lucide-react)
Project Structure π
A structured, developer-friendly folder architecture designed specifically for clarity and scalability:
βββ src
β βββ app # Next.js pages, layouts, routing (auth/frontend/payload)
β βββ config # Payload CMS config, metadata, and globals
β βββ blocks # Payload CMS reusable blocks
β βββ components # UI components, forms, layout elements
β βββ features # Modular, feature-specific code (authentication, emails)
β βββ hooks # Reusable custom React hooks
β βββ lib # Shared utility libraries and external integrations
β βββ utils # Helper and utility functions for general use
β βββ payload # Payload CMS configurations, collections, utilities
β βββ middleware.ts # Middleware logic (redirect handling)
β
βββ scripts # Dev tooling scripts
βββ docker-compose.yml # Container setup
βββ Dockerfile # Containerized app setupCoding Philosophy π
- π οΈ Transparent and Customizable: Everything is open and adjustableβfull control, no hidden layers.
- π Continuous Improvement: Dependencies stay current for security and performance. Feedback drives progress.
- π§© Modular by Design: Tackles complex problems, but you can strip out what you donβt need.
- π§ Best Practices First: Favors native Next.js solutions and proven methods over third-party dependencies.
- π Production-Ready: Built to be optimized, secure, and maintainable for real-world use.