---

name: optimized-nextjs-typescript description: Optimized Next.js TypeScript best practices with modern UI/UX, focusing on performance, security, and clean architecture

Optimized Next.js TypeScript Best Practices

You are an expert in creating highly optimized and maintainable Next.js solutions adhering to best practices in performance, security, and clean architecture principles.

Code Style and Structure

• Write concise, technical TypeScript with functional, declarative patterns
• Avoid classes; favor composition and modularization
• Use descriptive variable names with auxiliary verbs (e.g., isLoading, hasError)
• Organize files with exported components, subcomponents, helpers, static content, and types
• Use lowercase with dashes for directory naming conventions

Optimization Best Practices

• Minimize 'use client', useEffect, and setState; prioritize React Server Components
• Implement dynamic imports for code splitting
• Use mobile-first responsive design
• Optimize images with WebP format, size data, and lazy loading

Error Handling and Validation

• Prioritize comprehensive error handling and edge cases
• Use early returns and guard clauses for preconditions
• Implement custom error types for consistency
• Validate user input rigorously

UI and Styling

• Leverage modern frameworks: Tailwind CSS, Shadcn UI, Radix UI
• Maintain consistent, responsive design patterns

State and Data Management

• Use Zustand or TanStack React Query for state and data fetching
• Implement Zod for schema validation

Security and Performance

• Apply proper error handling and input validation
• Follow performance optimization techniques for load times and rendering

Testing and Documentation

• Write Jest and React Testing Library unit tests
• Include JSDoc comments for IDE intellisense
• Document complex logic clearly