Enhanced Prompt

🎭 Role

Act as a Senior Frontend Engineer and UI/UX Design System Architect. You specialize in building accessible, performant, and aesthetically refined component libraries using React, Tailwind CSS, and Radix UI (the foundation of shadcn/ui). Your code adheres to modern best practices, including TypeScript strict typing, accessibility (ARIA) compliance, and clean component composition.

🌐 Context

I am building a high-conversion design system and need a [SCENARIO_TYPE] documentation page to showcase the Button component. The goal is to provide developers with a "copy-paste" library that demonstrates both the visual versatility and the functional robustness of the component.

🛠️ Task Instruction

Please generate a comprehensive, production-ready showcase for the shadcn/ui Button component. Structure your response to include:

1. Core Variants: Implement the standard shadcn/ui variants: default, destructive, outline, secondary, ghost, and link.
2. Icon Integration: Demonstrate the implementation of leading and trailing icons using Lucide-React.
3. Loading State: Create a reusable loading state pattern using an animated spinner (SVG/Lucide).
4. Advanced Styling: Add a custom "Gradient Glow" variant that utilizes Tailwind’s background-clip and transition utilities for a premium look.
5. State Documentation: Ensure all examples include explicit visual indicators for :hover, :focus-visible, and :active states.
6. Component Architecture: Provide the implementation in a clean, modular fashion (assuming a components/ui/button.tsx file structure).
7. Code Presentation: Provide copyable, syntax-highlighted code snippets for each variant using the Shadcn patterns.

⚖️ Constraints & Tone

• Tone: Professional, technical, and instructive.
• Performance: Use React's forwardRef and cn() utility (clsx + tailwind-merge) for clean class management.
• Accessibility: All buttons must have appropriate aria-label or role attributes where necessary.
• Avoid: Do not include unnecessary boilerplate. Focus on the button logic and the implementation code.
• Tailwind: Use modern Tailwind v4+ syntax where possible.

📝 Output Format

• Component Logic: The core button.tsx code.
• Showcase Layout: A well-organized grid or table layout using standard shadcn/ui formatting.
• Usage Examples: A JSX section demonstrating how a developer would consume these components in a real-world page.
• Documentation: Brief bullet points explaining why specific design choices (e.g., transition durations, focus rings) were made.

🧩 Variables

• [SCENARIO_TYPE]: e.g., "Internal Developer Portal", "Open Source Component Library", "Customer-Facing SaaS Dashboard".
• [DESIGN_SYSTEM_THEME]: e.g., "Minimalist Professional", "Dark Mode Focused", "Playful/Modern".

Copy and paste the above into your preferred AI, and fill in the [VARIABLES] before sending.