Initial commit
This commit is contained in:
58
registry/components/AboutMetric.json
Normal file
58
registry/components/AboutMetric.json
Normal file
@@ -0,0 +1,58 @@
|
||||
{
|
||||
"name": "AboutMetric",
|
||||
"description": "About section with centered animated title and metric cards in a responsive grid.",
|
||||
"details": "Use for showcasing company metrics, achievements, and statistics with visual impact. Features centered large animated title (2xl on mobile, 5xl on desktop) using words-trigger variant with theme's default text animation. Displays 2-4 metric cards in a responsive grid (1 column mobile, 2-4 columns desktop based on metric count). Each card includes an icon in a primary-button styled container, metric label, and large value text (6xl). Cards have fixed height (h-fit with py-8 md:py-10), rounded-theme-capped borders, and centered content. Perfect for highlighting key business achievements, statistics, or milestones.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "At Berco Inc. we redefine innovation by empowering businesses to reach their full potential",
|
||||
"minChars": 20,
|
||||
"maxChars": 300
|
||||
}
|
||||
},
|
||||
"metricRules": {
|
||||
"minMetrics": 2,
|
||||
"maxMetrics": 4,
|
||||
"structure": {
|
||||
"icon": "LucideIcon - Icon component from lucide-react (required)",
|
||||
"label": "string - Descriptive label for the metric (required, e.g., 'Conversions', 'Partnered Brands')",
|
||||
"value": "string - Metric value to display (required, e.g., '7,000+', '2018', '30+', '100M+')"
|
||||
},
|
||||
"note": "Provide 2-4 metrics for optimal layout. Grid automatically adjusts columns based on metric count (2 metrics = 2 cols, 3 metrics = 3 cols, 4 metrics = 4 cols). Import icons from lucide-react."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string",
|
||||
"metrics": "Array<{ icon: LucideIcon, label: string, value: string }>",
|
||||
"metricsAnimation": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"useInvertedBackground": "boolean",
|
||||
"ariaLabel?": "string (default: 'About metrics section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"metricsContainerClassName?": "string",
|
||||
"metricCardClassName?": "string",
|
||||
"metricIconClassName?": "string",
|
||||
"metricLabelClassName?": "string",
|
||||
"metricValueClassName?": "string"
|
||||
},
|
||||
"usageExample": "// Wrap in ThemeProvider\nimport { TrendingUp, ShoppingCart, Users, Globe } from 'lucide-react';\n\n<ThemeProvider defaultButtonVariant=\"icon-arrow\" defaultTextAnimation=\"reveal-blur\" borderRadius=\"soft\" background=\"aurora\" cardStyle=\"glass-elevated\" primaryButtonStyle=\"gradient\" secondaryButtonStyle=\"glass\">\n <AboutMetric \n title=\"At Berco Inc. we redefine innovation by empowering businesses to reach their full potential\" \n useInvertedBackground={false}\n metrics={[\n { icon: TrendingUp, label: 'Conversions', value: '7,000+' },\n { icon: ShoppingCart, label: 'Ecommerce Since', value: '2018' },\n { icon: Users, label: 'Partnered Brands', value: '30+' },\n { icon: Globe, label: 'Global Impressions Generated Annually', value: '100M+' }\n ]} \n />\n</ThemeProvider>",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Use for about pages",
|
||||
"Use for company information",
|
||||
"Use for statistics displays",
|
||||
"Use for achievement showcases",
|
||||
"Requires metrics[]"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use more than 4 items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
22
registry/components/AnimatedAuroraBackground.json
Normal file
22
registry/components/AnimatedAuroraBackground.json
Normal file
@@ -0,0 +1,22 @@
|
||||
{
|
||||
"name": "AnimatedAuroraBackground",
|
||||
"description": "Aurora borealis effect with animated repeating gradients and mix-blend-difference.",
|
||||
"details": "Use for premium, vibrant backgrounds with flowing aurora animation. Features repeating linear gradients with theme colors (primary-cta, accent, secondary-cta) that animate across the screen. Uses background color for base gradient with 10px blur filter. Optional radial gradient mask (default: true) creates elliptical spotlight effect from top-right. Uses mix-blend-difference blend mode and after pseudo-element for layered animation. Requires aurora keyframes animation in globals.css. Set invertColors to true for light backgrounds, false for dark backgrounds.",
|
||||
"constraints": {},
|
||||
"propsSchema": {
|
||||
"className?": "string",
|
||||
"showRadialGradient?": "boolean (default: true)",
|
||||
"invertColors": "boolean (REQUIRED - true for light backgrounds, false for dark backgrounds)"
|
||||
},
|
||||
"usageExample": "<AnimatedAuroraBackground invertColors={true} showRadialGradient={true} />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
25
registry/components/AnimatedGridBackground.json
Normal file
25
registry/components/AnimatedGridBackground.json
Normal file
@@ -0,0 +1,25 @@
|
||||
{
|
||||
"name": "AnimatedGridBackground",
|
||||
"description": "Grid pattern with animated pulsing squares using Framer Motion with 3D perspective and radial mask from top center.",
|
||||
"details": "Use for modern, interactive backgrounds with subtle animation. Features SVG grid with randomly positioned squares that pulse in opacity. Includes 3D perspective with skew transform (skew-y-12) and stretched height (200%). Radial gradient mask positioned at top center (ellipse 100% 100% at 50% 0%) creates a dome-shaped spotlight effect fading towards edges and bottom. Uses accent color for grid lines (20% opacity) and background-accent for animated squares. Perfect for hero sections where grid should be most prominent at top. Requires framer-motion.",
|
||||
"constraints": {},
|
||||
"propsSchema": {
|
||||
"squareSize?": "number (default: 100)",
|
||||
"numSquares?": "number (default: 50)",
|
||||
"maxOpacity?": "number (default: 0.15)",
|
||||
"className?": "string"
|
||||
},
|
||||
"usageExample": "<AnimatedGridBackground squareSize={100} numSquares={50} maxOpacity={0.15} />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use more than 4 items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
21
registry/components/AuroraBackground.json
Normal file
21
registry/components/AuroraBackground.json
Normal file
@@ -0,0 +1,21 @@
|
||||
{
|
||||
"name": "AuroraBackground",
|
||||
"description": "Aurora borealis-style background with multiple rotated gradient bars and blur effect.",
|
||||
"details": "Use for premium, visually striking hero sections or landing pages. Features 5 rotated gradient bars with backdrop-blur-3xl overlay creating an aurora effect. Uses background-accent color at varying opacities (5-10%). Fixed positioning with z-0.",
|
||||
"constraints": {},
|
||||
"propsSchema": {
|
||||
"className?": "string"
|
||||
},
|
||||
"usageExample": "<AuroraBackground />",
|
||||
"do": [
|
||||
"Use for landing pages",
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
36
registry/components/AvatarGroup.json
Normal file
36
registry/components/AvatarGroup.json
Normal file
@@ -0,0 +1,36 @@
|
||||
{
|
||||
"name": "AvatarGroup",
|
||||
"description": "Displays a group of user avatars with overlapping layout and optional text label.",
|
||||
"details": "Use for showing user participation, testimonials, or social proof. Displays up to 5 avatars by default with remaining count badge. Avatars overlap with card styling. Includes optional text label (e.g., 'Join 1,000+ members').",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"text": {
|
||||
"required": false,
|
||||
"example": "Join 1,000+ members",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"avatars": "Array<{ src: string, alt?: string }> - User avatar images",
|
||||
"text?": "string",
|
||||
"maxVisible?": "number (default: 5)",
|
||||
"className?": "string",
|
||||
"avatarClassName?": "string",
|
||||
"textClassName?": "string",
|
||||
"ariaLabel?": "string (default: 'User avatars')"
|
||||
},
|
||||
"usageExample": "<AvatarGroup avatars={[{ src: '/avatar1.jpg', alt: 'User 1' }, { src: '/avatar2.jpg', alt: 'User 2' }]} text=\"Join 1,000+ members\" />",
|
||||
"do": [
|
||||
"Use for social proof",
|
||||
"Use for customer reviews",
|
||||
"Requires avatars[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
28
registry/components/BentoGlobe.json
Normal file
28
registry/components/BentoGlobe.json
Normal file
@@ -0,0 +1,28 @@
|
||||
{
|
||||
"name": "BentoGlobe",
|
||||
"description": "Interactive 3D rotating globe component using COBE library with theme-aware colors and customizable markers.",
|
||||
"details": "Use for showcasing global presence, international reach, or geographic data. Features auto-rotating 3D globe with location markers. Colors automatically sync with theme CSS variables (--card for base/glow, --primary-cta for markers). Fully customizable via COBEOptions config. Includes default world markers. Responsive with smooth opacity fade-in. Requires 'cobe' package. Best used within a card container with fixed dimensions.",
|
||||
"constraints": {
|
||||
"globeRules": {
|
||||
"config": {
|
||||
"required": false,
|
||||
"note": "Optional COBEOptions object to customize globe appearance. Default config uses theme colors: baseColor and glowColor use --card, markerColor uses --primary-cta. Can override: phi (rotation), theta (tilt), dark (darkness 0-1), diffuse (lighting), mapSamples, mapBrightness, markers (array of {location: [lat, lng], size: number}), and more. See COBE documentation for full options."
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"className?": "string",
|
||||
"config?": "COBEOptions - Custom globe configuration (see COBE docs)"
|
||||
},
|
||||
"usageExample": "<BentoGlobe className=\"w-full h-full\" config={{ markers: [{ location: [40.7128, -74.006], size: 0.1 }] }} />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
90
registry/components/BlogCardOne.json
Normal file
90
registry/components/BlogCardOne.json
Normal file
@@ -0,0 +1,90 @@
|
||||
{
|
||||
"name": "BlogCardOne",
|
||||
"description": "Blog section with card grid/carousel layout featuring image, category, title, excerpt, and author info.",
|
||||
"details": "Use for displaying blog posts or articles. Uses CardStack for adaptive layout (grid for 1-4 items, carousel for 5+). Card structure: Image with overlay arrow button → Category badge → Title → Excerpt → Author (avatar + name + date). Image has zoom effect on hover. Category displayed in primary-button badge. Optional header with title, description, tag, and buttons via CardStack. Best for blog pages, news sections, or article listings.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Latest Articles",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Insights and updates from our team",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Blog",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"blogRules": {
|
||||
"blogs": {
|
||||
"required": true,
|
||||
"minItems": 1,
|
||||
"example": "[{\"id\": \"1\", \"category\": \"Design\", \"title\": \"UX review presentations\", \"excerpt\": \"How to create compelling presentations\", \"imageSrc\": \"/blog-1.jpg\", \"authorName\": \"John Doe\", \"authorAvatar\": \"/avatar-1.jpg\", \"date\": \"20 Jan 2025\"}]",
|
||||
"note": "Array of blog items. Each item requires id, category, title, excerpt, imageSrc, authorName, authorAvatar, and date."
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"blogs": "Array<{ id: string, category: string, title: string, excerpt: string, imageSrc: string, imageAlt?: string, authorName: string, authorAvatar: string, date: string, onBlogClick?: () => void }> - Blog card items",
|
||||
"carouselMode?": "'auto' | 'buttons' (default: 'buttons')",
|
||||
"uniformGridCustomHeightClasses?": "string",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal' (required - controls GSAP scroll animations with stagger effect)",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"useInvertedBackground": "boolean",
|
||||
"ariaLabel?": "string (default: 'Blog section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"imageWrapperClassName?": "string",
|
||||
"imageClassName?": "string",
|
||||
"categoryClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"excerptClassName?": "string",
|
||||
"authorContainerClassName?": "string",
|
||||
"authorAvatarClassName?": "string",
|
||||
"authorNameClassName?": "string",
|
||||
"dateClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxTitleImageWrapperClassName?": "string - For styling image wrapper in inline-image layout",
|
||||
"textBoxTitleImageClassName?": "string - For styling images in inline-image layout",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"gridClassName?": "string",
|
||||
"carouselClassName?": "string",
|
||||
"controlsClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<BlogCardOne blogs={[{id: '1', category: 'Design', title: 'UX review presentations', excerpt: 'How to create compelling presentations that wow your audience', imageSrc: '/blog-1.jpg', authorName: 'Olivia Rhye', authorAvatar: '/avatar-1.jpg', date: '20 Jan 2025', onBlogClick: () => console.log('clicked')}]} title=\"Latest Articles\" description=\"Stay updated with our latest insights\" textboxLayout=\"default\" useInvertedBackground={false} animationType=\"slide-up\" carouselMode=\"buttons\" />",
|
||||
"do": [
|
||||
"Use for blog listings",
|
||||
"Use for article grids",
|
||||
"Requires blogs[]",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
94
registry/components/BlogCardThree.json
Normal file
94
registry/components/BlogCardThree.json
Normal file
@@ -0,0 +1,94 @@
|
||||
{
|
||||
"name": "BlogCardThree",
|
||||
"description": "Blog section with vertical card layout featuring tag, title, excerpt, optional author info, and media with overlay button.",
|
||||
"details": "Use for featured blog posts with prominent visual layout. Uses CardStack for adaptive layout (grid for 1-4 items, carousel for 5+). Card structure: Tag → Title → Excerpt → Optional Author (avatar + name + date) → Media content with overlay arrow button. Author info is optional and displays only when authorName or date is provided. Best for hero blog sections or featured articles.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Featured Articles",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Explore our latest insights",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Blog",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"blogRules": {
|
||||
"blogs": {
|
||||
"required": true,
|
||||
"minItems": 1,
|
||||
"example": "[{\"id\": \"1\", \"category\": \"Software Development\", \"title\": \"Redefining Digital Performance\", \"excerpt\": \"Optimizing speed and scalability\", \"imageSrc\": \"/blog-1.jpg\"}]",
|
||||
"note": "Array of blog items. Each item requires id, category, title, excerpt, and imageSrc."
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"blogs": "Array<{ id: string, category: string, title: string, excerpt: string, imageSrc: string, imageAlt?: string, authorName: string, authorAvatar: string, date: string, onBlogClick?: () => void }> - Blog card items",
|
||||
"carouselMode?": "'auto' | 'buttons' (default: 'buttons')",
|
||||
"uniformGridCustomHeightClasses?": "string (default: 'min-h-[600px]')",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal' (required - controls GSAP scroll animations with stagger effect)",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"useInvertedBackground": "boolean",
|
||||
"ariaLabel?": "string (default: 'Blog section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"cardContentClassName?": "string",
|
||||
"categoryTagClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"excerptClassName?": "string",
|
||||
"authorContainerClassName?": "string",
|
||||
"authorAvatarClassName?": "string",
|
||||
"authorNameClassName?": "string",
|
||||
"dateClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"mediaClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxTitleImageWrapperClassName?": "string - For styling image wrapper in inline-image layout",
|
||||
"textBoxTitleImageClassName?": "string - For styling images in inline-image layout",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"gridClassName?": "string",
|
||||
"carouselClassName?": "string",
|
||||
"controlsClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<BlogCardThree blogs={[{id: '1', category: 'Software Development', title: 'Redefining Digital Performance at Scale', excerpt: 'Optimizing speed, scalability, and user experience.', imageSrc: '/blog-1.jpg', authorName: 'Alex Chen', authorAvatar: '/avatar.jpg', date: 'Jan 15, 2025', onBlogClick: () => console.log('clicked')}]} title=\"Featured Articles\" description=\"Explore our latest insights\" textboxLayout=\"default\" useInvertedBackground={false} animationType=\"slide-up\" />",
|
||||
"do": [
|
||||
"Use for landing pages",
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Use for blog listings",
|
||||
"Use for article grids",
|
||||
"Requires blogs[]",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
88
registry/components/BlogCardTwo.json
Normal file
88
registry/components/BlogCardTwo.json
Normal file
@@ -0,0 +1,88 @@
|
||||
{
|
||||
"name": "BlogCardTwo",
|
||||
"description": "Blog section with card grid/carousel layout featuring image, optional author avatar, author/date, title, excerpt, and category badge(s).",
|
||||
"details": "Use for displaying blog posts with category categorization. Uses CardStack for adaptive layout (grid for 1-4 items, carousel for 5+). Card structure: Image with overlay arrow button → Optional Author Avatar + Author & Date → Title → Excerpt → Category badge(s). Image has zoom effect on hover. Category supports single string or array for multiple badges displayed as primary-button badges at bottom. Author avatar is optional. Optional header with title, description, tag, and buttons via CardStack. Best for blog pages with category filtering.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Latest Articles",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Insights and updates from our team",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Blog",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"blogRules": {
|
||||
"blogs": {
|
||||
"required": true,
|
||||
"minItems": 1,
|
||||
"example": "[{\"id\": \"1\", \"category\": [\"Design\", \"Research\"], \"title\": \"UX review presentations\", \"excerpt\": \"How to create compelling presentations\", \"imageSrc\": \"/blog-1.jpg\", \"authorName\": \"Olivia Rhye\", \"authorAvatar\": \"/avatar.jpg\", \"date\": \"20 Jan 2025\"}]",
|
||||
"note": "Array of blog items. Each item requires id, category (string or string[]), title, excerpt, imageSrc, authorName, and date. authorAvatar is optional."
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"blogs": "Array<{ id: string, category: string | string[], title: string, excerpt: string, imageSrc: string, imageAlt?: string, authorName: string, authorAvatar: string, date: string, onBlogClick?: () => void }> - Blog card items",
|
||||
"carouselMode?": "'auto' | 'buttons' (default: 'buttons')",
|
||||
"uniformGridCustomHeightClasses?": "string",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal' (required - controls GSAP scroll animations with stagger effect)",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"useInvertedBackground": "boolean",
|
||||
"ariaLabel?": "string (default: 'Blog section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"imageWrapperClassName?": "string",
|
||||
"imageClassName?": "string",
|
||||
"authorAvatarClassName?": "string",
|
||||
"authorDateClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"excerptClassName?": "string",
|
||||
"categoryClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxTitleImageWrapperClassName?": "string - For styling image wrapper in inline-image layout",
|
||||
"textBoxTitleImageClassName?": "string - For styling images in inline-image layout",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"gridClassName?": "string",
|
||||
"carouselClassName?": "string",
|
||||
"controlsClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<BlogCardTwo blogs={[{id: '1', category: ['Design', 'Research'], title: 'UX review presentations', excerpt: 'How to create compelling presentations that wow your audience', imageSrc: '/blog-1.jpg', authorName: 'Olivia Rhye', authorAvatar: '/avatar.jpg', date: '20 Jan 2025', onBlogClick: () => console.log('clicked')}]} title=\"Latest Articles\" description=\"Stay updated with our latest insights\" textboxLayout=\"default\" useInvertedBackground={false} animationType=\"slide-up\" carouselMode=\"buttons\" />",
|
||||
"do": [
|
||||
"Use for blog listings",
|
||||
"Use for article grids",
|
||||
"Requires blogs[]",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
20
registry/components/BlurBottomBackground.json
Normal file
20
registry/components/BlurBottomBackground.json
Normal file
@@ -0,0 +1,20 @@
|
||||
{
|
||||
"name": "BlurBottomBackground",
|
||||
"description": "Backdrop blur effect positioned at the bottom of the page with linear gradient mask.",
|
||||
"details": "Use for clean, minimal backgrounds with a subtle blur effect at the bottom of the page. Features fixed positioning with backdrop-blur-sm effect at the bottom using linear gradient mask (to bottom, transparent to black 60%). The blur is h-50 in height, fixed at bottom-left (left-0 bottom-0). Creates a frosted glass effect rising from the bottom of the page. Useful for creating depth and visual interest on pages with bottom-aligned content or CTAs without adding background color.",
|
||||
"constraints": {},
|
||||
"propsSchema": {
|
||||
"className?": "string"
|
||||
},
|
||||
"usageExample": "<BlurBottomBackground />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
36
registry/components/ButtonBounceEffect.json
Normal file
36
registry/components/ButtonBounceEffect.json
Normal file
@@ -0,0 +1,36 @@
|
||||
{
|
||||
"name": "ButtonBounceEffect",
|
||||
"description": "CTA button with bouncing character animation on hover.",
|
||||
"details": "Use for primary or secondary CTAs where playful motion adds personality. On hover, each character bounces with a slight delay creating a wave effect. Includes background styling with bgClassName.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"text": {
|
||||
"required": true,
|
||||
"example": "Get Started",
|
||||
"minChars": 2,
|
||||
"maxChars": 25
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"text": "string",
|
||||
"onClick?": "() => void",
|
||||
"href?": "string - External URLs open in new tab, internal values scroll to section",
|
||||
"className?": "string",
|
||||
"bgClassName?": "string",
|
||||
"textClassName?": "string",
|
||||
"disabled?": "boolean (default: false)",
|
||||
"ariaLabel?": "string",
|
||||
"type?": "'button' | 'submit' | 'reset' (default: 'button')"
|
||||
},
|
||||
"usageExample": "<ButtonBounceEffect text=\"Get Started\" href=\"contact\" />",
|
||||
"do": [
|
||||
"Use for general use"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
37
registry/components/ButtonDirectionalHover.json
Normal file
37
registry/components/ButtonDirectionalHover.json
Normal file
@@ -0,0 +1,37 @@
|
||||
{
|
||||
"name": "ButtonDirectionalHover",
|
||||
"description": "CTA button with a circle that expands from the mouse entry point on hover.",
|
||||
"details": "Use for CTAs where directional awareness adds visual interest. On hover, a circle expands from where the cursor entered the button, creating a fluid reveal effect. The circleClassName controls the expanding circle color (bg-accent for primary, bg-accent/10 for secondary).",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"text": {
|
||||
"required": true,
|
||||
"example": "Get Started",
|
||||
"minChars": 2,
|
||||
"maxChars": 25
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"text": "string",
|
||||
"onClick?": "() => void",
|
||||
"href?": "string - External URLs open in new tab, internal values scroll to section",
|
||||
"className?": "string",
|
||||
"bgClassName?": "string",
|
||||
"textClassName?": "string",
|
||||
"circleClassName?": "string - Controls the expanding circle color",
|
||||
"disabled?": "boolean (default: false)",
|
||||
"ariaLabel?": "string",
|
||||
"type?": "'button' | 'submit' | 'reset' (default: 'button')"
|
||||
},
|
||||
"usageExample": "<ButtonDirectionalHover text=\"Get Started\" href=\"contact\" />",
|
||||
"do": [
|
||||
"Use for general use"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
35
registry/components/ButtonElasticEffect.json
Normal file
35
registry/components/ButtonElasticEffect.json
Normal file
@@ -0,0 +1,35 @@
|
||||
{
|
||||
"name": "ButtonElasticEffect",
|
||||
"description": "CTA button with elastic scale animation on hover.",
|
||||
"details": "Use for CTAs where a springy, elastic feel adds playfulness. On hover, the button scales with an elastic easing that overshoots and settles, creating a bouncy tactile response.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"text": {
|
||||
"required": true,
|
||||
"example": "Get Started",
|
||||
"minChars": 2,
|
||||
"maxChars": 25
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"text": "string",
|
||||
"onClick?": "() => void",
|
||||
"href?": "string - External URLs open in new tab, internal values scroll to section",
|
||||
"className?": "string",
|
||||
"textClassName?": "string",
|
||||
"disabled?": "boolean (default: false)",
|
||||
"ariaLabel?": "string",
|
||||
"type?": "'button' | 'submit' | 'reset' (default: 'button')"
|
||||
},
|
||||
"usageExample": "<ButtonElasticEffect text=\"Get Started\" href=\"contact\" />",
|
||||
"do": [
|
||||
"Use for general use"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
37
registry/components/ButtonExpandHover.json
Normal file
37
registry/components/ButtonExpandHover.json
Normal file
@@ -0,0 +1,37 @@
|
||||
{
|
||||
"name": "ButtonExpandHover",
|
||||
"description": "CTA button with expanding background animation from right to left on hover, with a fixed arrow icon.",
|
||||
"details": "Use for CTAs where a smooth expanding effect adds visual interest. On hover (desktop only), the background expands from right to left across the button while the text transitions color. The arrow icon remains fixed on the right side throughout the animation. Mobile shows static button. Uses className for base button styling (primary-button or secondary-button), with iconClassName for arrow icon color and iconBgClassName for expanding background (automatically set via buttonUtils.ts).",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"text": {
|
||||
"required": true,
|
||||
"example": "Get Started",
|
||||
"minChars": 2,
|
||||
"maxChars": 25
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"text": "string",
|
||||
"onClick?": "() => void",
|
||||
"href?": "string - External URLs open in new tab, internal values scroll to section",
|
||||
"className?": "string",
|
||||
"textClassName?": "string - Applied to the text span (automatically includes base and hover colors in sections)",
|
||||
"iconClassName?": "string - Applied to the arrow icon container (automatically set in sections)",
|
||||
"iconBgClassName?": "string - Applied to the expanding background (automatically set in sections)",
|
||||
"disabled?": "boolean (default: false)",
|
||||
"ariaLabel?": "string",
|
||||
"type?": "'button' | 'submit' | 'reset' (default: 'button')"
|
||||
},
|
||||
"usageExample": "<ButtonExpandHover text=\"Get Started\" href=\"contact\" />",
|
||||
"do": [
|
||||
"Use for general use"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
37
registry/components/ButtonHoverBubble.json
Normal file
37
registry/components/ButtonHoverBubble.json
Normal file
@@ -0,0 +1,37 @@
|
||||
{
|
||||
"name": "ButtonHoverBubble",
|
||||
"description": "CTA button with expanding bubble animation where an arrow icon slides out and the text expands on hover.",
|
||||
"details": "Use for CTAs where a playful expansion effect adds emphasis. On hover (desktop only), a circular arrow icon expands from the left while the text container slides into view. The initial state shows just the arrow on the right which transforms into the full button. Mobile shows static full button. Uses bgClassName for text container (primary-button for primary, secondary-button for secondary) and iconClassName for arrow icons (automatically set via buttonUtils.ts).",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"text": {
|
||||
"required": true,
|
||||
"example": "Contact Us",
|
||||
"minChars": 2,
|
||||
"maxChars": 25
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"text": "string",
|
||||
"onClick?": "() => void",
|
||||
"href?": "string - External URLs open in new tab, internal values scroll to section",
|
||||
"className?": "string",
|
||||
"bgClassName?": "string - Applied to the text container (automatically set in sections)",
|
||||
"textClassName?": "string - Applied to the text span",
|
||||
"iconClassName?": "string - Applied to both arrow icon containers (automatically set in sections)",
|
||||
"disabled?": "boolean (default: false)",
|
||||
"ariaLabel?": "string",
|
||||
"type?": "'button' | 'submit' | 'reset' (default: 'button')"
|
||||
},
|
||||
"usageExample": "<ButtonHoverBubble text=\"Contact Us\" href=\"contact\" />",
|
||||
"do": [
|
||||
"Use for general use"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
36
registry/components/ButtonHoverMagnetic.json
Normal file
36
registry/components/ButtonHoverMagnetic.json
Normal file
@@ -0,0 +1,36 @@
|
||||
{
|
||||
"name": "ButtonHoverMagnetic",
|
||||
"description": "CTA button that subtly follows the cursor with a magnetic hover effect.",
|
||||
"details": "Use when you want a playful, high-affordance interaction. On hover, the button shifts toward the cursor and recenters on leave. Keep labels short; no multiline.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"text": {
|
||||
"required": true,
|
||||
"example": "Button",
|
||||
"minChars": 2,
|
||||
"maxChars": 25
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"text": "string",
|
||||
"onClick?": "() => void",
|
||||
"href?": "string - External URLs open in new tab, internal values scroll to section",
|
||||
"className?": "string",
|
||||
"textClassName?": "string",
|
||||
"strengthFactor?": "number (default: 20)",
|
||||
"disabled?": "boolean (default: false)",
|
||||
"ariaLabel?": "string",
|
||||
"type?": "'button' | 'submit' | 'reset' (default: 'button')"
|
||||
},
|
||||
"usageExample": "<ButtonHoverMagnetic text=\"Button\" href=\"contact\" />",
|
||||
"do": [
|
||||
"Use for general use"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
36
registry/components/ButtonIconArrow.json
Normal file
36
registry/components/ButtonIconArrow.json
Normal file
@@ -0,0 +1,36 @@
|
||||
{
|
||||
"name": "ButtonIconArrow",
|
||||
"description": "Button with a trailing arrow icon that transforms on hover.",
|
||||
"details": "Use for CTAs where a subtle icon transformation helps indicate forward navigation. The arrow icon transitions into a square on hover/focus. Keep label short and simple.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"text": {
|
||||
"required": true,
|
||||
"example": "Button",
|
||||
"minChars": 2,
|
||||
"maxChars": 25
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"text": "string",
|
||||
"onClick?": "() => void",
|
||||
"href?": "string - External URLs open in new tab, internal values scroll to section",
|
||||
"className?": "string",
|
||||
"textClassName?": "string",
|
||||
"iconClassName?": "string",
|
||||
"disabled?": "boolean (default: false)",
|
||||
"ariaLabel?": "string",
|
||||
"type?": "'button' | 'submit' | 'reset' (default: 'button')"
|
||||
},
|
||||
"usageExample": "<ButtonIconArrow text=\"Continue\" href=\"next-section\" />",
|
||||
"do": [
|
||||
"Use for general use"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
38
registry/components/ButtonShiftHover.json
Normal file
38
registry/components/ButtonShiftHover.json
Normal file
@@ -0,0 +1,38 @@
|
||||
{
|
||||
"name": "ButtonShiftHover",
|
||||
"description": "CTA button where the label nudges upward on hover and a trailing dot fills from outline to solid.",
|
||||
"details": "Use for primary or secondary CTAs that benefit from a gentle motion cue. Keep the label short and single‑line. The trailing dot is purely decorative and fills on hover.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"text": {
|
||||
"required": true,
|
||||
"example": "Get Started",
|
||||
"minChars": 2,
|
||||
"maxChars": 25
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"text": "string",
|
||||
"onClick?": "() => void",
|
||||
"href?": "string - External URLs open in new tab, internal values scroll to section",
|
||||
"className?": "string",
|
||||
"bgClassName?": "string",
|
||||
"textClassName?": "string",
|
||||
"disabled?": "boolean (default: false)",
|
||||
"ariaLabel?": "string",
|
||||
"type?": "'button' | 'submit' | 'reset' (default: 'button')"
|
||||
},
|
||||
"usageExample": "<ButtonShiftHover text=\"Get Started\" href=\"pricing\" />",
|
||||
"do": [
|
||||
"Use for general use"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use multiple items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
36
registry/components/ButtonTextShift.json
Normal file
36
registry/components/ButtonTextShift.json
Normal file
@@ -0,0 +1,36 @@
|
||||
{
|
||||
"name": "ButtonTextShift",
|
||||
"description": "CTA button with synchronized character shift animation on hover.",
|
||||
"details": "Use for primary or secondary CTAs where uniform text motion adds emphasis. Similar to ButtonTextStagger but all characters shift together simultaneously instead of in sequence. Includes background styling with bgClassName.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"text": {
|
||||
"required": true,
|
||||
"example": "Get Started",
|
||||
"minChars": 2,
|
||||
"maxChars": 25
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"text": "string",
|
||||
"onClick?": "() => void",
|
||||
"href?": "string - External URLs open in new tab, internal values scroll to section",
|
||||
"className?": "string",
|
||||
"bgClassName?": "string",
|
||||
"textClassName?": "string",
|
||||
"disabled?": "boolean (default: false)",
|
||||
"ariaLabel?": "string",
|
||||
"type?": "'button' | 'submit' | 'reset' (default: 'button')"
|
||||
},
|
||||
"usageExample": "<ButtonTextShift text=\"Get Started\" href=\"contact\" />",
|
||||
"do": [
|
||||
"Use for general use"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
37
registry/components/ButtonTextStagger.json
Normal file
37
registry/components/ButtonTextStagger.json
Normal file
@@ -0,0 +1,37 @@
|
||||
{
|
||||
"name": "ButtonTextStagger",
|
||||
"description": "CTA button with character stagger animation on hover.",
|
||||
"details": "Use for primary or secondary CTAs where subtle text motion adds emphasis. On hover, the label's characters animate in sequence (stagger). Includes background styling.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"text": {
|
||||
"required": true,
|
||||
"example": "Get Started",
|
||||
"minChars": 2,
|
||||
"maxChars": 25
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"text": "string",
|
||||
"onClick?": "() => void",
|
||||
"href?": "string - External URLs open in new tab, internal values scroll to section",
|
||||
"className?": "string",
|
||||
"bgClassName?": "string",
|
||||
"textClassName?": "string",
|
||||
"disabled?": "boolean (default: false)",
|
||||
"ariaLabel?": "string",
|
||||
"type?": "'button' | 'submit' | 'reset' (default: 'button')",
|
||||
"scrollToSection?": "boolean"
|
||||
},
|
||||
"usageExample": "<ButtonTextStagger text=\"Get Started\" href=\"https://example.com\" />",
|
||||
"do": [
|
||||
"Use for general use"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
34
registry/components/ButtonTextUnderline.json
Normal file
34
registry/components/ButtonTextUnderline.json
Normal file
@@ -0,0 +1,34 @@
|
||||
{
|
||||
"name": "ButtonTextUnderline",
|
||||
"description": "Text-only button where an underline animates in on hover.",
|
||||
"details": "Use for inline or minimal CTAs or links where you want the hover state to reveal affordance without altering color or layout. The underline appears smoothly under the label when hovered.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"text": {
|
||||
"required": true,
|
||||
"example": "Learn more",
|
||||
"minChars": 2,
|
||||
"maxChars": 25
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"text": "string",
|
||||
"onClick?": "() => void",
|
||||
"href?": "string - External URLs open in new tab, internal values scroll to section",
|
||||
"className?": "string",
|
||||
"disabled?": "boolean (default: false)",
|
||||
"ariaLabel?": "string",
|
||||
"type?": "'button' | 'submit' | 'reset' (default: 'button')"
|
||||
},
|
||||
"usageExample": "<ButtonTextUnderline text=\"Learn more\" href=\"about\" />",
|
||||
"do": [
|
||||
"Use for general use"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
77
registry/components/CardStack.json
Normal file
77
registry/components/CardStack.json
Normal file
@@ -0,0 +1,77 @@
|
||||
{
|
||||
"name": "CardStack",
|
||||
"description": "Adaptive layout component that displays children in a grid or carousel based on item count.",
|
||||
"details": "Use for displaying collections of cards. Automatically switches between grid (1-4 items) and carousel (5+ items). Carousel offers auto-scroll or button controls (recommended: keep default buttons). Optional header supports centered or split textbox layout (split: tag + title + description left, buttons right; split-actions: tag + title left, buttons only right; split-description: tag + title left, description only right).",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Discover our products",
|
||||
"minChars": 5,
|
||||
"maxChars": 300
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "New",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"children": "React.ReactNode",
|
||||
"mode?": "'auto' | 'buttons' (default: 'buttons')",
|
||||
"gridVariant?": "'uniform-all-items-equal' | 'bento-grid' | 'bento-grid-inverted' | 'two-columns-alternating-heights' | 'asymmetric-60-wide-40-narrow' | 'three-columns-all-equal-width' | 'four-items-2x2-equal-grid' | 'one-large-right-three-stacked-left' | 'items-top-row-full-width-bottom' | 'full-width-top-items-bottom-row' | 'one-large-left-three-stacked-right' | 'two-items-per-row' (default: 'uniform-all-items-equal')",
|
||||
"uniformGridCustomHeightClasses?": "string",
|
||||
"gridRowsClassName?": "string",
|
||||
"itemHeightClassesOverride?": "Array<string>",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal' | 'depth-3d' (required - controls GSAP scroll animations with stagger effect)",
|
||||
"supports3DAnimation?": "boolean (default: false)",
|
||||
"carouselThreshold?": "number (default: 5)",
|
||||
"bottomContent?": "React.ReactNode",
|
||||
"title?": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description?": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"useInvertedBackground?": "boolean",
|
||||
"ariaLabel?": "string (default: 'Card stack')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"gridClassName?": "string",
|
||||
"carouselClassName?": "string",
|
||||
"carouselItemClassName?": "string",
|
||||
"controlsClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"titleImageWrapperClassName?": "string - For styling image wrapper in inline-image layout",
|
||||
"titleImageClassName?": "string - For styling images in inline-image layout",
|
||||
"descriptionClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<CardStack title=\"Features\" buttons={[{ text: 'View All', href: 'features' }]} animationType=\"slide-up\" textboxLayout=\"default\">{/* Card components */}</CardStack>",
|
||||
"do": [
|
||||
"Use for general use",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
21
registry/components/CircleGradientBackground.json
Normal file
21
registry/components/CircleGradientBackground.json
Normal file
@@ -0,0 +1,21 @@
|
||||
{
|
||||
"name": "CircleGradientBackground",
|
||||
"description": "Two large gradient circles positioned diagonally in corners.",
|
||||
"details": "Use for soft, modern backgrounds with subtle color accents. Features two blurred gradient circles in diagonal corners (primary: top-right + bottom-left, secondary: top-left + bottom-right). Circles are responsive (w-100 mobile, md:w-70 desktop) with 10% opacity. Uses background-accent color.",
|
||||
"constraints": {},
|
||||
"propsSchema": {
|
||||
"diagonal?": "'primary' | 'secondary' (default: 'primary')",
|
||||
"className?": "string"
|
||||
},
|
||||
"usageExample": "<CircleGradientBackground diagonal=\"primary\" />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
70
registry/components/ContactCTA.json
Normal file
70
registry/components/ContactCTA.json
Normal file
@@ -0,0 +1,70 @@
|
||||
{
|
||||
"name": "ContactCTA",
|
||||
"description": "Centered contact CTA section with tag, title, description, and action buttons in a card container with background support.",
|
||||
"details": "Use for call-to-action contact sections with full textbox support. Features a centered card layout with tag (optional icon), title, description, and buttons. Supports multiple background variants through HeroBackgrounds. Best for conversion-focused contact sections at the end of pages.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"tag": {
|
||||
"required": true,
|
||||
"example": "Get in Touch",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
},
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Ready to Build Your Next Project?",
|
||||
"minChars": 5,
|
||||
"maxChars": 100
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Let's work together to create something amazing. Our team is ready to help you bring your vision to life.",
|
||||
"minChars": 10,
|
||||
"maxChars": 300
|
||||
}
|
||||
},
|
||||
"buttonRules": {
|
||||
"maxButtons": 2,
|
||||
"required": true,
|
||||
"note": "At least one button is required. Supports up to 2 buttons with gap-4 spacing."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"tag": "string (required)",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"title": "string (required)",
|
||||
"description": "string (required)",
|
||||
"buttons": "Array<{text: string, onClick?: () => void, href?: string}> (required)",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"background": "ContactCTABackgroundProps = { variant: 'plain' | 'animated-grid' | 'canvas-reveal' | 'cell-wave' | 'downward-rays-animated' | 'downward-rays-animated-grid' | 'downward-rays-static' | 'downward-rays-static-grid' | 'gradient-bars' | 'radial-gradient' | 'rotated-rays-animated' | 'rotated-rays-animated-grid' | 'rotated-rays-static' | 'rotated-rays-static-grid' | 'sparkles-gradient' }",
|
||||
"useInvertedBackground": "boolean",
|
||||
"ariaLabel?": "string (default: 'Contact section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"contentClassName?": "string - Card content wrapper styling",
|
||||
"textBoxClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<ContactCTA tag=\"Get in Touch\" tagIcon={Mail} title=\"Ready to Build Your Next Project?\" description=\"Let's work together to create something amazing.\" buttons={[{ text: 'Contact Us', href: '/contact' }, { text: 'View Portfolio', href: '/portfolio' }]} background={{ variant: 'plain' }} useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for call-to-action contact sections",
|
||||
"Place at the end of pages for conversion",
|
||||
"Use with appropriate background variant",
|
||||
"Requires at least one button"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use without buttons",
|
||||
"Do not use for general content sections"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
87
registry/components/ContactCenter.json
Normal file
87
registry/components/ContactCenter.json
Normal file
@@ -0,0 +1,87 @@
|
||||
{
|
||||
"name": "ContactCenter",
|
||||
"description": "Centered contact section with tag, animated title and description, email signup form, and terms text.",
|
||||
"details": "Use for newsletter signups, contact forms, or email capture. Features centered layout with tag (with optional icon), animated title and description using ThemeProvider's defaultTextAnimation, EmailSignupForm component, and customizable terms text. Content is placed in a card container with rounded-theme-capped styling. Ideal for prominently placed contact/signup sections with strong visual emphasis.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"tag": {
|
||||
"required": true,
|
||||
"example": "Newsletter",
|
||||
"minChars": 2,
|
||||
"maxChars": 20
|
||||
},
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Medium length heading goes here",
|
||||
"minChars": 4,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique.",
|
||||
"minChars": 20,
|
||||
"maxChars": 200
|
||||
},
|
||||
"inputPlaceholder": {
|
||||
"required": false,
|
||||
"default": "Enter your email",
|
||||
"example": "Your email address",
|
||||
"minChars": 5,
|
||||
"maxChars": 30
|
||||
},
|
||||
"buttonText": {
|
||||
"required": false,
|
||||
"default": "Sign Up",
|
||||
"example": "Subscribe",
|
||||
"minChars": 2,
|
||||
"maxChars": 15
|
||||
},
|
||||
"termsText": {
|
||||
"required": false,
|
||||
"default": "By clicking Sign Up you're confirming that you agree with our Terms and Conditions.",
|
||||
"example": "We respect your privacy. Unsubscribe at any time.",
|
||||
"minChars": 10,
|
||||
"maxChars": 150
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"tag": "string",
|
||||
"title": "string",
|
||||
"description": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"background": "{ variant: 'plain' | 'animated-grid' | 'canvas-reveal' | 'cell-wave' | 'downward-rays-animated' | 'downward-rays-animated-grid' | 'downward-rays-static' | 'downward-rays-static-grid' | 'gradient-bars' | 'radial-gradient' | 'rotated-rays-animated' | 'rotated-rays-animated-grid' | 'rotated-rays-static' | 'rotated-rays-static-grid' | 'sparkles-gradient' }",
|
||||
"useInvertedBackground": "boolean",
|
||||
"inputPlaceholder?": "string (default: 'Enter your email')",
|
||||
"buttonText?": "string (default: 'Sign Up')",
|
||||
"termsText?": "string (default: 'By clicking Sign Up you're confirming that you agree with our Terms and Conditions.')",
|
||||
"onSubmit?": "(email: string) => void",
|
||||
"ariaLabel?": "string (default: 'Contact section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"contentClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"formWrapperClassName?": "string",
|
||||
"formClassName?": "string",
|
||||
"inputClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"termsClassName?": "string"
|
||||
},
|
||||
"usageExample": "<ContactCenter tag=\"Newsletter\" title=\"Stay updated with our latest news\" description=\"Subscribe to our newsletter for weekly updates and exclusive content.\" background={{ variant: 'rotated-rays-animated-grid' }} useInvertedBackground={false} onSubmit={(email) => console.log(email)} />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Use for contact pages",
|
||||
"Use for lead generation"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
83
registry/components/ContactForm.json
Normal file
83
registry/components/ContactForm.json
Normal file
@@ -0,0 +1,83 @@
|
||||
{
|
||||
"name": "ContactForm",
|
||||
"description": "Complete contact form component with tag, animated title and description, email signup form, and terms text.",
|
||||
"details": "Use for email signup sections with full context and branding. Features Tag component, TextAnimation for title and description using ThemeProvider defaults, EmailSignupForm for input, and terms/conditions text below. Supports centered layout for hero-style presentation. Returns email string on submit.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Join our newsletter",
|
||||
"minChars": 4,
|
||||
"maxChars": 60
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Get the latest updates and exclusive content delivered to your inbox",
|
||||
"minChars": 10,
|
||||
"maxChars": 200
|
||||
},
|
||||
"tag": {
|
||||
"required": true,
|
||||
"example": "Newsletter",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
},
|
||||
"inputPlaceholder": {
|
||||
"required": false,
|
||||
"default": "Enter your email",
|
||||
"example": "Your email address",
|
||||
"minChars": 5,
|
||||
"maxChars": 50
|
||||
},
|
||||
"buttonText": {
|
||||
"required": false,
|
||||
"default": "Sign Up",
|
||||
"example": "Subscribe",
|
||||
"minChars": 2,
|
||||
"maxChars": 15
|
||||
},
|
||||
"termsText": {
|
||||
"required": false,
|
||||
"default": "By clicking Sign Up you're confirming that you agree with our Terms and Conditions.",
|
||||
"example": "We respect your privacy. Unsubscribe anytime.",
|
||||
"minChars": 10,
|
||||
"maxChars": 200
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string (required)",
|
||||
"description": "string (required)",
|
||||
"tag": "string (required)",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"inputPlaceholder?": "string (default: 'Enter your email')",
|
||||
"buttonText?": "string (default: 'Sign Up')",
|
||||
"termsText?": "string (default: 'By clicking Sign Up you're confirming that you agree with our Terms and Conditions.')",
|
||||
"onSubmit?": "(email: string) => void",
|
||||
"centered?": "boolean (default: false)",
|
||||
"className?": "string",
|
||||
"tagClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"formWrapperClassName?": "string",
|
||||
"formClassName?": "string",
|
||||
"inputClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"termsClassName?": "string"
|
||||
},
|
||||
"usageExample": "<ContactForm title=\"Join our newsletter\" description=\"Get updates\" tag=\"Newsletter\" onSubmit={(email) => console.log(email)} />",
|
||||
"do": [
|
||||
"Use for landing pages",
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Use for contact pages",
|
||||
"Use for lead generation"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
96
registry/components/ContactSplit.json
Normal file
96
registry/components/ContactSplit.json
Normal file
@@ -0,0 +1,96 @@
|
||||
{
|
||||
"name": "ContactSplit",
|
||||
"description": "Split layout contact section with tag, animated title and description on one side, media content on the other, and email signup form.",
|
||||
"details": "Use for newsletter signups or email capture with visual context. Features split layout with ContactForm (tag with optional icon, animated title and description, EmailSignupForm) on one side and image or video media on the other. Form is placed in a card with constrained width on larger screens. Media can be positioned left or right. Media uses fixed height on desktop. Ideal for contact sections that benefit from visual storytelling alongside the signup form.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"tag": {
|
||||
"required": true,
|
||||
"example": "Newsletter",
|
||||
"minChars": 2,
|
||||
"maxChars": 20
|
||||
},
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Medium length heading goes here",
|
||||
"minChars": 4,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique.",
|
||||
"minChars": 20,
|
||||
"maxChars": 200
|
||||
},
|
||||
"inputPlaceholder": {
|
||||
"required": false,
|
||||
"default": "Enter your email",
|
||||
"example": "Your email address",
|
||||
"minChars": 5,
|
||||
"maxChars": 30
|
||||
},
|
||||
"buttonText": {
|
||||
"required": false,
|
||||
"default": "Sign Up",
|
||||
"example": "Subscribe",
|
||||
"minChars": 2,
|
||||
"maxChars": 15
|
||||
},
|
||||
"termsText": {
|
||||
"required": false,
|
||||
"default": "By clicking Sign Up you're confirming that you agree with our Terms and Conditions.",
|
||||
"example": "We respect your privacy. Unsubscribe at any time.",
|
||||
"minChars": 10,
|
||||
"maxChars": 150
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"tag": "string",
|
||||
"title": "string",
|
||||
"description": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"background": "{ variant: 'plain' | 'animated-grid' | 'canvas-reveal' | 'cell-wave' | 'downward-rays-animated' | 'downward-rays-animated-grid' | 'downward-rays-static' | 'downward-rays-static-grid' | 'gradient-bars' | 'radial-gradient' | 'rotated-rays-animated' | 'rotated-rays-animated-grid' | 'rotated-rays-static' | 'rotated-rays-static-grid' | 'sparkles-gradient' }",
|
||||
"useInvertedBackground": "boolean",
|
||||
"imageSrc?": "string",
|
||||
"videoSrc?": "string",
|
||||
"imageAlt?": "string (default: '')",
|
||||
"videoAriaLabel?": "string (default: 'Contact section video')",
|
||||
"mediaAnimation": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"mediaPosition?": "'left' | 'right' (default: 'right')",
|
||||
"inputPlaceholder?": "string (default: 'Enter your email')",
|
||||
"buttonText?": "string (default: 'Sign Up')",
|
||||
"termsText?": "string (default: 'By clicking Sign Up you're confirming that you agree with our Terms and Conditions.')",
|
||||
"onSubmit?": "(email: string) => void",
|
||||
"ariaLabel?": "string (default: 'Contact section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"contentClassName?": "string",
|
||||
"contactFormClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"formWrapperClassName?": "string",
|
||||
"formClassName?": "string",
|
||||
"inputClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"termsClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"mediaClassName?": "string"
|
||||
},
|
||||
"usageExample": "<ContactSplit tag=\"Newsletter\" title=\"Stay updated\" description=\"Subscribe to our newsletter for weekly updates and exclusive content.\" background={{ variant: 'sparkles-gradient' }} useInvertedBackground={false} imageSrc=\"/contact.jpg\" onSubmit={(email) => console.log(email)} />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Use for contact pages",
|
||||
"Use for lead generation"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
69
registry/components/ContactSplitForm.json
Normal file
69
registry/components/ContactSplitForm.json
Normal file
@@ -0,0 +1,69 @@
|
||||
{
|
||||
"name": "ContactSplitForm",
|
||||
"description": "Split layout contact form with animated title and description, dynamic input fields, optional textarea, submit button, and media content.",
|
||||
"details": "Use for full contact forms with visual context. Features split layout with form (animated title and description, dynamic input fields array with minimum 2 required, optional textarea, submit button) on one side and image or video media on the other. All form inputs use secondary-button styling with rounded-theme borders. Media can be positioned left or right. On mobile, media displays with natural aspect ratio; on desktop, uses absolute positioning to match form height. Returns Record<string, string> with all field values on submit. Ideal for contact pages that combine detailed forms with visual storytelling.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Medium length heading goes here",
|
||||
"minChars": 4,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique.",
|
||||
"minChars": 20,
|
||||
"maxChars": 200
|
||||
},
|
||||
"buttonText": {
|
||||
"required": false,
|
||||
"default": "Submit",
|
||||
"example": "Send Message",
|
||||
"minChars": 2,
|
||||
"maxChars": 15
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string",
|
||||
"description": "string",
|
||||
"inputs": "Array<{ name: string, type: string, placeholder: string, required?: boolean, className?: string }> - Form input fields (min 2 required)",
|
||||
"multiSelect?": "{ name: string, label: string, options: string[] } - Optional multi-select dropdown field",
|
||||
"textarea?": "{ name: string, placeholder: string, rows?: number, required?: boolean, className?: string } - Optional textarea field",
|
||||
"useInvertedBackground": "boolean",
|
||||
"imageSrc?": "string",
|
||||
"videoSrc?": "string",
|
||||
"imageAlt?": "string (default: '')",
|
||||
"videoAriaLabel?": "string (default: 'Contact section video')",
|
||||
"mediaAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal' (default: 'none')",
|
||||
"mediaPosition?": "'left' | 'right' (default: 'right')",
|
||||
"buttonText?": "string (default: 'Submit')",
|
||||
"onSubmit?": "(data: Record<string, string>) => void",
|
||||
"ariaLabel?": "string (default: 'Contact section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"contentClassName?": "string",
|
||||
"formCardClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"mediaClassName?": "string"
|
||||
},
|
||||
"usageExample": "// Wrap in ThemeProvider\n<ThemeProvider defaultButtonVariant=\"text-stagger\" defaultTextAnimation=\"entrance-slide\" borderRadius=\"rounded\" background=\"aurora\" cardStyle=\"glass-elevated\" primaryButtonStyle=\"gradient\" secondaryButtonStyle=\"glass\">\n <ContactSplitForm title=\"Get in touch\" description=\"We'd love to hear from you. Send us a message.\" inputs={[{ name: 'name', type: 'text', placeholder: 'Name', required: true }, { name: 'email', type: 'email', placeholder: 'Email', required: true }]} textarea={{ name: 'message', placeholder: 'Type your message...', rows: 5, required: true }} useInvertedBackground={false} imageSrc=\"/placeholders/placeholder-16-9.svg\" onSubmit={(data) => console.log(data)} />\n</ThemeProvider>",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Use for contact pages",
|
||||
"Use for lead generation",
|
||||
"Requires inputs[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
56
registry/components/ContactText.json
Normal file
56
registry/components/ContactText.json
Normal file
@@ -0,0 +1,56 @@
|
||||
{
|
||||
"name": "ContactText",
|
||||
"description": "Centered contact section with animated text and action buttons in a card container.",
|
||||
"details": "Use for simple, focused contact call-to-actions with emphasis on messaging. Layout: Section wrapper with optional inverted background → Card container (w-content-width, card class, rounded-theme-capped, py-20 px-10) → Centered content area (w-3/4 on md+) with TextAnimation heading and buttons. Text uses GSAP scroll-triggered animation (words-trigger variant) with configurable animation type (entrance-slide, reveal-blur, or background-highlight). Supports up to 2 buttons with px-8 spacing in flex layout. Card background adapts to theme.cardStyle. Text color determined by shouldUseInvertedText utility based on useInvertedBackground and cardStyle. Best for clean contact sections, inquiry prompts, or call-to-action blocks with animated messaging.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"text": {
|
||||
"required": true,
|
||||
"example": "Ready to start your next project? Let's create something amazing together.",
|
||||
"minChars": 10,
|
||||
"maxChars": 125
|
||||
},
|
||||
"animationType": {
|
||||
"required": false,
|
||||
"default": "entrance-slide",
|
||||
"options": [
|
||||
"entrance-slide",
|
||||
"reveal-blur",
|
||||
"background-highlight"
|
||||
],
|
||||
"note": "GSAP scroll-triggered animation type for text"
|
||||
}
|
||||
},
|
||||
"buttonRules": {
|
||||
"maxButtons": 2,
|
||||
"note": "Supports up to 2 buttons with px-8 spacing. Buttons use theme.defaultButtonVariant."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"text": "string",
|
||||
"animationType?": "'entrance-slide' | 'reveal-blur' | 'background-highlight' (default: 'entrance-slide')",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"background": "{ variant: 'plain' | 'animated-grid' | 'canvas-reveal' | 'cell-wave' | 'downward-rays-animated' | 'downward-rays-animated-grid' | 'downward-rays-static' | 'downward-rays-static-grid' | 'gradient-bars' | 'radial-gradient' | 'rotated-rays-animated' | 'rotated-rays-animated-grid' | 'rotated-rays-static' | 'rotated-rays-static-grid' | 'sparkles-gradient' } (required)",
|
||||
"useInvertedBackground": "boolean",
|
||||
"ariaLabel?": "string (default: 'Contact section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string - Outer wrapper styling",
|
||||
"contentClassName?": "string - Card content wrapper styling",
|
||||
"textClassName?": "string - TextAnimation heading styling",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<ContactText text=\"Ready to start your next project? Let's create something amazing together.\" animationType=\"entrance-slide\" buttons={[{ text: 'Get in Touch', href: '/contact' }, { text: 'View Portfolio', href: '/portfolio' }]} background={{ variant: 'plain' }} useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for contact pages",
|
||||
"Use for lead generation",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
24
registry/components/DotGridBackground.json
Normal file
24
registry/components/DotGridBackground.json
Normal file
@@ -0,0 +1,24 @@
|
||||
{
|
||||
"name": "DotGridBackground",
|
||||
"description": "Dot pattern background with radial gradient dots and optional 3D perspective effect.",
|
||||
"details": "Use for subtle, modern backgrounds. Features dense dot grid (small: 100 dots, medium: 50 dots, large: 25 dots per 100vw). Optional perspectiveThreeD adds skew transform and radial mask. Uses background-accent color at 30% opacity. Has radial fade mask at 90%.",
|
||||
"constraints": {},
|
||||
"propsSchema": {
|
||||
"size?": "'small' | 'medium' | 'large' (default: 'medium')",
|
||||
"perspectiveThreeD?": "boolean (default: false)",
|
||||
"className?": "string"
|
||||
},
|
||||
"usageExample": "<DotGridBackground size=\"medium\" perspectiveThreeD={false} />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use more than 4 items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
28
registry/components/DownwardRaysBackground.json
Normal file
28
registry/components/DownwardRaysBackground.json
Normal file
@@ -0,0 +1,28 @@
|
||||
{
|
||||
"name": "DownwardRaysBackground",
|
||||
"description": "Atmospheric light rays emanating from top center directly downward with blur and radial gradient effects, with optional grid overlay.",
|
||||
"details": "Use for dramatic, atmospheric backgrounds with light rays cascading from above. Features 9 symmetrical rays with varying widths (15-40px), opacities, rotations fanning outward, and scales emanating from top center. Container is centered horizontally with 16px blur and masked with radial gradient for natural falloff. Includes 3 light sources for additional depth. Uses theme color via var(--color-primary-cta) for both rays and light sources. When animated=true, rays pulse between opacity 0 and their target opacity with staggered timing. When showGrid=true, displays a medium grid overlay (10vw spacing) that fades from top center. Perfect for hero sections, landing pages, or any area needing dramatic top-down lighting effects.",
|
||||
"constraints": {},
|
||||
"propsSchema": {
|
||||
"animated": "boolean - Required. When true, rays animate with pulsing opacity. When false, rays display static opacity.",
|
||||
"showGrid": "boolean - Required. When true, displays a grid overlay fading from top center. When false, no grid is shown.",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string"
|
||||
},
|
||||
"usageExample": "<DownwardRaysBackground animated={true} showGrid={false} />",
|
||||
"do": [
|
||||
"Use for landing pages",
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Use for statistics displays",
|
||||
"Use for achievement showcases"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use more than 4 items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
43
registry/components/EmailSignupForm.json
Normal file
43
registry/components/EmailSignupForm.json
Normal file
@@ -0,0 +1,43 @@
|
||||
{
|
||||
"name": "EmailSignupForm",
|
||||
"description": "Compact email signup form with inline input and submit button in card container.",
|
||||
"details": "Use for newsletter signups, waitlists, or email collection. Features inline layout with email input on left and submit button on right, all wrapped in a card with rounded-theme borders and 1-unit padding. Input is flex-1 to fill available space. Button uses ThemeProvider's defaultButtonVariant. Returns email string on submit.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"inputPlaceholder": {
|
||||
"required": false,
|
||||
"default": "Enter your email",
|
||||
"example": "Your email address",
|
||||
"minChars": 5,
|
||||
"maxChars": 50
|
||||
},
|
||||
"buttonText": {
|
||||
"required": false,
|
||||
"default": "Sign Up",
|
||||
"example": "Subscribe",
|
||||
"minChars": 2,
|
||||
"maxChars": 15
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"inputPlaceholder?": "string (default: 'Enter your email')",
|
||||
"buttonText?": "string (default: 'Sign Up')",
|
||||
"onSubmit?": "(email: string) => void",
|
||||
"className?": "string",
|
||||
"inputClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<EmailSignupForm inputPlaceholder=\"Your email\" buttonText=\"Subscribe\" onSubmit={(email) => console.log(email)} />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
93
registry/components/FaqBase.json
Normal file
93
registry/components/FaqBase.json
Normal file
@@ -0,0 +1,93 @@
|
||||
{
|
||||
"name": "FaqBase",
|
||||
"description": "FAQ section with accordion items and optional header.",
|
||||
"details": "Use for displaying frequently asked questions in an expandable accordion format. Layout: Optional TextBox Header → Accordion List. Supports two animation types: 'smooth' (height transition) and 'instant' (immediate show/hide). Only one accordion item can be open at a time. Each FAQ requires a unique id, title (question), and content (answer). Content supports HTML for rich formatting. Optional header with title, description, tag, and buttons via CardStackTextBox. Best for FAQ pages, help sections, or any Q&A content.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Frequently Asked Questions",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Find answers to common questions about our products and services",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Help",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"faqRules": {
|
||||
"faqs": {
|
||||
"required": true,
|
||||
"minItems": 1,
|
||||
"example": "[{\"id\": \"1\", \"title\": \"What is your return policy?\", \"content\": \"We offer a 30-day money-back guarantee.\"}]",
|
||||
"note": "Array of FAQ items. Each item requires unique id, title (question), and content (answer with HTML support)."
|
||||
},
|
||||
"animationType": {
|
||||
"required": false,
|
||||
"default": "smooth",
|
||||
"options": [
|
||||
"smooth",
|
||||
"instant"
|
||||
],
|
||||
"note": "Animation type for accordion open/close. 'smooth' uses height transition, 'instant' shows/hides immediately."
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"faqs": "Array<{ id: string, title: string, content: string }> - FAQ items",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"faqsAnimation": "'none' | 'opacity' | 'slide-up' | 'blur-reveal' (required)",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"useInvertedBackground": "boolean",
|
||||
"animationType?": "'smooth' | 'instant' (default: 'smooth')",
|
||||
"showCard?": "boolean (default: true)",
|
||||
"ariaLabel?": "string (default: 'FAQ section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"titleImageWrapperClassName?": "string - For styling image wrapper in inline-image layout",
|
||||
"titleImageClassName?": "string - For styling images in inline-image layout",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string",
|
||||
"faqsContainerClassName?": "string",
|
||||
"accordionClassName?": "string",
|
||||
"accordionTitleClassName?": "string",
|
||||
"accordionIconContainerClassName?": "string",
|
||||
"accordionIconClassName?": "string",
|
||||
"accordionContentClassName?": "string",
|
||||
"separatorClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FaqBase faqs={[{id: '1', title: 'What is your return policy?', content: 'We offer a 30-day money-back guarantee on all our products.'}, {id: '2', title: 'How long does shipping take?', content: 'Standard shipping typically takes 5-7 business days.'}]} title=\"Frequently Asked Questions\" description=\"Find answers to common questions\" textboxLayout=\"default\" useInvertedBackground={false} faqsAnimation=\"slide-up\" />",
|
||||
"do": [
|
||||
"Use for help pages",
|
||||
"Use for support sections",
|
||||
"Requires faqs[]",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
92
registry/components/FaqDouble.json
Normal file
92
registry/components/FaqDouble.json
Normal file
@@ -0,0 +1,92 @@
|
||||
{
|
||||
"name": "FaqDouble",
|
||||
"description": "FAQ section with two-column accordion layout and optional header.",
|
||||
"details": "Use for displaying frequently asked questions in a two-column layout for better space utilization. Layout: Optional TextBox Header → Card Container with Two Columns of Accordions. FAQs are automatically split into two equal columns (first half in left column, second half in right). On mobile, columns stack vertically. Supports two animation types: 'smooth' (height transition) and 'instant' (immediate show/hide). Only one accordion item can be open at a time across both columns. Each FAQ requires a unique id, title (question), and content (answer). Content supports HTML for rich formatting. Card container has rounded-theme styling. Best for FAQ pages with many questions where horizontal space is available.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Frequently Asked Questions",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Find answers to common questions about our products and services",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Help",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"faqRules": {
|
||||
"faqs": {
|
||||
"required": true,
|
||||
"minItems": 1,
|
||||
"example": "[{\"id\": \"1\", \"title\": \"What is your return policy?\", \"content\": \"We offer a 30-day money-back guarantee.\"}]",
|
||||
"note": "Array of FAQ items. Each item requires unique id, title (question), and content (answer with HTML support). Items are automatically split into two columns."
|
||||
},
|
||||
"animationType": {
|
||||
"required": false,
|
||||
"default": "smooth",
|
||||
"options": [
|
||||
"smooth",
|
||||
"instant"
|
||||
],
|
||||
"note": "Animation type for accordion open/close. 'smooth' uses height transition, 'instant' shows/hides immediately."
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"faqs": "Array<{ id: string, title: string, content: string }> - FAQ items",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"faqsAnimation": "'none' | 'opacity' | 'slide-up' | 'blur-reveal' (required)",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"useInvertedBackground": "boolean",
|
||||
"animationType?": "'smooth' | 'instant' (default: 'smooth')",
|
||||
"ariaLabel?": "string (default: 'FAQ section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"titleImageWrapperClassName?": "string - For styling image wrapper in inline-image layout",
|
||||
"titleImageClassName?": "string - For styling images in inline-image layout",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string",
|
||||
"faqsContainerClassName?": "string",
|
||||
"columnClassName?": "string",
|
||||
"accordionClassName?": "string",
|
||||
"accordionTitleClassName?": "string",
|
||||
"accordionIconContainerClassName?": "string",
|
||||
"accordionIconClassName?": "string",
|
||||
"accordionContentClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FaqDouble faqs={[{id: '1', title: 'What is your return policy?', content: 'We offer a 30-day money-back guarantee on all our products.'}, {id: '2', title: 'How long does shipping take?', content: 'Standard shipping typically takes 5-7 business days.'}, {id: '3', title: 'Do you ship internationally?', content: 'Yes, we ship to over 100 countries worldwide.'}]} title=\"Frequently Asked Questions\" description=\"Find answers to common questions\" textboxLayout=\"default\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for help pages",
|
||||
"Use for support sections",
|
||||
"Requires faqs[]",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
123
registry/components/FaqSplitMedia.json
Normal file
123
registry/components/FaqSplitMedia.json
Normal file
@@ -0,0 +1,123 @@
|
||||
{
|
||||
"name": "FaqSplitMedia",
|
||||
"description": "FAQ section with split layout featuring media (image/video) on one side and accordion list on the other.",
|
||||
"details": "Use for displaying FAQs with visual context. Layout: Optional TextBox Header → Grid with Media (2/5 width) + Accordions (3/5 width). Media can be positioned left or right via mediaPosition prop. Uses CSS Grid with auto-rows-fr to ensure media and FAQ content match height exactly. Media container has fixed height on mobile (h-80) and auto height on desktop to match FAQ content. Supports both images and videos. Only one accordion item can be open at a time. Supports two animation types: 'smooth' (height transition) and 'instant' (immediate show/hide). Each FAQ requires unique id, title (question), and content (answer with HTML support). Best for FAQ pages where visual elements enhance understanding.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Frequently Asked Questions",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Find answers to common questions about our products and services",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Help",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"faqRules": {
|
||||
"faqs": {
|
||||
"required": true,
|
||||
"minItems": 1,
|
||||
"example": "[{\"id\": \"1\", \"title\": \"What is your return policy?\", \"content\": \"We offer a 30-day money-back guarantee.\"}]",
|
||||
"note": "Array of FAQ items. Each item requires unique id, title (question), and content (answer with HTML support)."
|
||||
},
|
||||
"animationType": {
|
||||
"required": false,
|
||||
"default": "smooth",
|
||||
"options": [
|
||||
"smooth",
|
||||
"instant"
|
||||
],
|
||||
"note": "Animation type for accordion open/close. 'smooth' uses height transition, 'instant' shows/hides immediately."
|
||||
},
|
||||
"mediaPosition": {
|
||||
"required": false,
|
||||
"default": "left",
|
||||
"options": [
|
||||
"left",
|
||||
"right"
|
||||
],
|
||||
"note": "Position of media relative to FAQ list."
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"imageSrc": {
|
||||
"required": false,
|
||||
"note": "Path to image file. Either imageSrc or videoSrc should be provided. Either imageSrc or videoSrc should be provided. Image is recommended if no videoSrc."
|
||||
},
|
||||
"videoSrc": {
|
||||
"required": false,
|
||||
"note": "Path to video file. Either imageSrc or videoSrc should be provided."
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"faqs": "Array<{ id: string, title: string, content: string }> - FAQ items",
|
||||
"imageSrc?": "string",
|
||||
"videoSrc?": "string",
|
||||
"imageAlt?": "string (default: '')",
|
||||
"videoAriaLabel?": "string (default: 'FAQ section video')",
|
||||
"mediaAnimation": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"mediaPosition?": "'left' | 'right' (default: 'left')",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"faqsAnimation": "'none' | 'opacity' | 'slide-up' | 'blur-reveal' (required)",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"useInvertedBackground": "boolean",
|
||||
"animationType?": "'smooth' | 'instant' (default: 'smooth')",
|
||||
"showCard?": "boolean (default: true)",
|
||||
"ariaLabel?": "string (default: 'FAQ section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"titleImageWrapperClassName?": "string - For styling image wrapper in inline-image layout",
|
||||
"titleImageClassName?": "string - For styling images in inline-image layout",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string",
|
||||
"contentClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"mediaClassName?": "string",
|
||||
"faqsContainerClassName?": "string",
|
||||
"accordionClassName?": "string",
|
||||
"accordionTitleClassName?": "string",
|
||||
"accordionIconContainerClassName?": "string",
|
||||
"accordionIconClassName?": "string",
|
||||
"accordionContentClassName?": "string",
|
||||
"separatorClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FaqSplitMedia faqs={[{id: '1', title: 'What is your return policy?', content: 'We offer a 30-day money-back guarantee on all our products.'}, {id: '2', title: 'How long does shipping take?', content: 'Standard shipping typically takes 5-7 business days.'}]} imageSrc=\"/images/faq-hero.jpg\" imageAlt=\"Customer support representative\" title=\"Frequently Asked Questions\" description=\"Find answers to common questions\" textboxLayout=\"default\" useInvertedBackground={false} mediaPosition=\"left\" />",
|
||||
"do": [
|
||||
"Use for help pages",
|
||||
"Use for support sections",
|
||||
"Requires faqs[]",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use more than 4 items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
89
registry/components/FaqSplitText.json
Normal file
89
registry/components/FaqSplitText.json
Normal file
@@ -0,0 +1,89 @@
|
||||
{
|
||||
"name": "FaqSplitText",
|
||||
"description": "FAQ section with split layout featuring animated text on one side and accordion list on the other.",
|
||||
"details": "Use for displaying FAQs with a prominent title and optional description. Layout: Animated Title + Description (2/5 width) | Accordions (3/5 width). Text can be positioned left or right via textPosition prop. Text animations are controlled by ThemeProvider's defaultTextAnimation. Only one accordion item can be open at a time. Supports two animation types for accordions: 'smooth' (height transition) and 'instant' (immediate show/hide). Each FAQ requires unique id, title (question), and content (answer with HTML support). Best for FAQ pages with emphasis on section branding or when media isn't needed.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"sideTitle": {
|
||||
"required": true,
|
||||
"example": "Frequently Asked Questions",
|
||||
"minChars": 2,
|
||||
"maxChars": 100
|
||||
},
|
||||
"sideDescription": {
|
||||
"required": false,
|
||||
"example": "Everything you need to know",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
}
|
||||
},
|
||||
"faqRules": {
|
||||
"faqs": {
|
||||
"required": true,
|
||||
"minItems": 1,
|
||||
"example": "[{\"id\": \"1\", \"title\": \"What is your return policy?\", \"content\": \"We offer a 30-day money-back guarantee.\"}]",
|
||||
"note": "Array of FAQ items. Each item requires unique id, title (question), and content (answer with HTML support)."
|
||||
},
|
||||
"animationType": {
|
||||
"required": false,
|
||||
"default": "smooth",
|
||||
"options": [
|
||||
"smooth",
|
||||
"instant"
|
||||
],
|
||||
"note": "Animation type for accordion open/close. 'smooth' uses height transition, 'instant' shows/hides immediately."
|
||||
},
|
||||
"textPosition": {
|
||||
"required": false,
|
||||
"default": "left",
|
||||
"options": [
|
||||
"left",
|
||||
"right"
|
||||
],
|
||||
"note": "Position of title/description text relative to FAQ list."
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"faqs": "Array<{ id: string, title: string, content: string }> - FAQ items",
|
||||
"sideTitle": "string",
|
||||
"sideDescription?": "string",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"faqsAnimation": "'none' | 'opacity' | 'slide-up' | 'blur-reveal' (required)",
|
||||
"textPosition?": "'left' | 'right' (default: 'left')",
|
||||
"useInvertedBackground": "boolean",
|
||||
"animationType?": "'smooth' | 'instant' (default: 'smooth')",
|
||||
"showCard?": "boolean (default: true)",
|
||||
"ariaLabel?": "string (default: 'FAQ section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"contentClassName?": "string",
|
||||
"textContainerClassName?": "string",
|
||||
"sideTitleClassName?": "string",
|
||||
"sideDescriptionClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"faqsContainerClassName?": "string",
|
||||
"accordionClassName?": "string",
|
||||
"accordionTitleClassName?": "string",
|
||||
"accordionIconContainerClassName?": "string",
|
||||
"accordionIconClassName?": "string",
|
||||
"accordionContentClassName?": "string",
|
||||
"separatorClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FaqSplitText faqs={[{id: '1', title: 'How can I be part of Buenro?', content: 'You can join by signing up on our platform.'}, {id: '2', title: 'Can anyone join Buenro?', content: 'Yes! We welcome remote workers and entrepreneurs.'}]} sideTitle=\"Frequently Asked Questions\" textPosition=\"left\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for help pages",
|
||||
"Use for support sections",
|
||||
"Requires faqs[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
113
registry/components/FeatureBento.json
Normal file
113
registry/components/FeatureBento.json
Normal file
@@ -0,0 +1,113 @@
|
||||
{
|
||||
"name": "FeatureBento",
|
||||
"description": "Feature section with bento-style cards displaying interactive visualizations (globe, charts, 3D cards, map).",
|
||||
"details": "Use for feature showcases with rich interactive content. Each feature card contains a bento component visualization. Supports 11 bento types: globe (3D rotating globe), icon-info-cards (scrolling metric cards), animated-bar-chart (animated chart), 3d-stack-cards (three stacked notification cards), 3d-task-list (rotated task list card), orbiting-icons (orbiting integration icons on rings), map (world map with animated location markers), marquee (scrolling text/icon rows with centered icon), line-chart (area line chart with gradient fill), phone (interactive phone mockup with notification animation), or media-stack (three stacked images/videos that fan out on hover). Automatically switches between grid (1-4 items) and carousel (5+ items). Carousel offers auto-scroll or button controls (recommended: keep default buttons). Optional header with title, description, tag, and buttons. Supports centered or split textbox layouts. Best for modern landing pages showcasing platform capabilities with visual flair.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Our Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 35
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Discover the tools and capabilities that make our platform powerful",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"featureCardRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Advanced Analytics",
|
||||
"minChars": 2,
|
||||
"maxChars": 35
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Get detailed insights into your business performance",
|
||||
"minChars": 10,
|
||||
"maxChars": 250
|
||||
}
|
||||
},
|
||||
"bentoComponentRules": {
|
||||
"note": "CRITICAL: Each feature MUST use a DIFFERENT bentoComponent type. Never repeat the same type across features (e.g., don't use 'globe' twice). Requirements vary by type:",
|
||||
"types": {
|
||||
"globe": "{ bentoComponent: 'globe' } - No additional fields required",
|
||||
"animated-bar-chart": "{ bentoComponent: 'animated-bar-chart' } - No additional fields required",
|
||||
"map": "{ bentoComponent: 'map' } - No additional fields required",
|
||||
"line-chart": "{ bentoComponent: 'line-chart' } - No additional fields required",
|
||||
"icon-info-cards": "{ bentoComponent: 'icon-info-cards', items: Array<{ icon: LucideIcon, label: string, value: string }> } - Requires items array",
|
||||
"3d-stack-cards": "{ bentoComponent: '3d-stack-cards', items: [Bento3DItem, Bento3DItem, Bento3DItem] } - Requires exactly 3 items. Each item: { icon: LucideIcon, title: string, subtitle: string, detail: string }",
|
||||
"3d-task-list": "{ bentoComponent: '3d-task-list', title: string, items: Array<{ icon: LucideIcon, label: string, time: string }> } - Requires title and items array",
|
||||
"orbiting-icons": "{ bentoComponent: 'orbiting-icons', centerIcon: LucideIcon, items: Array<{ icon: LucideIcon, ring?: 1 | 2 | 3, duration?: number }> } - Requires centerIcon and items array. ring defaults to 2, duration defaults to 10s",
|
||||
"marquee": "{ bentoComponent: 'marquee', centerIcon: LucideIcon, variant: 'text' | 'icon', texts?: string[], icons?: LucideIcon[] } - Requires centerIcon and variant. If variant='text', requires texts array. If variant='icon', requires icons array. Shows scrolling rows with centered icon",
|
||||
"phone": "{ bentoComponent: 'phone', statusIcon: LucideIcon, alertIcon: LucideIcon, alertTitle: string, alertMessage: string, apps: PhoneApps8 } - Requires all fields. statusIcon is displayed at top (e.g. Lock), alertIcon for notification, alertTitle/alertMessage for notification content, apps is exactly 8 items Array<{ name: string, icon: LucideIcon }>. Interactive phone mockup with notification slide-in animation and app grid on hover",
|
||||
"chat": "{ bentoComponent: 'chat', aiIcon: LucideIcon, userIcon: LucideIcon, exchanges: Array<{ userMessage: string, aiResponse: string }>, placeholder: string } - Requires aiIcon, userIcon, exchanges array, and placeholder. Each exchange contains a user message and AI response pair. Chat interface with vertical marquee animation",
|
||||
"3d-card-grid": "{ bentoComponent: '3d-card-grid', items: [GridCardItem, GridCardItem, GridCardItem, GridCardItem], centerIcon: LucideIcon } - Requires exactly 4 items and centerIcon. Each item: { name: string, icon: LucideIcon }. 3D perspective grid with cards at corners and center icon",
|
||||
"reveal-icon": "{ bentoComponent: 'reveal-icon', icon: LucideIcon } - Requires icon. Animated doors that slide open on hover revealing center icon with glow effect",
|
||||
"timeline": "{ bentoComponent: 'timeline', heading: string, subheading: string, items: [TimelineItem, TimelineItem, TimelineItem], completedLabel: string } - Requires heading, subheading, exactly 3 items, and completedLabel. Each item: { label: string, detail: string }. Animated timeline with staggered reveal on hover",
|
||||
"media-stack": "{ bentoComponent: 'media-stack', items: [MediaStackItem, MediaStackItem, MediaStackItem] } - Requires exactly 3 items. Each item: { imageSrc?: string, videoSrc?: string, imageAlt?: string }. Three stacked images/videos with rotation that fan out on hover"
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"features": "Array<FeatureCard> - Each card has { title: string, description: string, button?: ButtonConfig } and one of: { bentoComponent: 'globe' } | { bentoComponent: 'animated-bar-chart' } | { bentoComponent: 'map' } | { bentoComponent: 'line-chart' } | { bentoComponent: 'phone', statusIcon: LucideIcon, alertIcon: LucideIcon, alertTitle: string, alertMessage: string, apps: Array<{ name: string, icon: LucideIcon }> (exactly 8 items) } | { bentoComponent: 'chat', aiIcon: LucideIcon, userIcon: LucideIcon, exchanges: Array<{ userMessage: string, aiResponse: string }>, placeholder: string } | { bentoComponent: 'icon-info-cards', items: Array<{ icon: LucideIcon, label: string, value: string }> } | { bentoComponent: '3d-stack-cards', items: [{ icon: LucideIcon, title: string, subtitle: string, detail: string }, { icon: LucideIcon, title: string, subtitle: string, detail: string }, { icon: LucideIcon, title: string, subtitle: string, detail: string }] } | { bentoComponent: '3d-task-list', title: string, items: Array<{ icon: LucideIcon, label: string, time: string }> } | { bentoComponent: 'orbiting-icons', centerIcon: LucideIcon, items: Array<{ icon: LucideIcon, ring?: 1 | 2 | 3, duration?: number }> } | { bentoComponent: 'marquee', centerIcon: LucideIcon, variant: 'text', texts: string[] } | { bentoComponent: 'marquee', centerIcon: LucideIcon, variant: 'icon', icons: LucideIcon[] } | { bentoComponent: '3d-card-grid', items: [{ name: string, icon: LucideIcon }, { name: string, icon: LucideIcon }, { name: string, icon: LucideIcon }, { name: string, icon: LucideIcon }], centerIcon: LucideIcon } | { bentoComponent: 'reveal-icon', icon: LucideIcon } | { bentoComponent: 'timeline', heading: string, subheading: string, items: [{ label: string, detail: string }, { label: string, detail: string }, { label: string, detail: string }], completedLabel: string } | { bentoComponent: 'media-stack', items: [{ imageSrc?: string, videoSrc?: string, imageAlt?: string }, { imageSrc?: string, videoSrc?: string, imageAlt?: string }, { imageSrc?: string, videoSrc?: string, imageAlt?: string }] }",
|
||||
"carouselMode?": "'auto' | 'buttons' (default: 'buttons')",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'blur-reveal' (required)",
|
||||
"title": "string (required)",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string (required)",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"useInvertedBackground": "boolean (required)",
|
||||
"ariaLabel?": "string (default: 'Feature section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxTitleImageWrapperClassName?": "string",
|
||||
"textBoxTitleImageClassName?": "string",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"cardDescriptionClassName?": "string",
|
||||
"cardButtonClassName?": "string",
|
||||
"cardButtonTextClassName?": "string",
|
||||
"gridClassName?": "string",
|
||||
"carouselClassName?": "string",
|
||||
"controlsClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureBento features={[{ title: 'Global Reach', description: 'Worldwide presence', bentoComponent: 'globe' }, { title: 'Integrations', description: 'Connect your tools', bentoComponent: 'orbiting-icons', centerIcon: Shield, items: [{ icon: Users, ring: 1 }, { icon: Zap, ring: 2 }] }]} title=\"Features\" description=\"Discover our platform\" textboxLayout=\"default\" animationType=\"slide-up\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for showcasing features with interactive visualizations",
|
||||
"Use appropriate bentoComponent for each feature type",
|
||||
"Provide all required props for each bentoComponent type",
|
||||
"Best for modern landing pages showcasing platform capabilities"
|
||||
],
|
||||
"dont": [
|
||||
"CRITICAL: NEVER use the same bentoComponent type for multiple features - each feature MUST have a unique/different bento type (e.g., if one uses 'globe', others must use 'map', 'timeline', 'chat', etc.)",
|
||||
"Do not use without proper items for bento types that require them",
|
||||
"Do not use for simple text-only feature lists"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
104
registry/components/FeatureBorderGlow.json
Normal file
104
registry/components/FeatureBorderGlow.json
Normal file
@@ -0,0 +1,104 @@
|
||||
{
|
||||
"name": "FeatureBorderGlow",
|
||||
"description": "CardStack feature section with animated glowing border effect that follows cursor/scroll.",
|
||||
"details": "Use for feature showcases with premium animated border effect. Uses CardStack with uniform-all-items-equal grid (hardcoded). Each card displays an icon at top, title and description below, with an animated glowing border overlay using Motion React. The border glow dynamically follows mouse position on desktop (within proximity threshold of 64px), or activates on scroll for mobile. Effect uses CSS variables (accent, background-accent) for theme-aware colors. Border width is 1.5px with 40deg spread and smooth angle transitions (2s duration). Desktop: Glowing effect tracks mouse movement with conic gradient mask following cursor angle. Mobile: Effect centers on viewport when card enters view. Each card uses primary-button styling for icon container (3.75rem square) with card styling and rounded-theme-capped borders. All cards have min-h-75 2xl:min-h-85 default height. The glowing effect has inactive zone of 0.01 (nearly no dead zone in center). Best for 2-6 features to showcase premium product benefits with elegant visual polish.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Powerful Features with Border Glow",
|
||||
"minChars": 2,
|
||||
"maxChars": 35
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Hover over each card to reveal the glowing border effect",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"featureCardRules": {
|
||||
"icon": {
|
||||
"required": true,
|
||||
"example": "Zap",
|
||||
"note": "LucideIcon component displayed at top of card with glowing border"
|
||||
},
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Lightning Fast",
|
||||
"minChars": 2,
|
||||
"maxChars": 40
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Optimized for performance with minimal overhead and blazing fast load times",
|
||||
"minChars": 10,
|
||||
"maxChars": 200
|
||||
}
|
||||
},
|
||||
"itemRules": {
|
||||
"minItems": 2,
|
||||
"maxItems": 6,
|
||||
"recommendedItems": "2-6",
|
||||
"note": "Works best with 2-6 features for optimal grid layout"
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"features": "Array<{ icon: LucideIcon, title: string, description: string }> (required)",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal' (required)",
|
||||
"title": "string (required)",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string (required)",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"useInvertedBackground": "boolean (required)",
|
||||
"carouselMode?": "'auto' | 'buttons' (default: 'buttons' - for 5+ items)",
|
||||
"uniformGridCustomHeightClasses?": "string (default: 'min-h-75 2xl:min-h-85')",
|
||||
"ariaLabel?": "string (default: 'Feature section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"iconContainerClassName?": "string",
|
||||
"iconClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxTitleImageWrapperClassName?": "string",
|
||||
"textBoxTitleImageClassName?": "string",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"cardDescriptionClassName?": "string",
|
||||
"gridClassName?": "string",
|
||||
"carouselClassName?": "string",
|
||||
"controlsClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureBorderGlow features={[{ icon: Zap, title: 'Lightning Fast', description: 'Optimized for performance with minimal overhead' }, { icon: Shield, title: 'Secure by Default', description: 'Built with security best practices' }]} title=\"Powerful Features with Border Glow\" description=\"Hover over each card to reveal the glowing border effect\" textboxLayout=\"default\" animationType=\"slide-up\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for premium feature showcases with elegant visual polish",
|
||||
"Best for 2-6 features",
|
||||
"Each feature requires icon, title, and description",
|
||||
"Use for modern landing pages"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use for simple text-only feature lists",
|
||||
"Do not use without icons for each feature"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
125
registry/components/FeatureCardEight.json
Normal file
125
registry/components/FeatureCardEight.json
Normal file
@@ -0,0 +1,125 @@
|
||||
{
|
||||
"name": "FeatureCardEight",
|
||||
"description": "Horizontal timeline feature section with auto-advancing progress bars, numbered step badges, and shared media display.",
|
||||
"details": "Use for sequential feature presentations or process flows in a horizontal timeline layout. Displays 2-4 feature cards in a grid (2-4 columns on desktop, stacked on mobile) with auto-advancing progress bars that fill over 5 seconds. Each card shows a numbered step badge, title, and description. The shared media area above cards displays images/videos that smoothly transition (opacity fade) as cards advance. Media uses aspect-square on mobile and aspect-video on desktop. Active and previous cards are fully visible (opacity-100), future cards are dimmed (opacity-50). Users can click any card to jump to that step. Grid adapts: 2 items = 2 columns, 3 items = 3 columns, 4+ items = 4 columns. Automatically loops back to first card. Optional header with title, description, tag, and buttons. Header supports centered or split textbox layout (split: tag + title + description left, buttons right; split-actions: tag + title left, buttons only right; split-description: tag + title left, description only right).",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Our Process",
|
||||
"minChars": 2,
|
||||
"maxChars": 35
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Discover how we bring ideas to life",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "How It Works",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"featureCardRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Research & Planning",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Understanding user needs, market trends, and project requirements",
|
||||
"minChars": 10,
|
||||
"maxChars": 300
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"imageSrc": {
|
||||
"required": true,
|
||||
"example": "/feature1.jpg",
|
||||
"note": "Either imageSrc or videoSrc required per card (discriminated union) Either imageSrc or videoSrc should be provided. Image is recommended if no videoSrc."
|
||||
},
|
||||
"videoSrc": {
|
||||
"required": true,
|
||||
"example": "/feature1.mp4",
|
||||
"note": "Either imageSrc or videoSrc required per card (discriminated union)"
|
||||
},
|
||||
"imageAlt": {
|
||||
"required": false,
|
||||
"example": "Research and planning illustration",
|
||||
"note": "Falls back to feature title if not provided"
|
||||
},
|
||||
"videoAriaLabel": {
|
||||
"required": false,
|
||||
"example": "Research and planning video",
|
||||
"note": "Falls back to feature title if not provided"
|
||||
}
|
||||
},
|
||||
"itemRules": {
|
||||
"minItems": 2,
|
||||
"maxItems": 4,
|
||||
"recommendedItems": "2-4",
|
||||
"note": "Works best with 2-4 features. Grid layout adapts based on item count."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"features": "Array<{ title: string, description: string } & ({ imageSrc: string, imageAlt?: string } | { videoSrc: string, videoAriaLabel?: string })>",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"useInvertedBackground": "boolean",
|
||||
"ariaLabel?": "string (default: 'Feature section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"titleImageWrapperClassName?": "string - For styling image wrapper in inline-image layout",
|
||||
"titleImageClassName?": "string - For styling images in inline-image layout",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"progressBarClassName?": "string",
|
||||
"cardContentClassName?": "string",
|
||||
"stepNumberClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"cardDescriptionClassName?": "string",
|
||||
"mediaContainerClassName?": "string",
|
||||
"mediaClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureCardEight features={[{ title: 'Research & Planning', description: 'Understanding user needs, market trends, and project requirements', imageSrc: '/feature1.jpg' }]} title=\"Our Process\" description=\"Discover how we bring ideas to life\" textboxLayout=\"default\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for process flows",
|
||||
"Use for roadmaps",
|
||||
"Use for step-by-step explanation",
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Requires features[]",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use non-sequential content",
|
||||
"Do not use single item",
|
||||
"Do not use more than 4 items",
|
||||
"Do not use less than 2 items",
|
||||
"Do not use more than 4 items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
96
registry/components/FeatureCardMedia.json
Normal file
96
registry/components/FeatureCardMedia.json
Normal file
@@ -0,0 +1,96 @@
|
||||
{
|
||||
"name": "FeatureCardMedia",
|
||||
"description": "Feature section with media cards displaying tag overlay, title, description, and optional buttons.",
|
||||
"details": "Displays feature cards in a responsive grid or carousel layout. Each card shows media (image/video) with required tag overlay positioned top-right, followed by title, description, and optional action buttons. Uses CardStack for layout management with grid (1-4 items) and carousel (5+ items) modes.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "From concept to launch, we've got you covered",
|
||||
"minChars": 10,
|
||||
"maxChars": 100
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Discover how we bring ideas to life through a proven methodology",
|
||||
"minChars": 20,
|
||||
"maxChars": 300
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Our Process",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"featuresRules": {
|
||||
"minItems": 2,
|
||||
"recommendedItems": 3,
|
||||
"maxItems": 6,
|
||||
"structure": {
|
||||
"id": "string - Unique identifier (required)",
|
||||
"title": "string - Card title (required)",
|
||||
"description": "string - Card description (required)",
|
||||
"tag": "string - Tag displayed on media top-right (required)",
|
||||
"imageSrc": "string - Image source URL (optional) Image is recommended if no videoSrc.",
|
||||
"videoSrc": "string - Video source URL (optional)",
|
||||
"buttons": "ButtonConfig[] - Optional action buttons for the card"
|
||||
},
|
||||
"note": "Each card requires id, title, description, and tag. Media (imageSrc or videoSrc) recommended. Buttons are optional per card."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"features": "Array<{ id: string, title: string, description: string, tag: string, imageSrc?: string, videoSrc?: string, imageAlt?: string, videoAriaLabel?: string, buttons?: ButtonConfig[], onCardClick?: () => void }>",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal'",
|
||||
"title": "string",
|
||||
"description": "string",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image'",
|
||||
"useInvertedBackground": "boolean",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }>",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "ButtonConfig[]",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"carouselMode?": "'auto' | 'buttons' (default: 'buttons')",
|
||||
"uniformGridCustomHeightClasses?": "string",
|
||||
"ariaLabel?": "string (default: 'Features section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"itemClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"mediaClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"contentClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"cardDescriptionClassName?": "string",
|
||||
"cardButtonContainerClassName?": "string",
|
||||
"cardButtonClassName?": "string",
|
||||
"cardButtonTextClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxTitleImageWrapperClassName?": "string",
|
||||
"textBoxTitleImageClassName?": "string",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"gridClassName?": "string",
|
||||
"carouselClassName?": "string",
|
||||
"controlsClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureCardMedia features={[{ id: '1', title: 'Research', description: 'Understanding user needs and market trends', tag: 'Phase 1', imageSrc: '/img.jpg', buttons: [{ text: 'Learn more', href: '#' }] }]} animationType=\"slide-up\" textboxLayout=\"default\" title=\"Our Process\" description=\"Discover how we work\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Requires features[]",
|
||||
"Requires titleSegments?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
150
registry/components/FeatureCardNine.json
Normal file
150
registry/components/FeatureCardNine.json
Normal file
@@ -0,0 +1,150 @@
|
||||
{
|
||||
"name": "FeatureCardNine",
|
||||
"description": "Scroll-based timeline feature section with two animated phone frames and centered content.",
|
||||
"details": "Use for mobile-first feature presentations with visual phone mockups. Creates a vertical scroll-based timeline where each feature takes up 100vh of height. Features are displayed with title and description in the center, flanked by two animated phone frames (left and right) that slide in and rotate on scroll. Phone frames use GSAP ScrollTrigger animations: start from off-screen with rotation (-200% left, 200% right with 45deg rotation), then animate to center position with subtle rotation tilt. Desktop phones are 20 (w-20) 2xl:25 (2xl:w-25) in width and 70vh in height. Mobile phones are 45 (w-45) in width and 100 (h-100) in height. Phones display as card with rounded-theme-capped and p-1 padding. Each phone can show either an image or video (discriminated union). Feature content displays in the center with large text (5xl md:6xl title, xl description). Section has py-20 spacing. Mobile layout stacks feature content above phone pairs vertically. Desktop layout uses sticky positioning for phones while content scrolls through. Best for 2-4 features to avoid excessive scroll height.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Powerful Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 35
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Everything you need to build amazing products",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"featureCardRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Seamless Integration",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Connect your tools and workflows effortlessly. Our platform integrates with your existing systems.",
|
||||
"minChars": 10,
|
||||
"maxChars": 300
|
||||
}
|
||||
},
|
||||
"phoneMediaRules": {
|
||||
"phoneOne": {
|
||||
"imageSrc": {
|
||||
"required": true,
|
||||
"example": "/phone1.jpg",
|
||||
"note": "Either imageSrc or videoSrc required for phoneOne (discriminated union) Either imageSrc or videoSrc should be provided. Image is recommended if no videoSrc."
|
||||
},
|
||||
"videoSrc": {
|
||||
"required": true,
|
||||
"example": "/phone1.mp4",
|
||||
"note": "Either imageSrc or videoSrc required for phoneOne (discriminated union)"
|
||||
},
|
||||
"imageAlt": {
|
||||
"required": false,
|
||||
"example": "First phone mockup",
|
||||
"note": "Falls back to '[title] - Phone 1' if not provided"
|
||||
},
|
||||
"videoAriaLabel": {
|
||||
"required": false,
|
||||
"example": "First phone video",
|
||||
"note": "Falls back to '[title] - Phone 1 video' if not provided"
|
||||
}
|
||||
},
|
||||
"phoneTwo": {
|
||||
"imageSrc": {
|
||||
"required": true,
|
||||
"example": "/phone2.jpg",
|
||||
"note": "Either imageSrc or videoSrc required for phoneTwo (discriminated union) Either imageSrc or videoSrc should be provided. Image is recommended if no videoSrc."
|
||||
},
|
||||
"videoSrc": {
|
||||
"required": true,
|
||||
"example": "/phone2.mp4",
|
||||
"note": "Either imageSrc or videoSrc required for phoneTwo (discriminated union)"
|
||||
},
|
||||
"imageAlt": {
|
||||
"required": false,
|
||||
"example": "Second phone mockup",
|
||||
"note": "Falls back to '[title] - Phone 2' if not provided"
|
||||
},
|
||||
"videoAriaLabel": {
|
||||
"required": false,
|
||||
"example": "Second phone video",
|
||||
"note": "Falls back to '[title] - Phone 2 video' if not provided"
|
||||
}
|
||||
}
|
||||
},
|
||||
"itemRules": {
|
||||
"minItems": 2,
|
||||
"maxItems": 4,
|
||||
"recommendedItems": "2-4",
|
||||
"note": "Each feature takes 100vh height. Recommend 2-4 features to avoid excessive scroll."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"features": "Array<{ title: string, description: string, buttons?: ButtonConfig[], phoneOne: ({ imageSrc: string, imageAlt?: string } | { videoSrc: string, videoAriaLabel?: string }), phoneTwo: ({ imageSrc: string, imageAlt?: string } | { videoSrc: string, videoAriaLabel?: string }) }>",
|
||||
"showStepNumbers": "boolean (required - controls whether step number badges display)",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal' (required)",
|
||||
"textboxLayout": "'default' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"useInvertedBackground": "boolean",
|
||||
"ariaLabel?": "string (default: 'Feature section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"titleImageWrapperClassName?": "string - For styling image wrapper in inline-image layout",
|
||||
"titleImageClassName?": "string - For styling images in inline-image layout",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string",
|
||||
"desktopContainerClassName?": "string",
|
||||
"mobileContainerClassName?": "string",
|
||||
"desktopContentClassName?": "string",
|
||||
"desktopWrapperClassName?": "string",
|
||||
"mobileWrapperClassName?": "string",
|
||||
"phoneFrameClassName?": "string",
|
||||
"mobilePhoneFrameClassName?": "string",
|
||||
"featureContentClassName?": "string",
|
||||
"stepNumberClassName?": "string",
|
||||
"featureTitleClassName?": "string",
|
||||
"featureDescriptionClassName?": "string",
|
||||
"cardButtonClassName?": "string",
|
||||
"cardButtonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureCardNine features={[{ title: 'Seamless Integration', description: 'Connect your tools and workflows effortlessly', phoneOne: { imageSrc: '/phone1.jpg' }, phoneTwo: { imageSrc: '/phone2.jpg' } }]} showStepNumbers={true} title=\"Powerful Features\" description=\"Everything you need to build amazing products\" textboxLayout=\"default\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Requires features[]",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use less than 2 items",
|
||||
"Do not use more than 4 items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
127
registry/components/FeatureCardNineteen.json
Normal file
127
registry/components/FeatureCardNineteen.json
Normal file
@@ -0,0 +1,127 @@
|
||||
{
|
||||
"name": "FeatureCardNineteen",
|
||||
"description": "Timeline feature section with full-width cards showing step numbers and rotated media.",
|
||||
"details": "Use for process or step-by-step showcases with large visual impact. Layout: TextBox Header → Full-width timeline cards with scroll-triggered stacking. Each card has: Tag + Large title (left), Subtitle + Description + Buttons (bottom left), Step number (top right), Rotated image/video (right). Mobile: Single column with divider line, step number hidden. Best for showcasing 3-6 step processes or service phases.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Our Process",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Discover how we bring ideas to life",
|
||||
"minChars": 5,
|
||||
"maxChars": 300
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "How it works",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"featureCardRules": {
|
||||
"tag": {
|
||||
"required": true,
|
||||
"example": "Expertise",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
},
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Strategy",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
},
|
||||
"subtitle": {
|
||||
"required": true,
|
||||
"example": "Data-driven decisions for growth.",
|
||||
"minChars": 5,
|
||||
"maxChars": 60
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "We analyze market trends and user behavior to create strategies that drive real results.",
|
||||
"minChars": 50,
|
||||
"maxChars": 350
|
||||
},
|
||||
"imageSrc": {
|
||||
"required": false,
|
||||
"example": "/images/strategy.webp",
|
||||
"note": "Image source URL (either imageSrc or videoSrc) Either imageSrc or videoSrc should be provided. Image is recommended if no videoSrc."
|
||||
},
|
||||
"videoSrc": {
|
||||
"required": false,
|
||||
"example": "/videos/strategy.mp4",
|
||||
"note": "Video source URL (either imageSrc or videoSrc)"
|
||||
},
|
||||
"buttons": {
|
||||
"required": false,
|
||||
"example": [
|
||||
{
|
||||
"text": "Learn more",
|
||||
"href": "/strategy"
|
||||
}
|
||||
],
|
||||
"note": "Optional buttons per feature card (max 2)"
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"features": "Array<{ tag: string, title: string, subtitle: string, description: string, imageSrc?: string, videoSrc?: string, imageAlt?: string, videoAriaLabel?: string, buttons?: Array<{text: string, onClick?: () => void, href?: string}> }> (required)",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required)",
|
||||
"useInvertedBackground": "boolean",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"ariaLabel?": "string (default: 'Feature section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string",
|
||||
"titleImageWrapperClassName?": "string",
|
||||
"titleImageClassName?": "string",
|
||||
"cardContentClassName?": "string",
|
||||
"cardTagClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"cardDescriptionClassName?": "string",
|
||||
"cardButtonClassName?": "string",
|
||||
"cardButtonTextClassName?": "string",
|
||||
"imageContainerClassName?": "string",
|
||||
"imageClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureCardNineteen features={[{ tag: 'Expertise', title: 'Strategy', subtitle: 'Data-driven decisions', description: 'We analyze market trends...', imageSrc: '/images/strategy.webp' }]} title=\"Our Process\" description=\"Discover how we bring ideas to life\" textboxLayout=\"default\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for process flows",
|
||||
"Use for roadmaps",
|
||||
"Use for step-by-step explanation",
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Requires features[]",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use multiple items",
|
||||
"Do not use non-sequential content",
|
||||
"Do not use single item"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
96
registry/components/FeatureCardOne.json
Normal file
96
registry/components/FeatureCardOne.json
Normal file
@@ -0,0 +1,96 @@
|
||||
{
|
||||
"name": "FeatureCardOne",
|
||||
"description": "Adaptive feature section with image/video-based cards in customizable bento grid layouts or carousel.",
|
||||
"details": "Use for visually-rich feature showcases with images or videos. Each card displays media (image/video), title, description, and optional button. Automatically switches between grid (1-4 items) and carousel (5+ items). For grid layouts, choose from 9 bento variants: uniform-all-items-equal, two-columns-alternating-heights, asymmetric-60-wide-40-narrow, three-columns-all-equal-width, four-items-2x2-equal-grid, one-large-right-three-stacked-left, items-top-row-full-width-bottom, full-width-top-items-bottom-row, one-large-left-three-stacked-right. Carousel offers auto-scroll or button controls (recommended: keep default buttons for better UX). Optional header with title, description, tag, and buttons. Header supports centered or split textbox layout (split: tag + title + description left, buttons right; split-actions: tag + title left, buttons only right; split-description: tag + title left, description only right).",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Our Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 35
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Discover the tools and capabilities that make our platform powerful",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"featureCardRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Advanced Analytics",
|
||||
"minChars": 2,
|
||||
"maxChars": 35
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Get detailed insights into your business performance",
|
||||
"minChars": 10,
|
||||
"maxChars": 250
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"features": "Array<{ title: string, description: string, button?: {text: string, onClick?: () => void, href?: string} } & ({ imageSrc: string, imageAlt?: string } | { videoSrc: string, videoAriaLabel?: string })>",
|
||||
"carouselMode?": "'auto' | 'buttons' (default: 'buttons')",
|
||||
"gridVariant": "'uniform-all-items-equal' | 'bento-grid' | 'bento-grid-inverted' | 'two-columns-alternating-heights' | 'asymmetric-60-wide-40-narrow' | 'three-columns-all-equal-width' | 'four-items-2x2-equal-grid' | 'one-large-right-three-stacked-left' | 'items-top-row-full-width-bottom' | 'full-width-top-items-bottom-row' | 'one-large-left-three-stacked-right' | 'two-items-per-row'",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal' | 'depth-3d'",
|
||||
"uniformGridCustomHeightClasses?": "string",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"ariaLabel?": "string (default: 'Feature section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"mediaClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxTitleImageWrapperClassName?": "string - For styling image wrapper in inline-image layout",
|
||||
"textBoxTitleImageClassName?": "string - For styling images in inline-image layout",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"cardDescriptionClassName?": "string",
|
||||
"cardButtonClassName?": "string",
|
||||
"cardButtonTextClassName?": "string",
|
||||
"gridClassName?": "string",
|
||||
"carouselClassName?": "string",
|
||||
"controlsClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string",
|
||||
"useInvertedBackground": "boolean",
|
||||
"showVerifiedBadge?": "boolean"
|
||||
},
|
||||
"usageExample": "<FeatureCardOne features={[{ title: 'Analytics', description: 'Get insights', imageSrc: '/feature.jpg', button: { text: 'Learn More', href: '#' } }]} title=\"Our Features\" description=\"Discover what makes us different\" textboxLayout=\"default\" animationType=\"slide-up\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Use for statistics displays",
|
||||
"Use for achievement showcases",
|
||||
"Requires features[]",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
118
registry/components/FeatureCardSeven.json
Normal file
118
registry/components/FeatureCardSeven.json
Normal file
@@ -0,0 +1,118 @@
|
||||
{
|
||||
"name": "FeatureCardSeven",
|
||||
"description": "Vertical stack feature section with alternating left/right layouts and numbered step cards with square images.",
|
||||
"details": "Use for sequential feature presentations or process flows in a vertical layout. Each card displays a numbered step badge, title, description, and square aspect ratio media (image or video) in a two-column layout. On desktop, the layout alternates between text-left/image-right (even indices) and image-left/text-right (odd indices) creating a zigzag pattern. On mobile, always displays as flex-col (text on top, image below). Uses CardList component with GSAP scroll animations and stagger effect. Optional header with title, description, tag, and buttons. Header supports centered or split textbox layout (split: tag + title + description left, buttons right; split-actions: tag + title left, buttons only right; split-description: tag + title left, description only right).",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Our Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 35
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Sequential features with numbered badges",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"featureCardRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Modern Architecture",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Built with the latest technologies and best practices",
|
||||
"minChars": 10,
|
||||
"maxChars": 300
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"imageSrc": {
|
||||
"required": false,
|
||||
"example": "/feature1.jpg",
|
||||
"note": "Either imageSrc or videoSrc required per card Either imageSrc or videoSrc should be provided. Image is recommended if no videoSrc."
|
||||
},
|
||||
"videoSrc": {
|
||||
"required": false,
|
||||
"example": "/feature1.mp4",
|
||||
"note": "Either imageSrc or videoSrc required per card"
|
||||
},
|
||||
"imageAlt": {
|
||||
"required": false,
|
||||
"example": "Modern architecture illustration",
|
||||
"note": "Falls back to feature title if not provided"
|
||||
},
|
||||
"videoAriaLabel": {
|
||||
"required": false,
|
||||
"example": "Modern architecture video",
|
||||
"note": "Falls back to feature title if not provided"
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"features": "Array<{ title: string, description: string, buttons?: ButtonConfig[] } & ({ imageSrc: string, imageAlt?: string } | { videoSrc: string, videoAriaLabel?: string })>",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal' (required - controls GSAP scroll animations with stagger effect)",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"useInvertedBackground": "boolean",
|
||||
"ariaLabel?": "string (default: 'Feature section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"titleImageWrapperClassName?": "string - For styling image wrapper in inline-image layout",
|
||||
"titleImageClassName?": "string - For styling images in inline-image layout",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string",
|
||||
"cardContentClassName?": "string",
|
||||
"stepNumberClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"cardDescriptionClassName?": "string",
|
||||
"imageContainerClassName?": "string",
|
||||
"imageClassName?": "string",
|
||||
"cardButtonClassName?": "string",
|
||||
"cardButtonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureCardSeven features={[{ title: 'Modern Architecture', description: 'Built with the latest technologies and best practices', imageSrc: '/feature1.jpg' }]} title=\"Our Features\" description=\"Sequential features with numbered badges\" textboxLayout=\"default\" animationType=\"blur-reveal\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for process flows",
|
||||
"Use for roadmaps",
|
||||
"Use for step-by-step explanation",
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Requires features[]",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use non-sequential content",
|
||||
"Do not use single item"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
116
registry/components/FeatureCardSix.json
Normal file
116
registry/components/FeatureCardSix.json
Normal file
@@ -0,0 +1,116 @@
|
||||
{
|
||||
"name": "FeatureCardSix",
|
||||
"description": "Timeline-based feature section with scroll-triggered stacking animations and numbered step cards.",
|
||||
"details": "Use for process flows, roadmaps, or sequential feature presentations. Each card displays a numbered step badge, title, description, and media (image or video) in a two-column layout. As you scroll, cards stack on top of each other with fade animations. The timeline layout provides a clear visual progression through steps or stages. No grid/carousel modes - uses fixed timeline stacking layout with GSAP ScrollTrigger. Optional header with title, description, tag, and buttons. Header supports centered or split textbox layout (split: tag + title + description left, buttons right; split-actions: tag + title left, buttons only right; split-description: tag + title left, description only right).",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Our Process",
|
||||
"minChars": 2,
|
||||
"maxChars": 35
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Discover how we bring ideas to life",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Process",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"featureCardRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Research & Planning",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Understanding user needs, market trends, and project requirements",
|
||||
"minChars": 10,
|
||||
"maxChars": 300
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"imageSrc": {
|
||||
"required": false,
|
||||
"example": "/step1.jpg",
|
||||
"note": "Either imageSrc or videoSrc required per card Either imageSrc or videoSrc should be provided. Image is recommended if no videoSrc."
|
||||
},
|
||||
"videoSrc": {
|
||||
"required": false,
|
||||
"example": "/step1.mp4",
|
||||
"note": "Either imageSrc or videoSrc required per card"
|
||||
},
|
||||
"imageAlt": {
|
||||
"required": false,
|
||||
"example": "Research phase illustration",
|
||||
"note": "Falls back to feature title if not provided"
|
||||
},
|
||||
"videoAriaLabel": {
|
||||
"required": false,
|
||||
"example": "Research phase video",
|
||||
"note": "Falls back to feature title if not provided"
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"features": "Array<{ title: string, description: string, buttons?: ButtonConfig[] } & ({ imageSrc: string, imageAlt?: string } | { videoSrc: string, videoAriaLabel?: string })>",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"useInvertedBackground": "boolean",
|
||||
"ariaLabel?": "string (default: 'Feature section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"titleImageWrapperClassName?": "string - For styling image wrapper in inline-image layout",
|
||||
"titleImageClassName?": "string - For styling images in inline-image layout",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string",
|
||||
"cardContentClassName?": "string",
|
||||
"stepNumberClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"cardDescriptionClassName?": "string",
|
||||
"imageContainerClassName?": "string",
|
||||
"imageClassName?": "string",
|
||||
"cardButtonClassName?": "string",
|
||||
"cardButtonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureCardSix features={[{ title: 'Research & Planning', description: 'Understanding user needs and project requirements', imageSrc: '/step1.jpg' }]} title=\"Our Process\" description=\"Discover how we bring ideas to life\" textboxLayout=\"default\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for process flows",
|
||||
"Use for roadmaps",
|
||||
"Use for step-by-step explanation",
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Requires features[]",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use non-sequential content",
|
||||
"Do not use single item"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
99
registry/components/FeatureCardSixteen.json
Normal file
99
registry/components/FeatureCardSixteen.json
Normal file
@@ -0,0 +1,99 @@
|
||||
{
|
||||
"name": "FeatureCardSixteen",
|
||||
"description": "Comparison section with negative and positive cards showing contrasting features.",
|
||||
"details": "Use for before/after comparisons, pros vs cons, or contrasting two approaches. Layout: TextBox Header → Two side-by-side cards (negative with X icons at 50% opacity, positive with Check icons). Always requires exactly one negative and one positive card. Best for comparison marketing or highlighting advantages over alternatives.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "What makes us stand out",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "See how we compare to traditional approaches",
|
||||
"minChars": 5,
|
||||
"maxChars": 300
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Why us",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"negativeCardRules": {
|
||||
"items": {
|
||||
"required": true,
|
||||
"example": [
|
||||
"Time-consuming processes",
|
||||
"Limited scalability",
|
||||
"Higher costs"
|
||||
],
|
||||
"minItems": 2,
|
||||
"maxItems": 10,
|
||||
"note": "List of negative aspects displayed with X icons"
|
||||
}
|
||||
},
|
||||
"positiveCardRules": {
|
||||
"items": {
|
||||
"required": true,
|
||||
"example": [
|
||||
"Streamlined workflow",
|
||||
"Scalable solutions",
|
||||
"Better value"
|
||||
],
|
||||
"minItems": 2,
|
||||
"maxItems": 10,
|
||||
"note": "List of positive aspects displayed with Check icons"
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"negativeCard": "{ items: string[] } (required)",
|
||||
"positiveCard": "{ items: string[] } (required)",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal' | 'depth-3d'",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"textboxLayout": "'default' | 'inline-image' (required)",
|
||||
"useInvertedBackground": "boolean",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"ariaLabel?": "string (default: 'Feature comparison section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"titleImageWrapperClassName?": "string",
|
||||
"titleImageClassName?": "string",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string",
|
||||
"gridClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"itemsListClassName?": "string",
|
||||
"itemClassName?": "string",
|
||||
"itemIconClassName?": "string",
|
||||
"itemTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureCardSixteen negativeCard={{ items: ['Time-consuming processes', 'Limited scalability'] }} positiveCard={{ items: ['Streamlined workflow', 'Scalable solutions'] }} animationType=\"slide-up\" title=\"What makes us stand out\" description=\"See how we compare\" textboxLayout=\"default\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
143
registry/components/FeatureCardTen.json
Normal file
143
registry/components/FeatureCardTen.json
Normal file
@@ -0,0 +1,143 @@
|
||||
{
|
||||
"name": "FeatureCardTen",
|
||||
"description": "Timeline process flow feature section with numbered steps, alternating layout, and list items.",
|
||||
"details": "Use for step-by-step process showcases with detailed feature lists. Creates a vertical timeline with a progress line that fills on scroll. Each feature displays as a horizontal layout with media (image/video card) on one side and content (title, description, icon list) on the other. Numbered badges appear on the timeline. Layout alternates between left/right based on reverse property. Desktop: centered vertical line with 30% width columns. Mobile: right-aligned vertical line with 70% width columns. Media displays in aspect-square on mobile, aspect-[16/10] on desktop with card styling. Each feature has a list of items with icons displayed in rounded icon containers. Best for 3-6 step processes to showcase detailed features with visual support.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Powerful Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 35
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Everything you need to build and scale your business with confidence",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"featureCardRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Advanced Analytics Dashboard",
|
||||
"minChars": 2,
|
||||
"maxChars": 60
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Get comprehensive insights into your business performance with our powerful analytics tools and real-time reporting.",
|
||||
"minChars": 10,
|
||||
"maxChars": 300
|
||||
},
|
||||
"reverse": {
|
||||
"required": true,
|
||||
"example": "false",
|
||||
"note": "Controls whether media and content positions are swapped (alternating layout)"
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"imageSrc": {
|
||||
"required": true,
|
||||
"example": "/feature.webp",
|
||||
"note": "Either imageSrc or videoSrc required (discriminated union) Either imageSrc or videoSrc should be provided. Image is recommended if no videoSrc."
|
||||
},
|
||||
"videoSrc": {
|
||||
"required": true,
|
||||
"example": "/feature.mp4",
|
||||
"note": "Either imageSrc or videoSrc required (discriminated union)"
|
||||
},
|
||||
"imageAlt": {
|
||||
"required": false,
|
||||
"example": "Analytics dashboard interface",
|
||||
"note": "Falls back to feature title if not provided"
|
||||
},
|
||||
"videoAriaLabel": {
|
||||
"required": false,
|
||||
"example": "Analytics dashboard video",
|
||||
"note": "Falls back to '[title] video' if not provided"
|
||||
}
|
||||
},
|
||||
"listItemRules": {
|
||||
"icon": {
|
||||
"required": true,
|
||||
"example": "Check",
|
||||
"note": "LucideIcon component for list item"
|
||||
},
|
||||
"text": {
|
||||
"required": true,
|
||||
"example": "Real-time data visualization",
|
||||
"minChars": 2,
|
||||
"maxChars": 100
|
||||
},
|
||||
"minItems": 1,
|
||||
"maxItems": 5,
|
||||
"recommendedItems": "2-4"
|
||||
},
|
||||
"itemRules": {
|
||||
"minItems": 3,
|
||||
"maxItems": 6,
|
||||
"recommendedItems": "3-6",
|
||||
"note": "Works best with 3-6 features for optimal timeline length"
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"features": "Array<{ title: string, description: string, media: ({ imageSrc: string, imageAlt?: string } | { videoSrc: string, videoAriaLabel?: string }), items: Array<{ icon: LucideIcon, text: string }>, reverse: boolean }>",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal' (required)",
|
||||
"useInvertedBackground": "boolean",
|
||||
"ariaLabel?": "string (default: 'Feature section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string",
|
||||
"titleImageWrapperClassName?": "string",
|
||||
"titleImageClassName?": "string",
|
||||
"itemClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"mediaCardClassName?": "string",
|
||||
"numberClassName?": "string",
|
||||
"contentWrapperClassName?": "string",
|
||||
"featureTitleClassName?": "string",
|
||||
"featureDescriptionClassName?": "string",
|
||||
"listItemClassName?": "string",
|
||||
"iconContainerClassName?": "string",
|
||||
"iconClassName?": "string",
|
||||
"gapClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureCardTen features={[{ title: 'Advanced Analytics Dashboard', description: 'Get comprehensive insights into your business performance', media: { imageSrc: '/placeholder1.webp' }, items: [{ icon: Check, text: 'Real-time data visualization' }, { icon: Check, text: 'Custom report generation' }], reverse: false }]} title=\"Powerful Features\" description=\"Everything you need to build and scale your business\" textboxLayout=\"default\" animationType=\"slide-up\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for step-by-step process showcases",
|
||||
"Best for 3-6 step processes",
|
||||
"Alternate reverse property for visual variety",
|
||||
"Include relevant icons for list items"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use without media for each feature",
|
||||
"Do not use without list items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
103
registry/components/FeatureCardThree.json
Normal file
103
registry/components/FeatureCardThree.json
Normal file
@@ -0,0 +1,103 @@
|
||||
{
|
||||
"name": "FeatureCardThree",
|
||||
"description": "Adaptive feature section with hover-reveal cards displaying numbered features with images.",
|
||||
"details": "Use for interactive feature showcases with hover effects. Each card displays a numbered ID badge that flips to an info icon on hover, image background, title, and description that reveals with a slide-up background animation. Automatically switches between grid (1-4 items) and carousel (5+ items). Carousel offers auto-scroll or button controls (recommended: keep default buttons for better UX). Optional header with title, description, tag, and buttons. Header supports centered or split textbox layout (split: tag + title + description left, buttons right; split-actions: tag + title left, buttons only right; split-description: tag + title left, description only right).",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Our Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 35
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Discover what makes us different",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"featureCardRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Advanced Analytics",
|
||||
"minChars": 2,
|
||||
"maxChars": 35
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Get detailed insights into your business performance",
|
||||
"minChars": 10,
|
||||
"maxChars": 250
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"imageSrc": {
|
||||
"required": true,
|
||||
"example": "/feature.jpg",
|
||||
"note": "Supports external URLs with unoptimized prop"
|
||||
},
|
||||
"imageAlt": {
|
||||
"required": false,
|
||||
"example": "Feature background",
|
||||
"note": "Empty string marks image as decorative (aria-hidden)"
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"features": "Array<{ title: string, description: string, imageSrc: string, imageAlt?: string }>",
|
||||
"carouselMode?": "'auto' | 'buttons' (default: 'buttons')",
|
||||
"gridVariant": "'uniform-all-items-equal' | 'bento-grid' | 'bento-grid-inverted' | 'two-columns-alternating-heights' | 'asymmetric-60-wide-40-narrow' | 'three-columns-all-equal-width' | 'four-items-2x2-equal-grid' | 'one-large-right-three-stacked-left' | 'items-top-row-full-width-bottom' | 'full-width-top-items-bottom-row' | 'one-large-left-three-stacked-right' (required)",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal' (required - controls GSAP scroll animations with stagger effect)",
|
||||
"uniformGridCustomHeightClasses?": "string",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"useInvertedBackground": "boolean",
|
||||
"ariaLabel?": "string (default: 'Feature section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxTitleImageWrapperClassName?": "string - For styling image wrapper in inline-image layout",
|
||||
"textBoxTitleImageClassName?": "string - For styling images in inline-image layout",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"cardDescriptionClassName?": "string",
|
||||
"gridClassName?": "string",
|
||||
"carouselClassName?": "string",
|
||||
"controlsClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string",
|
||||
"itemContentClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureCardThree features={[{ title: 'Analytics', description: 'Track performance with detailed insights', imageSrc: '/feature.jpg' }]} title=\"Our Features\" description=\"Discover what makes us different\" textboxLayout=\"default\" animationType=\"slide-up\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Requires features[]",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
119
registry/components/FeatureCardTwelve.json
Normal file
119
registry/components/FeatureCardTwelve.json
Normal file
@@ -0,0 +1,119 @@
|
||||
{
|
||||
"name": "FeatureCardTwelve",
|
||||
"description": "List-based feature section with large label on left and content with bullet points on right.",
|
||||
"details": "Use for feature comparisons, tier showcases, or service level displays. Uses CardList with variant system for card or border layouts. Layout: Optional TextBox Header → Vertical Stack of Features. Each feature card has horizontal split (md breakpoint): Left side (50%): Large label text (5xl mobile / 6xl desktop). Right side (50%): Title + inline bullet list with accent-colored dots (•) + optional buttons (0-2). Card variant: Items wrapped in cards with full padding (p-6 md:p-15) and mobile divider line. Border variant: Items separated by accent divider lines with bottom padding (pb-6 md:pb-10), no mobile divider. Text colors conditional on variant: border uses useInvertedBackground directly, card uses shouldUseLightText. Supports 0-2 buttons per feature with automatic primary/secondary styling via getButtonProps. Best for pricing tiers, service levels, or feature breakdowns with clear labeling.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Choose Your Plan",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Find the perfect fit for your needs",
|
||||
"minChars": 5,
|
||||
"maxChars": 300
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Plans",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"featureRules": {
|
||||
"id": {
|
||||
"required": true,
|
||||
"example": "premium",
|
||||
"note": "Unique identifier for the feature"
|
||||
},
|
||||
"label": {
|
||||
"required": true,
|
||||
"example": "Premium",
|
||||
"minChars": 2,
|
||||
"maxChars": 30,
|
||||
"note": "Large display label shown on left side (5xl mobile, 6xl desktop)"
|
||||
},
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Premium features for your most demanding needs",
|
||||
"minChars": 10,
|
||||
"maxChars": 120,
|
||||
"note": "Feature heading shown at xl (mobile) / 3xl (desktop)"
|
||||
},
|
||||
"items": {
|
||||
"required": true,
|
||||
"minItems": 1,
|
||||
"maxItems": 8,
|
||||
"structure": "string[]",
|
||||
"note": "Inline bullet list with accent-colored dots. Each item should be 5-50 characters."
|
||||
},
|
||||
"buttons": {
|
||||
"required": false,
|
||||
"maxButtons": 2,
|
||||
"structure": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"note": "Optional buttons at bottom of content area. First button is primary, second is secondary."
|
||||
}
|
||||
},
|
||||
"itemRules": {
|
||||
"minItems": 1,
|
||||
"maxItems": 8,
|
||||
"recommendedItems": "2-5",
|
||||
"note": "Works best with 2-5 features for clear comparison"
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"features": "Array<{ id: string, label: string, title: string, items: string[], buttons?: Array<{text: string, onClick?: () => void, href?: string}> }>",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal' (required)",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"useInvertedBackground": "boolean",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"ariaLabel?": "string (default: 'Feature section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string",
|
||||
"titleImageWrapperClassName?": "string - For styling image wrapper in inline-image layout",
|
||||
"titleImageClassName?": "string - For styling images in inline-image layout",
|
||||
"cardContentClassName?": "string",
|
||||
"labelClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"itemsContainerClassName?": "string",
|
||||
"itemTextClassName?": "string",
|
||||
"cardButtonClassName?": "string",
|
||||
"cardButtonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureCardTwelve features={[{ id: 'premium', label: 'Premium', title: 'Premium features for your most demanding needs and growth goals', items: ['Priority support', 'Advanced features', 'Custom integrations'], buttons: [{ text: 'Learn more', href: '#' }, { text: 'Get started', onClick: () => console.log('clicked') }] }]} animationType=\"opacity\" variant=\"border\" title=\"Choose Your Plan\" description=\"Find the perfect fit for your needs\" textboxLayout=\"default\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Use for pricing pages",
|
||||
"Use for subscription tiers",
|
||||
"Requires features[]",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use more than 8 items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
130
registry/components/FeatureCardTwentyEight.json
Normal file
130
registry/components/FeatureCardTwentyEight.json
Normal file
@@ -0,0 +1,130 @@
|
||||
{
|
||||
"name": "FeatureCardTwentyEight",
|
||||
"description": "Job listing style feature cards with title, subtitle, category indicator, value, and optional footer buttons.",
|
||||
"details": "Use for job listings, pricing tiers, or any feature display with detailed information. Layout: Title (job title/name) → Subtitle (location/details) → Bottom row with category indicator (dot + label, truncates) on left and value (salary/price) on right → Optional footer with accent background containing up to 2 buttons. Uses CardStack with hardcoded uniform-all-items-equal grid and carousel threshold of 4 (switches to carousel with 4+ items). Supports card or default container styles with inverted text logic.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Open Positions",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Join our team and help shape the future of AI",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Careers",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"featureRules": {
|
||||
"id": {
|
||||
"required": true,
|
||||
"example": "1",
|
||||
"minChars": 1,
|
||||
"maxChars": 20
|
||||
},
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Senior Software Engineer, Platform",
|
||||
"minChars": 5,
|
||||
"maxChars": 80,
|
||||
"note": "Main title displayed at top of card, truncates if too long"
|
||||
},
|
||||
"subtitle": {
|
||||
"required": true,
|
||||
"example": "San Francisco, CA · Full-time · Remote eligible",
|
||||
"minChars": 5,
|
||||
"maxChars": 100,
|
||||
"note": "Secondary info like location, type, or details"
|
||||
},
|
||||
"category": {
|
||||
"required": true,
|
||||
"example": "Engineering",
|
||||
"minChars": 2,
|
||||
"maxChars": 30,
|
||||
"note": "Category label with dot indicator, truncates on overflow"
|
||||
},
|
||||
"value": {
|
||||
"required": true,
|
||||
"example": "$185K – $265K",
|
||||
"minChars": 1,
|
||||
"maxChars": 25,
|
||||
"note": "Value displayed on bottom right (salary, price, etc.)"
|
||||
},
|
||||
"buttons": {
|
||||
"required": false,
|
||||
"maxItems": 2,
|
||||
"note": "Optional buttons in footer section with accent background"
|
||||
}
|
||||
},
|
||||
"itemRules": {
|
||||
"minItems": 1,
|
||||
"maxItems": 12,
|
||||
"recommendedItems": "3-6"
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"features": "Array<{ id: string, title: string, subtitle: string, category: string, value: string, buttons?: Array<{text: string, onClick?: () => void, href?: string}> }>",
|
||||
"carouselMode?": "'auto' | 'buttons' (default: 'buttons')",
|
||||
"uniformGridCustomHeightClasses?": "string",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal'",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image'",
|
||||
"useInvertedBackground": "boolean",
|
||||
"ariaLabel?": "string (default: 'Features section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxTitleImageWrapperClassName?": "string",
|
||||
"textBoxTitleImageClassName?": "string",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"subtitleClassName?": "string",
|
||||
"categoryClassName?": "string",
|
||||
"valueClassName?": "string",
|
||||
"footerClassName?": "string",
|
||||
"cardButtonClassName?": "string",
|
||||
"cardButtonTextClassName?": "string",
|
||||
"gridClassName?": "string",
|
||||
"carouselClassName?": "string",
|
||||
"controlsClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureCardTwentyEight features={[{ id: '1', title: 'Senior Software Engineer, Platform', subtitle: 'San Francisco, CA · Full-time · Remote eligible', category: 'Engineering', value: '$185K – $265K', buttons: [{ text: 'Apply Now', href: '#' }] }, { id: '2', title: 'Product Designer, Enterprise', subtitle: 'New York, NY · Full-time', category: 'Design', value: '$145K – $195K', buttons: [{ text: 'Apply Now', href: '#' }] }, { id: '3', title: 'Data Scientist, ML Platform', subtitle: 'Remote · Full-time', category: 'Data Science', value: '$168K – $238K', buttons: [{ text: 'Apply Now', href: '#' }] }]} title=\"Open Positions\" description=\"Join our team and help shape the future of AI\" textboxLayout=\"default\" useInvertedBackground={false} animationType=\"slide-up\" />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Use for pricing pages",
|
||||
"Use for subscription tiers",
|
||||
"Requires features[]",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use more than 12 items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
97
registry/components/FeatureCardTwentyFive.json
Normal file
97
registry/components/FeatureCardTwentyFive.json
Normal file
@@ -0,0 +1,97 @@
|
||||
{
|
||||
"name": "FeatureCardTwentyFive",
|
||||
"description": "Two-column grid feature cards with icon, title, description, and dual media items per card.",
|
||||
"details": "Use for showcasing services or features with visual emphasis. Each card displays an icon in a primary button style box, title, description, and two side-by-side images/videos at the bottom. Uses fixed 'two-items-per-row' grid layout on desktop (2 cards per row), button carousel on mobile. Cards have flexible height with images filling remaining space.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Our Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Discover what makes us different",
|
||||
"minChars": 5,
|
||||
"maxChars": 300
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Services",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"featureRules": {
|
||||
"minItems": 2,
|
||||
"maxItems": 8,
|
||||
"recommendedItems": "4",
|
||||
"structure": {
|
||||
"title": "string - Feature card title (required)",
|
||||
"description": "string - Feature card description (required)",
|
||||
"icon": "LucideIcon - Icon displayed in primary button box (required)",
|
||||
"mediaItems": "[MediaItem, MediaItem] - Tuple of exactly 2 media items (required)"
|
||||
},
|
||||
"mediaItemStructure": {
|
||||
"imageSrc": "string - Path to image (optional if videoSrc provided) Image is recommended if no videoSrc.",
|
||||
"videoSrc": "string - Path to video (optional if imageSrc provided)",
|
||||
"imageAlt": "string - Alt text for image",
|
||||
"videoAriaLabel": "string - Aria label for video"
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"features": "Array<{ title: string, description: string, icon: LucideIcon, mediaItems: [MediaItem, MediaItem] }> - Feature cards with dual media",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal' | 'depth-3d' (required)",
|
||||
"title": "string (required)",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string (required)",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required)",
|
||||
"useInvertedBackground": "boolean (required)",
|
||||
"carouselMode?": "'auto' | 'buttons' (default: 'buttons')",
|
||||
"uniformGridCustomHeightClasses?": "string",
|
||||
"ariaLabel?": "string (default: 'Feature section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"mediaClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxTitleImageWrapperClassName?": "string",
|
||||
"textBoxTitleImageClassName?": "string",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"cardDescriptionClassName?": "string",
|
||||
"cardIconClassName?": "string",
|
||||
"cardIconWrapperClassName?": "string",
|
||||
"gridClassName?": "string",
|
||||
"carouselClassName?": "string",
|
||||
"controlsClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureCardTwentyFive features={[{ title: 'Business Strategy', description: 'Crafting clear strategies for growth.', icon: Target, mediaItems: [{ imageSrc: '/img1.jpg', imageAlt: 'Strategy 1' }, { imageSrc: '/img2.jpg', imageAlt: 'Strategy 2' }] }]} animationType=\"depth-3d\" title=\"Our Features\" description=\"Discover what makes us different\" textboxLayout=\"default\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for features with visual examples",
|
||||
"Each feature requires exactly 2 media items",
|
||||
"Use relevant icons for each feature",
|
||||
"Supports 3D animations"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use without 2 media items per feature",
|
||||
"Do not use without icons"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
84
registry/components/FeatureCardTwentyFour.json
Normal file
84
registry/components/FeatureCardTwentyFour.json
Normal file
@@ -0,0 +1,84 @@
|
||||
{
|
||||
"name": "FeatureCardTwentyFour",
|
||||
"description": "Two-column feature card list with title, author, description, tags, and media.",
|
||||
"details": "Use for feature articles, case studies, or content with author attribution. Uses CardList component with card or border variants. Layout: CardStackTextBox header → Vertical list of items. Each card uses 10-column grid on desktop (6/10 text, 4/10 media). Text area includes title with inline author (lighter opacity), tags using Tag components, and description. Media on right side. Text colors adapt based on variant and useInvertedBackground settings. Best for featured content, case studies, or highlighted features.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Latest Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Stay updated with our latest announcements",
|
||||
"minChars": 5,
|
||||
"maxChars": 300
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"itemRules": {
|
||||
"minItems": 1,
|
||||
"maxItems": 10,
|
||||
"recommendedItems": "2-4",
|
||||
"note": "Each feature requires id, title, author, description, tags array. Media uses discriminated union: either imageSrc (with optional imageAlt) OR videoSrc (with optional videoAriaLabel)."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"features": "Array<{ id: string, title: string, author: string, description: string, tags: string[], imageSrc?: string, imageAlt?: string, videoSrc?: string, videoAriaLabel?: string, onFeatureClick?: () => void }> - Feature card items (requires imageSrc or videoSrc)",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal' (required)",
|
||||
"title": "string (required)",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string (required)",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required)",
|
||||
"useInvertedBackground": "boolean (required)",
|
||||
"ariaLabel?": "string (default: 'Features section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string",
|
||||
"titleImageWrapperClassName?": "string",
|
||||
"titleImageClassName?": "string",
|
||||
"cardContentClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"authorClassName?": "string",
|
||||
"cardDescriptionClassName?": "string",
|
||||
"tagsContainerClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"mediaClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureCardTwentyFour features={[{ id: '1', title: 'New Genre Featured in Fonts in Use', author: 'Leon Brown', description: 'We have been featured in Fonts in Use for our typography choices.', tags: ['Feature', 'Design'], imageSrc: '/feature1.jpg' }]} animationType=\"slide-up\" title=\"Latest Features\" description=\"Stay updated with our latest announcements\" textboxLayout=\"default\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for feature articles, case studies, or content with author attribution",
|
||||
"Best for 2-4 featured items",
|
||||
"Include relevant tags for each feature",
|
||||
"Use high-quality images or videos"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use without author attribution",
|
||||
"Do not use for simple feature lists without descriptions"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
114
registry/components/FeatureCardTwentyNine.json
Normal file
114
registry/components/FeatureCardTwentyNine.json
Normal file
@@ -0,0 +1,114 @@
|
||||
{
|
||||
"name": "FeatureCardTwentyNine",
|
||||
"description": "Adaptive feature section with hover-reveal cards displaying features with title icons, verified badges, and action buttons.",
|
||||
"details": "Use for interactive feature showcases with hover effects. Each card displays a title icon, title with verified badge, image background, and description that reveals with a slide-up background animation. Each card has an action button in the top-right corner. Automatically switches between grid (1-4 items) and carousel (5+ items). Carousel offers auto-scroll or button controls (recommended: keep default buttons for better UX). Optional header with title, description, tag, and buttons. Header supports centered or split textbox layout.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Our Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 35
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Discover what makes us different",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"featureCardRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Advanced Analytics",
|
||||
"minChars": 2,
|
||||
"maxChars": 35
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Get detailed insights into your business performance",
|
||||
"minChars": 10,
|
||||
"maxChars": 250
|
||||
},
|
||||
"buttonText": {
|
||||
"required": true,
|
||||
"example": "Learn More",
|
||||
"minChars": 2,
|
||||
"maxChars": 20
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"imageSrc": {
|
||||
"required": true,
|
||||
"example": "/feature.jpg",
|
||||
"note": "Supports external URLs with unoptimized prop"
|
||||
},
|
||||
"imageAlt": {
|
||||
"required": false,
|
||||
"example": "Feature background",
|
||||
"note": "Empty string marks image as decorative (aria-hidden)"
|
||||
},
|
||||
"titleIconSrc": {
|
||||
"required": true,
|
||||
"example": "/icon.jpg",
|
||||
"note": "Icon displayed next to the title"
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"features": "Array<{ title: string, description: string, imageSrc: string, imageAlt?: string, titleIconSrc: string, buttonText: string, buttonHref?: string }>",
|
||||
"carouselMode?": "'auto' | 'buttons' (default: 'buttons')",
|
||||
"gridVariant": "'uniform-all-items-equal' | 'bento-grid' | 'bento-grid-inverted' | 'two-columns-alternating-heights' | 'asymmetric-60-wide-40-narrow' | 'three-columns-all-equal-width' | 'four-items-2x2-equal-grid' | 'one-large-right-three-stacked-left' | 'items-top-row-full-width-bottom' | 'full-width-top-items-bottom-row' | 'one-large-left-three-stacked-right' (required)",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal' (required - controls GSAP scroll animations with stagger effect)",
|
||||
"uniformGridCustomHeightClasses?": "string",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"useInvertedBackground": "boolean",
|
||||
"ariaLabel?": "string (default: 'Feature section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxTitleImageWrapperClassName?": "string - For styling image wrapper in inline-image layout",
|
||||
"textBoxTitleImageClassName?": "string - For styling images in inline-image layout",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"cardDescriptionClassName?": "string",
|
||||
"gridClassName?": "string",
|
||||
"carouselClassName?": "string",
|
||||
"controlsClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string",
|
||||
"itemContentClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureCardTwentyNine features={[{ title: 'Analytics', description: 'Track performance with detailed insights', imageSrc: '/feature.jpg', titleIconSrc: '/icon.jpg', buttonText: 'Learn More', buttonHref: 'analytics' }]} title=\"Our Features\" description=\"Discover what makes us different\" textboxLayout=\"default\" gridVariant=\"uniform-all-items-equal\" animationType=\"slide-up\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for feature showcases with action buttons",
|
||||
"Use for capability displays with brand icons",
|
||||
"Requires features[]",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
109
registry/components/FeatureCardTwentyOne.json
Normal file
109
registry/components/FeatureCardTwentyOne.json
Normal file
@@ -0,0 +1,109 @@
|
||||
{
|
||||
"name": "FeatureCardTwentyOne",
|
||||
"description": "Split layout with media on one side and TextBox with accordion items on the other.",
|
||||
"details": "Use for feature sections that need expandable content areas. Layout: 50/50 split with image/video on one side and TextBox + accordion on the other. Media position configurable (left/right). First accordion item open by default. Accordion items have divider lines between them. Mobile: stacked vertically with centered text. Supports inverted backgrounds.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Custom designs",
|
||||
"minChars": 2,
|
||||
"maxChars": 60
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Explore our range of customizable solutions designed to meet your unique needs.",
|
||||
"minChars": 10,
|
||||
"maxChars": 300
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"accordionRules": {
|
||||
"id": {
|
||||
"required": true,
|
||||
"example": "1",
|
||||
"note": "Unique identifier for each accordion item"
|
||||
},
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Inspiration + innovation",
|
||||
"minChars": 2,
|
||||
"maxChars": 60,
|
||||
"note": "Accordion header text"
|
||||
},
|
||||
"content": {
|
||||
"required": true,
|
||||
"example": "From custom colourways to bespoke elements built from the ground up.",
|
||||
"minChars": 10,
|
||||
"maxChars": 500,
|
||||
"note": "Accordion expanded content (supports HTML)"
|
||||
}
|
||||
},
|
||||
"itemRules": {
|
||||
"minItems": 2,
|
||||
"maxItems": 6,
|
||||
"recommendedItems": 3
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"accordionItems": "Array<{ id: string, title: string, content: string }>",
|
||||
"imageSrc?": "string (either imageSrc or videoSrc required)",
|
||||
"imageAlt?": "string",
|
||||
"videoSrc?": "string (either imageSrc or videoSrc required)",
|
||||
"videoAriaLabel?": "string",
|
||||
"mediaAnimation": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"useInvertedBackground": "boolean",
|
||||
"mediaPosition?": "'left' | 'right' (default: 'left')",
|
||||
"ariaLabel?": "string (default: 'Feature section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"mediaClassName?": "string",
|
||||
"contentClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"titleImageWrapperClassName?": "string",
|
||||
"titleImageClassName?": "string",
|
||||
"accordionContainerClassName?": "string",
|
||||
"accordionClassName?": "string",
|
||||
"accordionTitleClassName?": "string",
|
||||
"accordionContentClassName?": "string",
|
||||
"accordionIconContainerClassName?": "string",
|
||||
"accordionIconClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureCardTwentyOne title=\"Custom designs\" description=\"Explore our range of customizable solutions.\" tag=\"Features\" imageSrc=\"/images/feature.webp\" imageAlt=\"Feature showcase\" accordionItems={[{ id: '1', title: 'Inspiration + innovation', content: 'Collaborate with us on custom designs.' }, { id: '2', title: 'Sustainability + us', content: 'Committed to sustainable practices.' }, { id: '3', title: 'Request samples', content: 'Get in touch for samples and pricing.' }]} buttons={[{ text: 'Learn more', href: '#' }]} useInvertedBackground={false} mediaPosition=\"left\" />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]",
|
||||
"Requires accordionItems[]"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use less than 2 items",
|
||||
"Do not use more than 6 items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
87
registry/components/FeatureCardTwentySeven.json
Normal file
87
registry/components/FeatureCardTwentySeven.json
Normal file
@@ -0,0 +1,87 @@
|
||||
{
|
||||
"name": "FeatureCardTwentySeven",
|
||||
"description": "Interactive flip cards with 3D rotation effect. Front shows title, icon, and media; back reveals multiple descriptions.",
|
||||
"details": "Use for interactive feature showcases where users can explore details by clicking. Each card flips 180 degrees on Y-axis with 3D perspective. Front side displays title with Plus icon button and media content (image/video). Back side shows same title with X icon (rotated Plus) and multiple description texts. Uses CardStack for grid/carousel layout. Best for 3-6 items where engagement and exploration is desired.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Our Services",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Discover what makes us different",
|
||||
"minChars": 5,
|
||||
"maxChars": 300
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Services",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"featureRules": {
|
||||
"minItems": 3,
|
||||
"maxItems": 8,
|
||||
"recommendedItems": "4",
|
||||
"structure": {
|
||||
"id": "string - Unique identifier (required)",
|
||||
"title": "string - Card title on both sides (required)",
|
||||
"descriptions": "string[] - Array of descriptions shown on back side (min: 1, recommended: 3, max: 5)",
|
||||
"imageSrc": "string - Path to image (optional if videoSrc provided) Image is recommended if no videoSrc.",
|
||||
"videoSrc": "string - Path to video (optional if imageSrc provided)",
|
||||
"imageAlt": "string - Alt text for image"
|
||||
},
|
||||
"note": "Each feature requires id, title, descriptions array (1-5 items, recommended 3), and media (image or video). Cards flip to reveal descriptions on click."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"features": "Array<{ id: string, title: string, descriptions: string[], imageSrc?: string, videoSrc?: string, imageAlt?: string }>",
|
||||
"animationType": "CardAnimationType (required)",
|
||||
"title": "string (required)",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string (required)",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required)",
|
||||
"useInvertedBackground": "'noInvert' | 'invertDefault' (required)",
|
||||
"ariaLabel?": "string (default: 'Feature section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxTitleImageWrapperClassName?": "string",
|
||||
"textBoxTitleImageClassName?": "string",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"cardDescriptionClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureCardTwentySeven features={[{ id: '1', title: 'Web Development', descriptions: ['Custom websites built with modern technologies', 'Best practices for optimal performance', 'Responsive design for all devices'], imageSrc: '/service1.jpg', imageAlt: 'Web Development' }]} animationType=\"slide-up\" title=\"Our Services\" description=\"Discover what makes us different\" textboxLayout=\"default\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for interactive feature showcases where exploration is desired",
|
||||
"Best for 3-6 items (4 recommended)",
|
||||
"Use high-quality images or videos for the front side",
|
||||
"Keep descriptions concise for back side readability"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use without media for each feature",
|
||||
"Do not use for text-heavy content on front side",
|
||||
"Do not use for more than 8 items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
93
registry/components/FeatureCardTwentySix.json
Normal file
93
registry/components/FeatureCardTwentySix.json
Normal file
@@ -0,0 +1,93 @@
|
||||
{
|
||||
"name": "FeatureCardTwentySix",
|
||||
"description": "Full-bleed media carousel feature cards with bottom text overlay and arrow navigation.",
|
||||
"details": "Use for showcasing features or courses with strong visual media. Each card has full-bleed image/video with a frosted glass gradient overlay at the bottom containing title, description, and an icon button. Uses ArrowCarousel layout with centered alignment, looping, prev/next arrow controls, and mask-fade-x edges. Active item is full opacity and scale, inactive items are reduced.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Featured Courses",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Handpicked by our team to help you start strong",
|
||||
"minChars": 5,
|
||||
"maxChars": 300
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Popular",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"featureRules": {
|
||||
"minItems": 4,
|
||||
"maxItems": 12,
|
||||
"recommendedItems": "6",
|
||||
"note": "MINIMUM 4 ITEMS REQUIRED - carousel needs at least 4 items for proper display",
|
||||
"structure": {
|
||||
"title": "string - Card title displayed over media (required)",
|
||||
"description": "string - Card description displayed over media (required)",
|
||||
"imageSrc": "string - Path to background image (optional if videoSrc provided) Image is recommended if no videoSrc.",
|
||||
"videoSrc": "string - Path to background video (optional if imageSrc provided)",
|
||||
"imageAlt": "string - Alt text for background image",
|
||||
"videoAriaLabel": "string - Aria label for background video",
|
||||
"buttonIcon": "LucideIcon - Icon inside the card action button (required)",
|
||||
"buttonHref": "string - Navigation target for button (optional)",
|
||||
"buttonOnClick": "() => void - Click handler for button (optional)"
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"features": "Array<{ title: string, description: string, imageSrc?: string, videoSrc?: string, imageAlt?: string, videoAriaLabel?: string, buttonIcon: LucideIcon, buttonHref?: string, buttonOnClick?: () => void }> (MINIMUM 4 ITEMS REQUIRED)",
|
||||
"title": "string (required)",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string (required)",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'inline-image' (required)",
|
||||
"useInvertedBackground": "boolean (required)",
|
||||
"ariaLabel?": "string (default: 'Feature section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"carouselClassName?": "string",
|
||||
"controlsClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxTitleImageWrapperClassName?": "string",
|
||||
"textBoxTitleImageClassName?": "string",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"cardDescriptionClassName?": "string",
|
||||
"cardButtonClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureCardTwentySix features={[{ title: 'UX Design Fundamentals', description: 'Learn user-centered design from scratch', imageSrc: '/course1.jpg', imageAlt: 'UX Design course', buttonIcon: ArrowRight, buttonHref: '#courses' }]} title=\"Featured Courses\" description=\"Handpicked by our team\" textboxLayout=\"default\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for showcasing features or courses with strong visual media",
|
||||
"Best for 4-12 items (6 recommended)",
|
||||
"Use high-quality images or videos for full-bleed display",
|
||||
"Each card requires a buttonIcon for the action button"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use with fewer than 4 items - carousel requires minimum 4 items",
|
||||
"Do not use without media for each feature",
|
||||
"Do not use without buttonIcon",
|
||||
"Do not use for text-heavy content"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
123
registry/components/FeatureCardTwentyThree.json
Normal file
123
registry/components/FeatureCardTwentyThree.json
Normal file
@@ -0,0 +1,123 @@
|
||||
{
|
||||
"name": "FeatureCardTwentyThree",
|
||||
"description": "Feature section with separate media and card layout, featuring tags and arrow navigation.",
|
||||
"details": "Use for feature listings with prominent imagery. Layout: CardStackTextBox header → Grid of feature items. Each item has separate media (aspect-square) above a card containing title, tags row, and arrow icon. Media and card are visually distinct with gap-6 spacing. Tags use the Tag component and arrow rotates -45deg on hover. Best for visual-focused feature listings with clean separation between imagery and content.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Our Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Stay updated with the latest trends and insights",
|
||||
"minChars": 5,
|
||||
"maxChars": 300
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"featureRules": {
|
||||
"id": {
|
||||
"required": true,
|
||||
"example": "1",
|
||||
"note": "Unique identifier for the feature item"
|
||||
},
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Discover the essential features of our app",
|
||||
"minChars": 10,
|
||||
"maxChars": 100
|
||||
},
|
||||
"tags": {
|
||||
"required": true,
|
||||
"minItems": 1,
|
||||
"maxItems": 4,
|
||||
"structure": "string[]",
|
||||
"example": "['Features', 'Jan 29, 2025']",
|
||||
"note": "Array of tag strings displayed using Tag component"
|
||||
},
|
||||
"imageSrc": {
|
||||
"required": false,
|
||||
"example": "/feature-1.jpg",
|
||||
"note": "Either imageSrc or videoSrc should be provided Either imageSrc or videoSrc should be provided. Image is recommended if no videoSrc."
|
||||
},
|
||||
"videoSrc": {
|
||||
"required": false,
|
||||
"example": "/feature-1.mp4",
|
||||
"note": "Either imageSrc or videoSrc should be provided"
|
||||
},
|
||||
"imageAlt": {
|
||||
"required": false,
|
||||
"example": "Feature preview image",
|
||||
"note": "Falls back to feature title if not provided"
|
||||
},
|
||||
"videoAriaLabel": {
|
||||
"required": false,
|
||||
"example": "Feature video",
|
||||
"note": "Falls back to feature title if not provided"
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"features": "Array<{ id: string, title: string, tags: string[], imageSrc?: string, videoSrc?: string, imageAlt?: string, videoAriaLabel?: string, onFeatureClick?: () => void }>",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal' (required)",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required)",
|
||||
"useInvertedBackground": "boolean",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"carouselMode?": "'auto' | 'buttons' (default: 'buttons')",
|
||||
"uniformGridCustomHeightClasses?": "string",
|
||||
"ariaLabel?": "string (default: 'Features section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"itemClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"mediaClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"tagsContainerClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"arrowClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxTitleImageWrapperClassName?": "string",
|
||||
"textBoxTitleImageClassName?": "string",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"gridClassName?": "string",
|
||||
"carouselClassName?": "string",
|
||||
"controlsClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureCardTwentyThree features={[{ id: '1', title: 'Discover the essential features of our app', tags: ['Features', 'Jan 29, 2025'], imageSrc: '/feature1.jpg' }, { id: '2', title: 'How to organize your tasks effectively', tags: ['Guides', 'Feb 03, 2025'], imageSrc: '/feature2.jpg' }]} animationType=\"slide-up\" title=\"Our Features\" description=\"Stay updated with the latest trends and insights\" textboxLayout=\"default\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for visual-focused feature listings",
|
||||
"Include 1-4 tags per feature",
|
||||
"Use high-quality square images",
|
||||
"Best for feature showcases with clean separation between imagery and content"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use without tags",
|
||||
"Do not use for text-heavy features"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
107
registry/components/FeatureHoverPattern.json
Normal file
107
registry/components/FeatureHoverPattern.json
Normal file
@@ -0,0 +1,107 @@
|
||||
{
|
||||
"name": "FeatureHoverPattern",
|
||||
"description": "CardStack feature section with interactive hover pattern effect revealing behind centered icons.",
|
||||
"details": "Use for feature showcases with visual engagement through hover interactions. Uses CardStack with uniform-all-items-equal grid (hardcoded). Each card displays a centered icon in a container with hover-triggered pattern reveal using GSAP ScrollTrigger. Pattern appears on mouse movement (desktop) or scroll viewport visibility (mobile). Desktop: Mouse movement reveals radial gradient pattern with random character overlay. Mobile: Pattern activates when card enters viewport (20% threshold for pattern, 40% for icon). Each card has icon in center with card styling, title and description below. Icon containers have backdrop-blur-sm with border. Pattern uses Framer Motion with useMotionValue for smooth tracking. Supports custom gradient colors via gradientClassName. All cards have min-h-80 2xl:min-h-90 default height. Best for 2-6 features to showcase key product benefits with interactive visual appeal.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Powerful Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 35
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Hover over each card to reveal the interactive pattern",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"featureCardRules": {
|
||||
"icon": {
|
||||
"required": true,
|
||||
"example": "Zap",
|
||||
"note": "LucideIcon component displayed in center of card with hover pattern"
|
||||
},
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Lightning Fast",
|
||||
"minChars": 2,
|
||||
"maxChars": 40
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Optimized for performance with minimal overhead and blazing fast load times",
|
||||
"minChars": 10,
|
||||
"maxChars": 200
|
||||
}
|
||||
},
|
||||
"itemRules": {
|
||||
"minItems": 2,
|
||||
"maxItems": 6,
|
||||
"recommendedItems": "2-6",
|
||||
"note": "Works best with 2-6 features for optimal grid layout"
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"features": "Array<{ icon: LucideIcon, title: string, description: string, button?: ButtonConfig }> (required)",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal' (required)",
|
||||
"title": "string (required)",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string (required)",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"useInvertedBackground": "boolean (required)",
|
||||
"carouselMode?": "'auto' | 'buttons' (default: 'buttons' - for 5+ items)",
|
||||
"uniformGridCustomHeightClasses?": "string (default: 'min-h-80 2xl:min-h-90')",
|
||||
"ariaLabel?": "string (default: 'Feature section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"iconContainerClassName?": "string",
|
||||
"iconClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string",
|
||||
"titleImageWrapperClassName?": "string",
|
||||
"titleImageClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"cardDescriptionClassName?": "string",
|
||||
"gradientClassName?": "string - Custom gradient for hover pattern (default: 'bg-gradient-to-r from-accent to-background-accent')",
|
||||
"gridClassName?": "string",
|
||||
"carouselClassName?": "string",
|
||||
"controlsClassName?": "string",
|
||||
"cardButtonClassName?": "string",
|
||||
"cardButtonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureHoverPattern features={[{ icon: Zap, title: 'Lightning Fast', description: 'Optimized for performance with minimal overhead' }, { icon: Shield, title: 'Secure by Default', description: 'Built with security best practices' }]} title=\"Powerful Features\" description=\"Hover over each card to reveal the interactive pattern\" textboxLayout=\"default\" animationType=\"slide-up\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for feature showcases with visual engagement",
|
||||
"Best for 2-6 features",
|
||||
"Each feature requires an icon",
|
||||
"Supports custom gradient colors via gradientClassName"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use without icons for each feature",
|
||||
"Do not use for simple text-only feature lists"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
111
registry/components/FeatureTimelineBento.json
Normal file
111
registry/components/FeatureTimelineBento.json
Normal file
@@ -0,0 +1,111 @@
|
||||
{
|
||||
"name": "FeatureTimelineBento",
|
||||
"description": "Timeline-based feature section with scroll-triggered stacking animations and bento component visualizations instead of images.",
|
||||
"details": "Use for process flows, roadmaps, or sequential feature presentations with interactive visualizations. Each card displays a numbered step badge, title, description, and a bento component visualization in a two-column layout. As you scroll, cards stack on top of each other with fade animations. The timeline layout provides a clear visual progression through steps or stages. Supports 15 bento types: globe, icon-info-cards, animated-bar-chart, 3d-stack-cards, 3d-task-list, orbiting-icons, map, marquee, line-chart, 3d-card-grid, phone, chat, reveal-icon, timeline, media-stack. No grid/carousel modes - uses fixed timeline stacking layout with GSAP ScrollTrigger. Optional header with title, description, tag, and buttons. Header supports centered or split textbox layout.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Our Process",
|
||||
"minChars": 2,
|
||||
"maxChars": 35
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Discover how we bring ideas to life",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Process",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"featureCardRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Research & Planning",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Understanding user needs, market trends, and project requirements",
|
||||
"minChars": 10,
|
||||
"maxChars": 300
|
||||
}
|
||||
},
|
||||
"bentoComponentRules": {
|
||||
"note": "CRITICAL: Each feature MUST use a DIFFERENT bentoComponent type. Never repeat the same type across features (e.g., don't use 'timeline' twice). Requirements vary by type:",
|
||||
"types": {
|
||||
"globe": "{ bentoComponent: 'globe' } - No additional fields required",
|
||||
"animated-bar-chart": "{ bentoComponent: 'animated-bar-chart' } - No additional fields required",
|
||||
"map": "{ bentoComponent: 'map' } - No additional fields required",
|
||||
"line-chart": "{ bentoComponent: 'line-chart' } - No additional fields required",
|
||||
"icon-info-cards": "{ bentoComponent: 'icon-info-cards', items: Array<{ icon: LucideIcon, label: string, value: string }> } - Requires items array",
|
||||
"3d-stack-cards": "{ bentoComponent: '3d-stack-cards', items: [Bento3DItem, Bento3DItem, Bento3DItem] } - Requires exactly 3 items. Each item: { icon: LucideIcon, title: string, subtitle: string, detail: string }",
|
||||
"3d-task-list": "{ bentoComponent: '3d-task-list', bentoTitle: string, items: Array<{ icon: LucideIcon, label: string, time: string }> } - Requires bentoTitle (not title) and items array",
|
||||
"orbiting-icons": "{ bentoComponent: 'orbiting-icons', centerIcon: LucideIcon, items: Array<{ icon: LucideIcon, ring?: 1 | 2 | 3, duration?: number }> } - Requires centerIcon and items array",
|
||||
"marquee": "{ bentoComponent: 'marquee', centerIcon: LucideIcon, variant: 'text' | 'icon', texts?: string[], icons?: LucideIcon[] } - Requires centerIcon and variant",
|
||||
"phone": "{ bentoComponent: 'phone', statusIcon: LucideIcon, alertIcon: LucideIcon, alertTitle: string, alertMessage: string, apps: PhoneApps8 } - Requires all fields",
|
||||
"chat": "{ bentoComponent: 'chat', aiIcon: LucideIcon, userIcon: LucideIcon, exchanges: Array<{ userMessage: string, aiResponse: string }>, placeholder: string } - Requires all fields",
|
||||
"3d-card-grid": "{ bentoComponent: '3d-card-grid', items: [GridCardItem x4], centerIcon: LucideIcon } - Requires exactly 4 items and centerIcon",
|
||||
"reveal-icon": "{ bentoComponent: 'reveal-icon', icon: LucideIcon } - Requires icon",
|
||||
"timeline": "{ bentoComponent: 'timeline', heading: string, subheading: string, items: [TimelineItem x3], completedLabel: string } - Requires exactly 3 items",
|
||||
"media-stack": "{ bentoComponent: 'media-stack', items: [MediaStackItem x3] } - Requires exactly 3 items"
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"features": "Array<{ title: string, description: string, buttons?: ButtonConfig[] } & BentoComponentVariant> - Each card has title, description, optional buttons, and one bentoComponent type with its required props",
|
||||
"title": "string (required)",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string (required)",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required)",
|
||||
"useInvertedBackground": "boolean (required)",
|
||||
"ariaLabel?": "string (default: 'Feature section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string",
|
||||
"titleImageWrapperClassName?": "string",
|
||||
"titleImageClassName?": "string",
|
||||
"cardContentClassName?": "string",
|
||||
"stepNumberClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"cardDescriptionClassName?": "string",
|
||||
"bentoContainerClassName?": "string",
|
||||
"cardButtonClassName?": "string",
|
||||
"cardButtonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FeatureTimelineBento features={[{ title: 'Global Analytics', description: 'Track performance worldwide', bentoComponent: 'globe' }, { title: 'Team Metrics', description: 'Monitor team performance', bentoComponent: 'icon-info-cards', items: [{icon: Users, label: 'Active', value: '1,234'}] }]} title=\"Our Process\" description=\"See how it works\" textboxLayout=\"default\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for process flows with interactive visualizations",
|
||||
"Use for roadmaps with rich content",
|
||||
"Use for step-by-step explanations with visual aids",
|
||||
"Use appropriate bentoComponent for each step",
|
||||
"Requires features[]"
|
||||
],
|
||||
"dont": [
|
||||
"CRITICAL: NEVER use the same bentoComponent type for multiple features - each feature MUST have a unique/different bento type (e.g., if one uses 'timeline', others must use 'reveal-icon', 'chat', 'globe', etc.)",
|
||||
"Do not use for non-sequential content",
|
||||
"Do not use with single item"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
20
registry/components/FloatingGradientBackground.json
Normal file
20
registry/components/FloatingGradientBackground.json
Normal file
@@ -0,0 +1,20 @@
|
||||
{
|
||||
"name": "FloatingGradientBackground",
|
||||
"description": "Five animated gradient circles with CSS animations and vertical gradient mask.",
|
||||
"details": "Use for dynamic, engaging backgrounds with subtle motion. Features 5 circles with different animations (moveVertical, moveInCircle, moveHorizontal) using primary-cta and accent colors. Includes 40px blur and linear gradient mask (transparent → visible 20-80% → transparent). Circles have varying opacities (0.1-0.2) and use hard-light blend mode.",
|
||||
"constraints": {},
|
||||
"propsSchema": {
|
||||
"className?": "string"
|
||||
},
|
||||
"usageExample": "<FloatingGradientBackground />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
20
registry/components/FluidBackground.json
Normal file
20
registry/components/FluidBackground.json
Normal file
@@ -0,0 +1,20 @@
|
||||
{
|
||||
"name": "FluidBackground",
|
||||
"description": "Generative fluid patterns using CPPN shader with theme color integration.",
|
||||
"details": "Use for modern, dynamic backgrounds with organic fluid patterns. Features real-time WebGL shader animation using CPPN (Compositional Pattern Producing Networks) that creates continuously morphing, fluid-like patterns. Automatically adapts to theme colors by reading CSS variables (--background, --color-primary-cta, --color-accent, --color-secondary-cta) and blending them with generated patterns. Uses React Three Fiber for 3D rendering with dynamic viewport sizing. Performance optimized with React.memo and responsive to window resizing. Best for contemporary, premium designs where subtle motion adds visual interest without distraction.",
|
||||
"constraints": {},
|
||||
"propsSchema": {
|
||||
"className?": "string"
|
||||
},
|
||||
"usageExample": "<FluidBackground />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
84
registry/components/FooterBase.json
Normal file
84
registry/components/FooterBase.json
Normal file
@@ -0,0 +1,84 @@
|
||||
{
|
||||
"name": "FooterBase",
|
||||
"description": "Classic footer with logo, multi-column navigation, copyright text, and privacy policy link.",
|
||||
"details": "Use for standard website footers with organized navigation. Features logoText as h2 heading on left, flexible column layout for navigation links, copyright text, and privacy policy button. All links use ButtonTextUnderline component. Footer uses primary-button background with text-background color scheme.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"logoText": {
|
||||
"required": true,
|
||||
"example": "Company Name",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
},
|
||||
"copyrightText": {
|
||||
"required": false,
|
||||
"default": "© 2025 | Webild",
|
||||
"example": "© 2025 Company Name",
|
||||
"minChars": 5,
|
||||
"maxChars": 50
|
||||
},
|
||||
"columnTitle": {
|
||||
"required": true,
|
||||
"example": "Product",
|
||||
"minChars": 2,
|
||||
"maxChars": 20
|
||||
},
|
||||
"itemLabel": {
|
||||
"required": true,
|
||||
"example": "Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"structureRules": {
|
||||
"columns": {
|
||||
"required": true,
|
||||
"minColumns": 1,
|
||||
"maxColumns": 3,
|
||||
"note": "Each column must have title and items array"
|
||||
},
|
||||
"items": {
|
||||
"required": true,
|
||||
"minItems": 1,
|
||||
"structure": {
|
||||
"label": "string - Link text (required)",
|
||||
"href": "string - Link destination (optional). External URLs (https://, http://, www.) open in new tab. Internal values (e.g., 'about', 'contact') scroll to #about, #contact sections",
|
||||
"onClick": "() => void - Additional click handler (optional)"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"columns": "Array<{ title: string, items: Array<{ label: string, href: string }> }> - Footer navigation columns (required)",
|
||||
"logoSrc?": "string",
|
||||
"logoAlt?": "string",
|
||||
"logoText": "string (required)",
|
||||
"copyrightText?": "string (default: '© 2025 | Webild')",
|
||||
"onPrivacyClick?": "() => void",
|
||||
"ariaLabel?": "string (default: 'Site footer')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"logoClassName?": "string",
|
||||
"logoImageClassName?": "string",
|
||||
"logoTextClassName?": "string",
|
||||
"columnsClassName?": "string",
|
||||
"columnClassName?": "string",
|
||||
"columnTitleClassName?": "string",
|
||||
"columnItemClassName?": "string",
|
||||
"copyrightContainerClassName?": "string",
|
||||
"copyrightTextClassName?": "string",
|
||||
"privacyButtonClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FooterBase logoText=\"Company Name\" columns={[{ title: 'Product', items: [{ label: 'Features', href: 'features' }, { label: 'Pricing', href: 'pricing' }] }]} copyrightText=\"© 2025 | Company\" onPrivacyClick={() => console.log('Privacy clicked')} />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Requires columns[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
69
registry/components/FooterBaseCard.json
Normal file
69
registry/components/FooterBaseCard.json
Normal file
@@ -0,0 +1,69 @@
|
||||
{
|
||||
"name": "FooterBaseCard",
|
||||
"description": "Card-wrapped footer with logo, navigation columns, copyright, and privacy policy link.",
|
||||
"details": "Use for footers that need comprehensive navigation within a card container. Layout: Section wrapper (py-20) → Card container (w-content-width, rounded-theme-capped, p-10) → Top section (logo + FooterColumns in flex-row) → Border divider (border-t, border-foreground/20) → Bottom section (copyright + privacy button). Logo supports either image (logoSrc with Next.js Image) or text heading (logoText, text-4xl). Navigation organized via FooterColumns component accepting array of column objects with title and items. Bottom section displays copyright text (text-foreground/50, text-sm) on left and privacy policy button (ButtonTextUnderline) on right in flex row. Card wrapper provides unified, elevated appearance compared to FooterBase. Text colors use foreground variants since content is within card element. Best for comprehensive footer navigation with modern card styling. Uses semantic footer tag with contentinfo role.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"copyrightText": {
|
||||
"required": false,
|
||||
"example": "© 2025 | Webild",
|
||||
"minChars": 5,
|
||||
"maxChars": 100,
|
||||
"note": "Copyright text displayed at bottom left"
|
||||
},
|
||||
"logoText": {
|
||||
"required": true,
|
||||
"example": "Webild",
|
||||
"minChars": 2,
|
||||
"maxChars": 30,
|
||||
"note": "Text used for h2 heading"
|
||||
}
|
||||
},
|
||||
"columnsRules": {
|
||||
"required": true,
|
||||
"structure": {
|
||||
"title": "string - Column heading (required)",
|
||||
"items": "Array<{ label: string, href: string }> - Navigation links (required)"
|
||||
},
|
||||
"minColumns": 1,
|
||||
"maxColumns": 5,
|
||||
"note": "Array of footer column objects. Each column must have title and items array."
|
||||
},
|
||||
"logoRules": {
|
||||
"note": "Uses logoText as h2 heading."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"logoSrc?": "string",
|
||||
"logoAlt?": "string",
|
||||
"logoText": "string (required)",
|
||||
"columns": "Array<{ title: string, items: Array<{ label: string, href: string }> }> - Footer navigation columns (required)",
|
||||
"copyrightText?": "string (default: '© 2025 | Webild')",
|
||||
"onPrivacyClick?": "() => void",
|
||||
"ariaLabel?": "string (default: 'Site footer')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"logoClassName?": "string",
|
||||
"logoImageClassName?": "string",
|
||||
"logoTextClassName?": "string",
|
||||
"columnsClassName?": "string",
|
||||
"columnClassName?": "string",
|
||||
"columnTitleClassName?": "string",
|
||||
"columnItemClassName?": "string",
|
||||
"copyrightContainerClassName?": "string",
|
||||
"copyrightTextClassName?": "string",
|
||||
"privacyButtonClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FooterBaseCard columns={[{ title: 'Product', items: [{ label: 'Features', href: '/features' }, { label: 'Pricing', href: '/pricing' }] }, { title: 'Company', items: [{ label: 'About', href: '/about' }, { label: 'Blog', href: '/blog' }] }]} logoText=\"Webild\" copyrightText=\"© 2025 | Webild\" onPrivacyClick={() => console.log('Privacy clicked')} />",
|
||||
"do": [
|
||||
"Use for general use",
|
||||
"Requires columns[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
80
registry/components/FooterBaseReveal.json
Normal file
80
registry/components/FooterBaseReveal.json
Normal file
@@ -0,0 +1,80 @@
|
||||
{
|
||||
"name": "FooterBaseReveal",
|
||||
"description": "Animated footer reveal wrapper that creates a fixed footer with scroll-triggered reveal effect.",
|
||||
"details": "Use when you want the footer to stay fixed at the bottom and reveal as users scroll. Wraps FooterBase component with fixed positioning and dynamic height calculation using ResizeObserver. Creates a reveal animation effect as content scrolls up. Ideal for modern, engaging scroll experiences.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"copyrightText": {
|
||||
"required": false,
|
||||
"default": "© 2025 | Webild",
|
||||
"example": "© 2025 Company Name",
|
||||
"minChars": 5,
|
||||
"maxChars": 50
|
||||
},
|
||||
"columnTitle": {
|
||||
"required": true,
|
||||
"example": "Product",
|
||||
"minChars": 2,
|
||||
"maxChars": 20
|
||||
},
|
||||
"itemLabel": {
|
||||
"required": true,
|
||||
"example": "Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"structureRules": {
|
||||
"columns": {
|
||||
"required": true,
|
||||
"minColumns": 1,
|
||||
"maxColumns": 3,
|
||||
"note": "Each column must have title and items array"
|
||||
},
|
||||
"items": {
|
||||
"required": true,
|
||||
"minItems": 1,
|
||||
"structure": {
|
||||
"label": "string - Link text (required)",
|
||||
"href": "string - Link destination (optional). External URLs open in new tab, internal values scroll to sections",
|
||||
"onClick": "() => void - Additional click handler (optional)"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"logoSrc?": "string",
|
||||
"logoAlt?": "string",
|
||||
"logoText": "string (required)",
|
||||
"columns": "Array<{ title: string, items: Array<{ label: string, href: string }> }> - Footer navigation columns (required)",
|
||||
"copyrightText?": "string",
|
||||
"onPrivacyClick?": "() => void",
|
||||
"ariaLabel?": "string",
|
||||
"className?": "string",
|
||||
"wrapperClassName?": "string",
|
||||
"containerClassName?": "string",
|
||||
"footerClassName?": "string",
|
||||
"footerContainerClassName?": "string",
|
||||
"logoClassName?": "string",
|
||||
"logoImageClassName?": "string",
|
||||
"logoTextClassName?": "string",
|
||||
"columnsClassName?": "string",
|
||||
"columnClassName?": "string",
|
||||
"columnTitleClassName?": "string",
|
||||
"columnItemClassName?": "string",
|
||||
"copyrightContainerClassName?": "string",
|
||||
"copyrightTextClassName?": "string",
|
||||
"privacyButtonClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FooterBaseReveal logoText=\"Company Name\" columns={[{ title: 'Product', items: [{ label: 'Features', href: 'features' }, { label: 'Pricing', href: 'pricing' }] }]} copyrightText=\"© 2025 | Company\" />",
|
||||
"do": [
|
||||
"Use for general use",
|
||||
"Requires columns[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
64
registry/components/FooterCard.json
Normal file
64
registry/components/FooterCard.json
Normal file
@@ -0,0 +1,64 @@
|
||||
{
|
||||
"name": "FooterCard",
|
||||
"description": "Minimalist footer with card wrapper containing logo, divider, copyright, and optional social links.",
|
||||
"details": "Use for simple, clean footer layouts with card styling. Layout: Section wrapper (py-20) → Card container (w-content-width, rounded-theme-capped, px-10) → FooterLogo → Divider line (h-px, bg-accent/20) → Bottom section (copyright text + optional social links). Logo supports either image (logoSrc) or SVG text (logoText via FooterLogo component). Divider uses accent color with 20% opacity. Bottom section displays copyright (text-accent/75, text-sm) on left and optional social icons on right in flex row (mobile: stacks vertically). Social links are conditionally rendered only when provided. All elements contained within card for unified appearance. Best for simple, modern footer designs without extensive navigation. Uses semantic footer tag with contentinfo role.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"copyrightText": {
|
||||
"required": false,
|
||||
"example": "© 2025 | Webild",
|
||||
"minChars": 5,
|
||||
"maxChars": 100,
|
||||
"note": "Copyright text displayed at bottom left"
|
||||
},
|
||||
"logoText": {
|
||||
"required": true,
|
||||
"example": "Webild",
|
||||
"minChars": 2,
|
||||
"maxChars": 30,
|
||||
"note": "Text used for SVG logo"
|
||||
}
|
||||
},
|
||||
"socialLinksRules": {
|
||||
"required": false,
|
||||
"structure": {
|
||||
"icon": "LucideIcon - Icon component (required)",
|
||||
"href": "string - Social profile URL (required)",
|
||||
"ariaLabel": "string - Accessibility label (required)"
|
||||
},
|
||||
"note": "Optional array of social links. Only renders if provided and has length > 0."
|
||||
},
|
||||
"logoRules": {
|
||||
"note": "Uses logoText for SVG text logo via FooterLogo component."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"logoSrc?": "string",
|
||||
"logoAlt?": "string",
|
||||
"logoText": "string (required)",
|
||||
"copyrightText?": "string (default: '© 2025 | Webild')",
|
||||
"socialLinks?": "Array<{ icon: LucideIcon, href: string, ariaLabel: string }> - Social media links",
|
||||
"ariaLabel?": "string (default: 'Site footer')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"logoClassName?": "string",
|
||||
"logoImageClassName?": "string",
|
||||
"dividerClassName?": "string",
|
||||
"copyrightContainerClassName?": "string",
|
||||
"copyrightTextClassName?": "string",
|
||||
"socialContainerClassName?": "string",
|
||||
"socialIconClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FooterCard logoText=\"Webild\" copyrightText=\"© 2025 | Webild\" socialLinks={[{ icon: Twitter, href: 'https://twitter.com/webild', ariaLabel: 'Twitter' }, { icon: Linkedin, href: 'https://linkedin.com/company/webild', ariaLabel: 'LinkedIn' }]} />",
|
||||
"do": [
|
||||
"Use for general use",
|
||||
"Requires socialLinks?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
72
registry/components/FooterLogoEmphasis.json
Normal file
72
registry/components/FooterLogoEmphasis.json
Normal file
@@ -0,0 +1,72 @@
|
||||
{
|
||||
"name": "FooterLogoEmphasis",
|
||||
"description": "Footer with prominent centered logo emphasis and grid-based navigation layout with chevron icons.",
|
||||
"details": "Use when logo branding is primary focus in footer. Features large centered logo at top (image or SVG text), followed by responsive grid of navigation links (1-5 columns max) with ChevronRight icons. Grid columns automatically adjust based on number of column arrays provided. No column titles - just clean link lists. Uses primary-button background with rounded-t-theme-capped styling.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"logoText": {
|
||||
"required": false,
|
||||
"default": "Webild",
|
||||
"example": "Company Name",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
},
|
||||
"itemLabel": {
|
||||
"required": true,
|
||||
"example": "Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"structureRules": {
|
||||
"columns": {
|
||||
"required": true,
|
||||
"minColumns": 1,
|
||||
"maxColumns": 5,
|
||||
"note": "Grid automatically adjusts from 1-5 columns based on array length"
|
||||
},
|
||||
"items": {
|
||||
"required": true,
|
||||
"minItems": 1,
|
||||
"structure": {
|
||||
"label": "string - Link text (required)",
|
||||
"href": "string - Link destination (optional). External URLs open in new tab, internal values scroll to sections",
|
||||
"onClick": "() => void - Additional click handler (optional)"
|
||||
}
|
||||
},
|
||||
"logo": {
|
||||
"note": "Uses logoText for SVG text logo"
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"logoSrc?": "string",
|
||||
"logoAlt?": "string",
|
||||
"columns": "Array<{ items: Array<{ label: string, href?: string, onClick?: () => void }> }> - Footer navigation columns (required, max 5)",
|
||||
"logoText": "string (required)",
|
||||
"ariaLabel?": "string (default: 'Site footer')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"logoClassName?": "string",
|
||||
"logoImageClassName?": "string",
|
||||
"columnsClassName?": "string",
|
||||
"columnClassName?": "string",
|
||||
"itemClassName?": "string",
|
||||
"iconClassName?": "string",
|
||||
"buttonClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FooterLogoEmphasis columns={[{ items: [{ label: 'Features', href: 'features' }] }, { items: [{ label: 'About', href: 'about' }] }]} logoText=\"Company\" />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Requires columns[]"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use more than 4 items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
72
registry/components/FooterLogoEmphasisReveal.json
Normal file
72
registry/components/FooterLogoEmphasisReveal.json
Normal file
@@ -0,0 +1,72 @@
|
||||
{
|
||||
"name": "FooterLogoEmphasisReveal",
|
||||
"description": "Footer with prominent centered logo emphasis that reveals from behind content as user scrolls (sticky reveal effect).",
|
||||
"details": "Use when logo branding is primary focus and you want a sticky reveal effect. Wraps FooterLogoEmphasis with scroll-based reveal animation - footer stays fixed at bottom and reveals as content scrolls past. Features large centered logo at top, followed by responsive grid of navigation links (1-5 columns max) with ChevronRight icons. Grid columns automatically adjust based on number of column arrays provided. No column titles - just clean link lists. Uses primary-button background with rounded-t-theme-capped styling.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"logoText": {
|
||||
"required": true,
|
||||
"example": "Company Name",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
},
|
||||
"itemLabel": {
|
||||
"required": true,
|
||||
"example": "Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"structureRules": {
|
||||
"columns": {
|
||||
"required": true,
|
||||
"minColumns": 1,
|
||||
"maxColumns": 5,
|
||||
"note": "Grid automatically adjusts from 1-5 columns based on array length"
|
||||
},
|
||||
"items": {
|
||||
"required": true,
|
||||
"minItems": 1,
|
||||
"structure": {
|
||||
"label": "string - Link text (required)",
|
||||
"href": "string - Link destination (optional). External URLs open in new tab, internal values scroll to sections",
|
||||
"onClick": "() => void - Additional click handler (optional)"
|
||||
}
|
||||
},
|
||||
"logo": {
|
||||
"note": "Uses logoText for SVG text logo"
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"columns": "Array<{ items: Array<{ label: string, href?: string, onClick?: () => void }> }> - Footer navigation columns (required, max 5)",
|
||||
"logoText": "string (required)",
|
||||
"ariaLabel?": "string (default: 'Site footer')",
|
||||
"className?": "string",
|
||||
"wrapperClassName?": "string",
|
||||
"containerClassName?": "string",
|
||||
"footerClassName?": "string",
|
||||
"footerContainerClassName?": "string",
|
||||
"logoClassName?": "string",
|
||||
"columnsClassName?": "string",
|
||||
"columnClassName?": "string",
|
||||
"itemClassName?": "string",
|
||||
"iconClassName?": "string",
|
||||
"buttonClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FooterLogoEmphasisReveal columns={[{ items: [{ label: 'Features', href: 'features' }] }, { items: [{ label: 'About', href: 'about' }] }]} logoText=\"Company\" />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Use for sticky reveal footer effect",
|
||||
"Requires columns[]"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use more than 5 columns"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
46
registry/components/FooterLogoReveal.json
Normal file
46
registry/components/FooterLogoReveal.json
Normal file
@@ -0,0 +1,46 @@
|
||||
{
|
||||
"name": "FooterLogoReveal",
|
||||
"description": "Minimalist footer with logo that reveals on scroll using fixed positioning and clip-path.",
|
||||
"details": "Use for minimal, logo-only footers with scroll reveal effect. Footer stays fixed at bottom and reveals as user scrolls down the page using clip-path animation. Contains only FooterLogo component (supports image or SVG text logo) centered with card styling. Uses ResizeObserver to dynamically track footer height for proper reveal effect. Best for clean, modern designs where footer should not distract from content. Uses semantic section and footer tags with contentinfo role.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"logoText": {
|
||||
"required": true,
|
||||
"example": "Webild",
|
||||
"minChars": 2,
|
||||
"maxChars": 30,
|
||||
"note": "Text used for SVG logo"
|
||||
}
|
||||
},
|
||||
"logoRules": {
|
||||
"note": "Uses logoText for SVG text logo via FooterLogo component."
|
||||
},
|
||||
"revealEffectRules": {
|
||||
"note": "Component uses fixed positioning and clip-path for scroll reveal effect. Requires page content above footer to trigger scroll. ResizeObserver dynamically updates footer height for responsive reveal."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"logoSrc?": "string",
|
||||
"logoAlt?": "string",
|
||||
"logoText": "string (required)",
|
||||
"leftLink": "{ text: string, onClick?: () => void, href?: string } (required)",
|
||||
"rightLink": "{ text: string, onClick?: () => void, href?: string } (required)",
|
||||
"ariaLabel?": "string (default: 'Site footer')",
|
||||
"className?": "string",
|
||||
"wrapperClassName?": "string",
|
||||
"containerClassName?": "string",
|
||||
"logoClassName?": "string",
|
||||
"logoImageClassName?": "string",
|
||||
"linkClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FooterLogoReveal logoText=\"Webild\" leftLink={{ text: 'Privacy Policy', href: '/privacy' }} rightLink={{ text: 'Terms of Service', href: '/terms' }} />",
|
||||
"do": [
|
||||
"Use for general use"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
102
registry/components/FooterMedia.json
Normal file
102
registry/components/FooterMedia.json
Normal file
@@ -0,0 +1,102 @@
|
||||
{
|
||||
"name": "FooterMedia",
|
||||
"description": "Footer with full-width media (image/video) above classic navigation layout.",
|
||||
"details": "Use for visually impactful footers with media. Features full-width image or video at top with mask-fade-top-long effect (fades from top), followed by standard footer layout: logoText as h2 heading, multi-column navigation, copyright, and privacy policy. Media is required (either imageSrc or videoSrc). Same navigation structure as FooterBase.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"logoText": {
|
||||
"required": true,
|
||||
"example": "Company Name",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
},
|
||||
"copyrightText": {
|
||||
"required": false,
|
||||
"default": "© 2025 | Webild",
|
||||
"example": "© 2025 Company Name",
|
||||
"minChars": 5,
|
||||
"maxChars": 50
|
||||
},
|
||||
"columnTitle": {
|
||||
"required": true,
|
||||
"example": "Product",
|
||||
"minChars": 2,
|
||||
"maxChars": 20
|
||||
},
|
||||
"itemLabel": {
|
||||
"required": true,
|
||||
"example": "Features",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"note": "Either imageSrc or videoSrc is required (discriminated union)",
|
||||
"imageSrc": {
|
||||
"required": "conditional - required if no videoSrc",
|
||||
"example": "https://images.unsplash.com/photo-1497215728101-856f4ea42174?w=1920",
|
||||
"note": "Either imageSrc or videoSrc should be provided. Image is recommended if no videoSrc."
|
||||
},
|
||||
"videoSrc": {
|
||||
"required": "conditional - required if no imageSrc",
|
||||
"example": "/videos/footer-background.mp4"
|
||||
}
|
||||
},
|
||||
"structureRules": {
|
||||
"columns": {
|
||||
"required": true,
|
||||
"minColumns": 1,
|
||||
"maxColumns": 3,
|
||||
"note": "Each column must have title and items array"
|
||||
},
|
||||
"items": {
|
||||
"required": true,
|
||||
"minItems": 1,
|
||||
"structure": {
|
||||
"label": "string - Link text (required)",
|
||||
"href": "string - Link destination (optional)",
|
||||
"onClick": "() => void - Additional click handler (optional)"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"imageSrc": "string (required if no videoSrc)",
|
||||
"imageAlt?": "string (default: '')",
|
||||
"videoSrc": "string (required if no imageSrc)",
|
||||
"videoAriaLabel?": "string (default: 'Footer video')",
|
||||
"logoSrc?": "string",
|
||||
"logoAlt?": "string",
|
||||
"logoText": "string (required)",
|
||||
"columns": "Array<{ title: string, items: Array<{ label: string, href: string }> }> - Footer navigation columns (required)",
|
||||
"copyrightText?": "string (default: '© 2025 | Webild')",
|
||||
"onPrivacyClick?": "() => void",
|
||||
"ariaLabel?": "string (default: 'Site footer')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"mediaClassName?": "string",
|
||||
"logoClassName?": "string",
|
||||
"logoImageClassName?": "string",
|
||||
"logoTextClassName?": "string",
|
||||
"columnsClassName?": "string",
|
||||
"columnClassName?": "string",
|
||||
"columnTitleClassName?": "string",
|
||||
"columnItemClassName?": "string",
|
||||
"copyrightContainerClassName?": "string",
|
||||
"copyrightTextClassName?": "string",
|
||||
"privacyButtonClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FooterMedia logoText=\"Company Name\" imageSrc=\"https://images.unsplash.com/photo-1497215728101-856f4ea42174?w=1920\" columns={[{ title: 'Product', items: [{ label: 'Features', href: 'features' }, { label: 'Pricing', href: 'pricing' }] }]} copyrightText=\"© 2025 | Company\" />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Requires columns[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
78
registry/components/FooterSimple.json
Normal file
78
registry/components/FooterSimple.json
Normal file
@@ -0,0 +1,78 @@
|
||||
{
|
||||
"name": "FooterSimple",
|
||||
"description": "Minimal footer with navigation columns, divider, and bottom text row.",
|
||||
"details": "Use for clean, simple footers without card styling or logo emphasis. Features navigation columns spread across the top, a horizontal divider line, and a bottom row with left and right text (e.g., copyright and credits). No card wrapper, no logo section. Best for minimal designs where footer should be functional but unobtrusive.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"bottomLeftText": {
|
||||
"required": true,
|
||||
"example": "© 2025 Company. All rights reserved.",
|
||||
"minChars": 5,
|
||||
"maxChars": 60
|
||||
},
|
||||
"bottomRightText": {
|
||||
"required": true,
|
||||
"example": "Made with Webild",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"columnTitle": {
|
||||
"required": true,
|
||||
"example": "Navigate",
|
||||
"minChars": 2,
|
||||
"maxChars": 20
|
||||
},
|
||||
"itemLabel": {
|
||||
"required": true,
|
||||
"example": "Home",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"structureRules": {
|
||||
"columns": {
|
||||
"required": true,
|
||||
"minColumns": 2,
|
||||
"maxColumns": 5,
|
||||
"note": "Each column must have title and items array. Columns spread evenly across width."
|
||||
},
|
||||
"items": {
|
||||
"required": true,
|
||||
"minItems": 1,
|
||||
"structure": {
|
||||
"label": "string - Link text (required)",
|
||||
"href": "string - Link destination (optional)",
|
||||
"onClick": "() => void - Click handler (optional)"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"columns": "Array<{ title: string, items: Array<{ label: string, href?: string, onClick?: () => void }> }>",
|
||||
"bottomLeftText": "string",
|
||||
"bottomRightText": "string",
|
||||
"ariaLabel?": "string (default: 'Site footer')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"columnsClassName?": "string",
|
||||
"columnClassName?": "string",
|
||||
"columnTitleClassName?": "string",
|
||||
"columnItemClassName?": "string",
|
||||
"dividerClassName?": "string",
|
||||
"bottomContainerClassName?": "string",
|
||||
"bottomLeftTextClassName?": "string",
|
||||
"bottomRightTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<FooterSimple columns={[{ title: 'Navigate', items: [{ label: 'Home', href: '#' }, { label: 'About', href: '#' }] }, { title: 'Resources', items: [{ label: 'Blog', href: '#' }, { label: 'FAQ', href: '#' }] }, { title: 'Legal', items: [{ label: 'Privacy', href: '#' }, { label: 'Terms', href: '#' }] }]} bottomLeftText=\"© 2025 Company. All rights reserved.\" bottomRightText=\"Made with Webild\" />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Requires columns[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
27
registry/components/GradientBarsBackground.json
Normal file
27
registry/components/GradientBarsBackground.json
Normal file
@@ -0,0 +1,27 @@
|
||||
{
|
||||
"name": "GradientBarsBackground",
|
||||
"description": "Gradient bars on left and right edges with fade masks creating a spotlight center effect.",
|
||||
"details": "Use for modern backgrounds with vertical gradient bars positioned on left and right sides. Features two groups of bars (8 per side by default) that fade towards the center using CSS masks. Main container has vertical fade from bottom to top. Left bars fade towards center (270deg mask), right bars fade towards center (90deg mask). Creates an open center area (30% by default) for content. Each bar has horizontal gradient using theme primary color. Perfect for hero sections or landing pages where center content needs visual framing.",
|
||||
"constraints": {},
|
||||
"propsSchema": {
|
||||
"className?": "string",
|
||||
"numBarsPerSide?": "number (default: 8)",
|
||||
"gradientFrom?": "string (default: 'var(--color-primary-cta)')",
|
||||
"gradientTo?": "string (default: 'transparent')",
|
||||
"opacity?": "number (default: 0.075)",
|
||||
"sideWidth?": "string (default: '35%')"
|
||||
},
|
||||
"usageExample": "<GradientBarsBackground numBarsPerSide={8} opacity={0.075} sideWidth=\"35%\" />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Use for statistics displays",
|
||||
"Use for achievement showcases"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
24
registry/components/GridBackround.json
Normal file
24
registry/components/GridBackround.json
Normal file
@@ -0,0 +1,24 @@
|
||||
{
|
||||
"name": "GridBackround",
|
||||
"description": "Grid pattern background with line-based grid and optional 3D perspective effect.",
|
||||
"details": "Use for technical or structured layouts. Features adjustable grid size (small: 16 cells, medium: 10 cells, large: 5 cells per 100vw). Optional perspectiveThreeD adds skew transform and radial mask for depth. Uses background-accent color at 10% opacity.",
|
||||
"constraints": {},
|
||||
"propsSchema": {
|
||||
"size?": "'small' | 'medium' | 'large' (default: 'medium')",
|
||||
"perspectiveThreeD?": "boolean (default: false)",
|
||||
"className?": "string"
|
||||
},
|
||||
"usageExample": "<GridBackround size=\"medium\" perspectiveThreeD={false} />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use more than 4 items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
142
registry/components/HeroBillboard.json
Normal file
142
registry/components/HeroBillboard.json
Normal file
@@ -0,0 +1,142 @@
|
||||
{
|
||||
"name": "HeroBillboard",
|
||||
"description": "Full-width hero section with centered text content, configurable background, optional tag, buttons, avatar group, single image/video below in a card frame, and optional logo marquee.",
|
||||
"details": "Use for simple, impactful landing page hero sections. Features centered title and description with TextBox animations, required background variant (choose from animated grids, gradient effects, or 'plain' for no background), optional tag with icon, up to 2 CTA buttons, optional avatar group with text displayed above the tag, a single image or video media content below the text in a card wrapper with padding, and an optional logo marquee below the media. Background variants include preset options for zero-config usage.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Welcome to Our Platform",
|
||||
"minChars": 2,
|
||||
"maxChars": 40
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Create beautiful, responsive web experiences",
|
||||
"minChars": 5,
|
||||
"maxChars": 200
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "New Release",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"imageSrc": {
|
||||
"required": false,
|
||||
"example": "/hero-image.jpg",
|
||||
"note": "Supports external URLs with unoptimized prop Either imageSrc or videoSrc should be provided. Image is recommended if no videoSrc."
|
||||
},
|
||||
"videoSrc": {
|
||||
"required": false,
|
||||
"example": "/hero-video.mp4",
|
||||
"note": "Takes precedence over imageSrc if both provided"
|
||||
},
|
||||
"imageAlt": {
|
||||
"required": false,
|
||||
"example": "Hero background",
|
||||
"note": "Empty string marks image as decorative (aria-hidden)"
|
||||
}
|
||||
},
|
||||
"buttonRules": {
|
||||
"maxButtons": 2,
|
||||
"structure": {
|
||||
"text": "string - Button label (required)",
|
||||
"href": "string - Link destination (optional). External URLs (https://, http://, www.) open in new tab. Internal values (e.g., 'about', 'contact') scroll to #about, #contact sections",
|
||||
"onClick": "() => void - Additional click handler (optional)",
|
||||
"props": "Partial<ButtonPropsForVariant> - Additional button props like className, textClassName (optional)"
|
||||
},
|
||||
"examples": [
|
||||
"{ text: 'Get Started', href: 'https://example.com' }",
|
||||
"{ text: 'Learn More', href: 'about' }"
|
||||
],
|
||||
"note": "Button variant is controlled by ThemeProvider's defaultButtonVariant. Border radius is controlled by ThemeProvider's borderRadius (options: 'sharp', 'rounded', 'soft', 'pill'). All sections should be wrapped in a single ThemeProvider at the app/page level to maintain consistent styling across the entire site."
|
||||
},
|
||||
"avatarRules": {
|
||||
"avatars": {
|
||||
"required": false,
|
||||
"example": "[{ src: '/avatar1.jpg', alt: 'User 1' }, { src: '/avatar2.jpg', alt: 'User 2' }]",
|
||||
"note": "Array of Avatar objects with src and alt. Displayed above the tag in a centered group."
|
||||
},
|
||||
"avatarText": {
|
||||
"required": false,
|
||||
"example": "Trusted by 10,000+ users",
|
||||
"note": "Text displayed next to the avatar group"
|
||||
}
|
||||
},
|
||||
"marqueeRules": {
|
||||
"marqueeItems": {
|
||||
"required": false,
|
||||
"example": "[{ type: 'image', src: '/logo1.svg', alt: 'Partner 1' }, { type: 'text', text: 'Partner Name' }]",
|
||||
"note": "Array of MarqueeItem objects. Rendered below the media content (not absolute positioned)."
|
||||
},
|
||||
"marqueeSpeed": {
|
||||
"required": false,
|
||||
"default": 30,
|
||||
"note": "Speed of the marquee animation"
|
||||
},
|
||||
"showMarqueeCard": {
|
||||
"required": false,
|
||||
"default": true,
|
||||
"note": "Whether to show the card wrapper around marquee items"
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string",
|
||||
"description": "string",
|
||||
"background": "{ variant: 'plain' | 'animated-grid' | 'canvas-reveal' | 'cell-wave' | 'downward-rays-animated' | 'downward-rays-animated-grid' | 'downward-rays-static' | 'downward-rays-static-grid' | 'gradient-bars' | 'radial-gradient' | 'rotated-rays-animated' | 'rotated-rays-animated-grid' | 'rotated-rays-static' | 'rotated-rays-static-grid' | 'sparkles-gradient' }",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"avatars?": "Array<{src: string, alt: string}>",
|
||||
"avatarText?": "string",
|
||||
"imageSrc?": "string",
|
||||
"videoSrc?": "string",
|
||||
"imageAlt?": "string (default: '')",
|
||||
"videoAriaLabel?": "string (default: 'Hero video')",
|
||||
"mediaAspectRatio?": "string (default: 'aspect-square md:aspect-video')",
|
||||
"mediaAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"marqueeItems?": "Array<MarqueeItem>",
|
||||
"marqueeSpeed?": "number (default: 30)",
|
||||
"showMarqueeCard?": "boolean (default: true)",
|
||||
"ariaLabel?": "string (default: 'Hero section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"avatarGroupClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"imageClassName?": "string",
|
||||
"marqueeClassName?": "string",
|
||||
"marqueeItemClassName?": "string",
|
||||
"marqueeCardClassName?": "string",
|
||||
"marqueeImageClassName?": "string",
|
||||
"marqueeTextClassName?": "string",
|
||||
"marqueeIconClassName?": "string"
|
||||
},
|
||||
"usageExample": "<ThemeProvider defaultButtonVariant=\"text-stagger\" defaultTextAnimation=\"entrance-slide\" borderRadius=\"rounded\">\n <HeroBillboard \n background={{ variant: 'sparkles-gradient' }}\n title=\"Welcome to Our Platform\" \n description=\"Create beautiful, responsive web experiences\" \n tag=\"New Release\" \n tagIcon={Sparkles}\n avatars={[\n { src: '/avatar1.jpg', alt: 'User 1' },\n { src: '/avatar2.jpg', alt: 'User 2' },\n { src: '/avatar3.jpg', alt: 'User 3' },\n ]}\n avatarText=\"Trusted by 10,000+ users\"\n imageSrc=\"/hero.jpg\" \n imageAlt=\"Hero banner\"\n buttons={[{ text: 'Get Started', href: 'https://example.com' }, { text: 'Learn More', href: 'about' }]}\n marqueeItems={[\n { type: 'image', src: '/logo1.svg', alt: 'Partner 1' },\n { type: 'image', src: '/logo2.svg', alt: 'Partner 2' },\n ]}\n />\n</ThemeProvider>",
|
||||
"do": [
|
||||
"Use for landing pages",
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use multiple items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
88
registry/components/HeroBillboardCarousel.json
Normal file
88
registry/components/HeroBillboardCarousel.json
Normal file
@@ -0,0 +1,88 @@
|
||||
{
|
||||
"name": "HeroBillboardCarousel",
|
||||
"description": "Full-width hero section with centered text, configurable background, and 5+ auto-scrolling images in carousel layout.",
|
||||
"details": "Use for showcasing large collections or portfolios. Features centered title and description with TextBox animations, required background variant (choose from animated grids, gradient effects, or 'plain' for no background), optional tag with icon, up to 2 CTA buttons. Displays 5 or more images in auto-scrolling carousel on both mobile and desktop. Full viewport height with vertical centering on desktop. Background variants include preset options for zero-config usage.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Our Portfolio",
|
||||
"minChars": 2,
|
||||
"maxChars": 40
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Browse through our collection of projects",
|
||||
"minChars": 5,
|
||||
"maxChars": 200
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Portfolio",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"mediaItems": {
|
||||
"required": true,
|
||||
"example": "[{ imageSrc: '/img1.jpg', imageAlt: 'Product 1' }, { imageSrc: '/img2.jpg', imageAlt: 'Product 2' }, { imageSrc: '/img3.jpg', imageAlt: 'Product 3' }, { imageSrc: '/img4.jpg', imageAlt: 'Product 4' }, { imageSrc: '/img5.jpg', imageAlt: 'Product 5' }]",
|
||||
"note": "Array of 5+ MediaItem objects. Each item can have imageSrc, videoSrc, imageAlt, videoAriaLabel. Requires minimum 5 images."
|
||||
}
|
||||
},
|
||||
"buttonRules": {
|
||||
"maxButtons": 2,
|
||||
"structure": {
|
||||
"text": "string - Button label (required)",
|
||||
"href": "string - Link destination (optional). External URLs (https://, http://, www.) open in new tab. Internal values (e.g., 'about', 'contact') scroll to #about, #contact sections",
|
||||
"onClick": "() => void - Additional click handler (optional)",
|
||||
"props": "Partial<ButtonPropsForVariant> - Additional button props like className, textClassName (optional)"
|
||||
},
|
||||
"examples": [
|
||||
"{ text: 'View Portfolio', href: 'https://example.com' }",
|
||||
"{ text: 'Contact Us', href: 'contact' }"
|
||||
],
|
||||
"note": "Button variant is controlled by ThemeProvider's defaultButtonVariant. Border radius is controlled by ThemeProvider's borderRadius (options: 'sharp', 'rounded', 'soft', 'pill'). All sections should be wrapped in a single ThemeProvider at the app/page level to maintain consistent styling across the entire site."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string",
|
||||
"description": "string",
|
||||
"background": "{ variant: 'plain' | 'animated-grid' | 'canvas-reveal' | 'cell-wave' | 'downward-rays-animated' | 'downward-rays-animated-grid' | 'downward-rays-static' | 'downward-rays-static-grid' | 'gradient-bars' | 'radial-gradient' | 'rotated-rays-animated' | 'rotated-rays-animated-grid' | 'rotated-rays-static' | 'rotated-rays-static-grid' | 'sparkles-gradient' }",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"mediaItems": "Array<{ imageSrc?: string, videoSrc?: string, imageAlt?: string, videoAriaLabel?: string }> - Each item requires either imageSrc or videoSrc",
|
||||
"ariaLabel?": "string (default: 'Hero section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"mediaWrapperClassName?": "string"
|
||||
},
|
||||
"usageExample": "<ThemeProvider defaultButtonVariant=\"text-stagger\" defaultTextAnimation=\"entrance-slide\" borderRadius=\"rounded\">\n <HeroBillboardCarousel \n background={{ variant: 'sparkles-gradient' }}\n title=\"Our Portfolio\" \n description=\"Browse through our collection of projects\" \n tag=\"Portfolio\" \n mediaItems={[\n { imageSrc: '/img1.jpg', imageAlt: 'Product 1' },\n { imageSrc: '/img2.jpg', imageAlt: 'Product 2' },\n { imageSrc: '/img3.jpg', imageAlt: 'Product 3' },\n { imageSrc: '/img4.jpg', imageAlt: 'Product 4' },\n { imageSrc: '/img5.jpg', imageAlt: 'Product 5' },\n { imageSrc: '/img6.jpg', imageAlt: 'Product 6' },\n { imageSrc: '/img7.jpg', imageAlt: 'Product 7' }\n ]}\n buttons={[{ text: 'View Portfolio', href: 'https://example.com' }, { text: 'Contact Us', href: 'contact' }]} \n />\n</ThemeProvider>",
|
||||
"do": [
|
||||
"Use for landing pages",
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Use for portfolios",
|
||||
"Use for image galleries",
|
||||
"Requires buttons?[]",
|
||||
"Requires mediaItems[]"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use less than 5 items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
114
registry/components/HeroBillboardDashboard.json
Normal file
114
registry/components/HeroBillboardDashboard.json
Normal file
@@ -0,0 +1,114 @@
|
||||
{
|
||||
"name": "HeroBillboardDashboard",
|
||||
"description": "Full-width hero section with centered text content and an interactive Dashboard component below instead of a static image/video.",
|
||||
"details": "Based on HeroBillboard layout — centered TextBox with title, description, tag, and buttons on top, with a full Dashboard component below. The Dashboard includes icon sidebar, search bar, avatar, action buttons, 3 stat cards with animated number cycling (values rotate every 3s via TextNumberCount), a BentoLineChart, and a vertically auto-scrolling list. On mobile, stat cards become a carousel with arrow navigation. Desktop stat cards have staggered GSAP scroll entrance. All Dashboard props are passed via a single 'dashboard' object prop.",
|
||||
"requiredImports": {
|
||||
"lucide-react": ["Sparkles", "Hexagon", "House", "MessageSquareText", "Settings", "CircleDollarSign", "ArrowLeftRight", "Send"],
|
||||
"note": "Import all icons used in tagIcon, dashboard.logoIcon, dashboard.sidebarItems[].icon, dashboard.listItems[].icon. Use component names, not strings."
|
||||
},
|
||||
"typeDefinitions": {
|
||||
"DashboardStat": {
|
||||
"title": "string (required)",
|
||||
"values": "[number, number, number] - exactly 3 numbers, cycled every 3s (required)",
|
||||
"valuePrefix": "string (optional, e.g. '$')",
|
||||
"valueSuffix": "string (optional, e.g. 'M')",
|
||||
"description": "string (required)",
|
||||
"titleMobile": "string (optional, shorter label for mobile)"
|
||||
},
|
||||
"DashboardSidebarItem": {
|
||||
"icon": "LucideIcon - import from lucide-react (required)",
|
||||
"active": "boolean (optional, default false)"
|
||||
},
|
||||
"DashboardListItem": {
|
||||
"icon": "LucideIcon - import from lucide-react (required)",
|
||||
"title": "string (required)",
|
||||
"status": "string (required)"
|
||||
},
|
||||
"ChartDataItem": {
|
||||
"value": "number (required)"
|
||||
}
|
||||
},
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Real-Time On-Chain Intelligence",
|
||||
"minChars": 2,
|
||||
"maxChars": 40
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Monitor protocol revenue, trading volume, and wallet activity.",
|
||||
"minChars": 5,
|
||||
"maxChars": 200
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Live Analytics",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"buttonRules": {
|
||||
"maxButtons": 2,
|
||||
"structure": {
|
||||
"text": "string - Button label (required)",
|
||||
"href": "string - Link destination (optional). External URLs (https://, http://, www.) open in new tab. Internal values (e.g., 'about', 'contact') scroll to #about, #contact sections",
|
||||
"onClick": "() => void - Additional click handler (optional)",
|
||||
"props": "Partial<ButtonPropsForVariant> - Additional button props like className, textClassName (optional)"
|
||||
},
|
||||
"examples": [
|
||||
"{ text: 'Get Started', href: 'https://example.com' }",
|
||||
"{ text: 'View Docs', href: 'docs' }"
|
||||
],
|
||||
"note": "Button variant is controlled by ThemeProvider's defaultButtonVariant. Border radius is controlled by ThemeProvider's borderRadius (options: 'sharp', 'rounded', 'soft', 'pill'). All sections should be wrapped in a single ThemeProvider at the app/page level to maintain consistent styling across the entire site."
|
||||
},
|
||||
"dashboardRules": {
|
||||
"required": ["title", "stats", "logoIcon", "sidebarItems", "buttons", "listItems", "imageSrc"],
|
||||
"stats": "Exactly 3 DashboardStat objects. See typeDefinitions.DashboardStat.",
|
||||
"sidebarItems": "Array of DashboardSidebarItem. At least 1 item. See typeDefinitions.DashboardSidebarItem.",
|
||||
"listItems": "Array of DashboardListItem. At least 1 item. See typeDefinitions.DashboardListItem.",
|
||||
"buttons": "Array of ButtonConfig. Max 2. Same structure as hero buttons.",
|
||||
"chartData": "Optional. Array of ChartDataItem. See typeDefinitions.ChartDataItem.",
|
||||
"imageSrc": "string - URL for avatar image in dashboard header"
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string",
|
||||
"description": "string",
|
||||
"background": "{ variant: 'plain' | 'animated-grid' | 'canvas-reveal' | 'cell-wave' | 'downward-rays-animated' | 'downward-rays-animated-grid' | 'downward-rays-static' | 'downward-rays-static-grid' | 'gradient-bars' | 'radial-gradient' | 'rotated-rays-animated' | 'rotated-rays-animated-grid' | 'rotated-rays-static' | 'rotated-rays-static-grid' | 'sparkles-gradient' }",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"dashboard": "Object. Required: title, stats (exactly 3), logoIcon, sidebarItems, buttons, listItems, imageSrc. Optional: searchPlaceholder, chartTitle, chartData, listTitle, videoSrc, imageAlt, videoAriaLabel, className, containerClassName, sidebarClassName, statClassName, chartClassName, listClassName. See typeDefinitions for DashboardStat, DashboardSidebarItem, DashboardListItem, ChartDataItem.",
|
||||
"ariaLabel?": "string (default: 'Hero section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"dashboardClassName?": "string"
|
||||
},
|
||||
"usageExample": "import { Sparkles, Hexagon, House, MessageSquareText, Settings, CircleDollarSign, ArrowLeftRight, Send } from 'lucide-react';\nimport HeroBillboardDashboard from '@/components/sections/hero/HeroBillboardDashboard';\n\n<HeroBillboardDashboard\n background={{ variant: 'radial-gradient' }}\n tag=\"Live Analytics\"\n tagIcon={Sparkles}\n title=\"Real-Time On-Chain Intelligence\"\n description=\"Monitor protocol revenue, trading volume, and wallet activity.\"\n buttons={[{ text: 'Get Started', href: '#' }, { text: 'View Docs', href: '#' }]}\n dashboard={{\n title: \"On-Chain Metrics Hub\",\n logoIcon: Hexagon,\n imageSrc: \"https://images.unsplash.com/photo-1472099645785-5658abf4ff4e?w=100&h=100&fit=crop&crop=face\",\n buttons: [{ text: \"Dashboard\", href: \"#\" }, { text: \"Export CSV\", href: \"#\" }],\n sidebarItems: [{ icon: House, active: true }, { icon: MessageSquareText }, { icon: Settings }],\n stats: [\n { title: \"Revenue\", values: [178425, 245890, 312750], valuePrefix: \"$\", description: \"Protocol fees.\" },\n { title: \"Volume\", values: [7.84, 12.5, 9.32], valuePrefix: \"$\", valueSuffix: \"M\", description: \"Transaction flow.\" },\n { title: \"Wallets\", values: [11240, 15680, 13450], description: \"Active wallets.\" },\n ],\n chartTitle: \"Staking Rewards\",\n chartData: [{ value: 50 }, { value: 30 }, { value: 70 }, { value: 40 }, { value: 90 }],\n listTitle: \"Treasury Transfers\",\n listItems: [\n { icon: CircleDollarSign, title: \"$12,000 USDC\", status: \"Confirmed\" },\n { icon: ArrowLeftRight, title: \"Swap: 5 ETH\", status: \"Executed\" },\n { icon: Send, title: \"Transfer: 2,500 DAI\", status: \"Confirmed\" },\n ],\n }}\n/>",
|
||||
"do": [
|
||||
"Use for SaaS landing pages",
|
||||
"Use for analytics/dashboard product showcases",
|
||||
"Use for data visualization platforms",
|
||||
"Requires dashboard prop with all nested properties"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use without dashboard data",
|
||||
"Do not use for simple hero sections without interactive elements"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
94
registry/components/HeroBillboardGallery.json
Normal file
94
registry/components/HeroBillboardGallery.json
Normal file
@@ -0,0 +1,94 @@
|
||||
{
|
||||
"name": "HeroBillboardGallery",
|
||||
"description": "Full-width hero section with centered text, configurable background, and 3-5 overlapping rotated images in gallery layout.",
|
||||
"details": "Use for visually rich landing pages showcasing multiple images. Features centered title and description with TextBox animations, required background variant (choose from animated grids, gradient effects, or 'plain' for no background), optional tag with icon, up to 2 CTA buttons. Gallery shows 3-5 overlapping images with rotation effects. Mobile displays AutoCarousel, desktop shows overlapping rotated images. Full viewport height with vertical centering on desktop. Background variants include preset options for zero-config usage.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Explore Our Collection",
|
||||
"minChars": 2,
|
||||
"maxChars": 40
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Discover amazing products and experiences",
|
||||
"minChars": 5,
|
||||
"maxChars": 200
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Featured",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"minItems": 3,
|
||||
"maxItems": 5,
|
||||
"note": "MINIMUM 3 ITEMS REQUIRED - gallery needs at least 3 items for proper display",
|
||||
"mediaItems": {
|
||||
"required": true,
|
||||
"example": "[{ imageSrc: '/img1.jpg', imageAlt: 'Gallery 1' }, { imageSrc: '/img2.jpg', imageAlt: 'Gallery 2' }, { imageSrc: '/img3.jpg', imageAlt: 'Gallery 3' }]",
|
||||
"note": "Array of 3-5 MediaItem objects. Each item can have imageSrc, videoSrc, imageAlt, videoAriaLabel."
|
||||
}
|
||||
},
|
||||
"buttonRules": {
|
||||
"maxButtons": 2,
|
||||
"structure": {
|
||||
"text": "string - Button label (required)",
|
||||
"href": "string - Link destination (optional). External URLs (https://, http://, www.) open in new tab. Internal values (e.g., 'about', 'contact') scroll to #about, #contact sections",
|
||||
"onClick": "() => void - Additional click handler (optional)",
|
||||
"props": "Partial<ButtonPropsForVariant> - Additional button props like className, textClassName (optional)"
|
||||
},
|
||||
"examples": [
|
||||
"{ text: 'View Gallery', href: 'https://example.com' }",
|
||||
"{ text: 'Learn More', href: 'about' }"
|
||||
],
|
||||
"note": "Button variant is controlled by ThemeProvider's defaultButtonVariant. Border radius is controlled by ThemeProvider's borderRadius (options: 'sharp', 'rounded', 'soft', 'pill'). All sections should be wrapped in a single ThemeProvider at the app/page level to maintain consistent styling across the entire site."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string",
|
||||
"description": "string",
|
||||
"background": "{ variant: 'plain' | 'animated-grid' | 'canvas-reveal' | 'cell-wave' | 'downward-rays-animated' | 'downward-rays-animated-grid' | 'downward-rays-static' | 'downward-rays-static-grid' | 'gradient-bars' | 'radial-gradient' | 'rotated-rays-animated' | 'rotated-rays-animated-grid' | 'rotated-rays-static' | 'rotated-rays-static-grid' | 'sparkles-gradient' }",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"mediaItems": "Array<{ imageSrc?: string, videoSrc?: string, imageAlt?: string, videoAriaLabel?: string }> (MINIMUM 3 ITEMS REQUIRED, max 5)",
|
||||
"mediaAnimation": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"ariaLabel?": "string (default: 'Hero section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"imageClassName?": "string"
|
||||
},
|
||||
"usageExample": "<ThemeProvider defaultButtonVariant=\"text-stagger\" defaultTextAnimation=\"entrance-slide\" borderRadius=\"rounded\">\n <HeroBillboardGallery \n background={{ variant: 'radial-gradient' }}\n title=\"Explore Our Collection\" \n description=\"Discover amazing products and experiences\" \n tag=\"Featured\" \n mediaItems={[\n { imageSrc: '/img1.jpg', imageAlt: 'Gallery 1' },\n { imageSrc: '/img2.jpg', imageAlt: 'Gallery 2' },\n { imageSrc: '/img3.jpg', imageAlt: 'Gallery 3' },\n { imageSrc: '/img4.jpg', imageAlt: 'Gallery 4' },\n { imageSrc: '/img5.jpg', imageAlt: 'Gallery 5' }\n ]}\n buttons={[{ text: 'View Gallery', href: 'https://example.com' }, { text: 'Learn More', href: 'about' }]} \n />\n</ThemeProvider>",
|
||||
"do": [
|
||||
"Use for landing pages",
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Use for portfolios",
|
||||
"Use for image galleries",
|
||||
"Requires buttons?[]",
|
||||
"Requires mediaItems[]"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use with fewer than 3 items - gallery requires minimum 3 items",
|
||||
"Do not use more than 5 items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
102
registry/components/HeroBillboardRotatedCarousel.json
Normal file
102
registry/components/HeroBillboardRotatedCarousel.json
Normal file
@@ -0,0 +1,102 @@
|
||||
{
|
||||
"name": "HeroBillboardRotatedCarousel",
|
||||
"description": "Hero section with centered text content and angled/rotated carousel below. Features auto-playing carousel with scaled and rotated side cards.",
|
||||
"details": "Use for product showcases, portfolios, or visual-heavy landing pages. Features centered title, description, optional tag with icon, and action buttons via TextBox component. Below is an AngledCarousel showing rotated preview cards on sides (88% scale, 2deg rotation) with center card at full scale. Carousel auto-advances every 4 seconds. Side cards have backdrop blur overlay. Requires minimum 6 carousel items to avoid duplicate key warnings (carousel shows 5 positions: -2, -1, 0, 1, 2). Uses full viewport height with custom spacing.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Transform Your Workflow",
|
||||
"minChars": 2,
|
||||
"maxChars": 60
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Experience the power of seamless collaboration and productivity tools designed for modern teams",
|
||||
"minChars": 5,
|
||||
"maxChars": 200
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "New Release",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"buttonRules": {
|
||||
"maxButtons": 2,
|
||||
"structure": {
|
||||
"text": "string - Button label (required)",
|
||||
"href": "string - Link destination (optional)",
|
||||
"onClick": "() => void - Click handler (optional)",
|
||||
"props": "Partial<ButtonPropsForVariant> - Additional button props (optional)"
|
||||
},
|
||||
"note": "Button variant controlled by ThemeProvider's defaultButtonVariant. All sections should be wrapped in a single ThemeProvider at the app/page level."
|
||||
},
|
||||
"carouselItemRules": {
|
||||
"required": true,
|
||||
"minItems": 6,
|
||||
"structure": {
|
||||
"id": "string - Unique identifier (required)",
|
||||
"imageSrc": "string - Image URL (optional) Image is recommended if no videoSrc.",
|
||||
"videoSrc": "string - Video URL (optional, takes precedence over imageSrc)",
|
||||
"imageAlt": "string - Alt text for image (optional)",
|
||||
"videoAriaLabel": "string - ARIA label for video (optional)"
|
||||
},
|
||||
"note": "Minimum 6 items required to prevent duplicate keys. Carousel displays 5 positions simultaneously (-2, -1, 0, 1, 2). Each item should have either imageSrc or videoSrc. Uses MediaContent component for rendering."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string",
|
||||
"description": "string",
|
||||
"background": "{ variant: 'plain' | 'animated-grid' | 'canvas-reveal' | 'cell-wave' | 'downward-rays-animated' | 'downward-rays-animated-grid' | 'downward-rays-static' | 'downward-rays-static-grid' | 'gradient-bars' | 'radial-gradient' | 'rotated-rays-animated' | 'rotated-rays-animated-grid' | 'rotated-rays-static' | 'rotated-rays-static-grid' | 'sparkles-gradient' }",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"carouselItems": "Array<{ id: string, imageSrc?: string, videoSrc?: string, imageAlt?: string, videoAriaLabel?: string }> - Carousel items (minimum 6 items)",
|
||||
"autoPlay?": "boolean (default: true)",
|
||||
"autoPlayInterval?": "number (default: 4000)",
|
||||
"marqueeItems?": "Array<{ type: 'image', src: string, alt?: string } | { type: 'text', text: string } | { type: 'text-icon', text: string, icon: LucideIcon }> - Logo marquee items",
|
||||
"marqueeSpeed?": "number (default: 30)",
|
||||
"showMarqueeCard?": "boolean (default: true)",
|
||||
"ariaLabel?": "string (default: 'Hero section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"carouselClassName?": "string",
|
||||
"marqueeClassName?": "string",
|
||||
"marqueeItemClassName?": "string",
|
||||
"marqueeCardClassName?": "string",
|
||||
"marqueeImageClassName?": "string",
|
||||
"marqueeTextClassName?": "string",
|
||||
"marqueeIconClassName?": "string"
|
||||
},
|
||||
"usageExample": "<ThemeProvider defaultButtonVariant=\"hover-bubble\" defaultTextAnimation=\"entrance-slide\" borderRadius=\"pill\">\n <HeroBillboardRotatedCarousel \n title=\"Transform Your Workflow\" \n description=\"Experience seamless collaboration and productivity\" \n background={{ variant: \"glowing-orb\" }}\n tag=\"New Release\" \n tagIcon={Sparkles}\n buttons={[{ text: 'Get Started' }, { text: 'Learn More' }]}\n carouselItems={[\n { id: '1', imageSrc: '/image1.jpg', imageAlt: 'Product 1' },\n { id: '2', imageSrc: '/image2.jpg', imageAlt: 'Product 2' },\n { id: '3', imageSrc: '/image3.jpg', imageAlt: 'Product 3' },\n { id: '4', imageSrc: '/image4.jpg', imageAlt: 'Product 4' },\n { id: '5', imageSrc: '/image5.jpg', imageAlt: 'Product 5' },\n { id: '6', imageSrc: '/image6.jpg', imageAlt: 'Product 6' }\n ]}\n autoPlay={true}\n autoPlayInterval={4000}\n />\n</ThemeProvider>",
|
||||
"do": [
|
||||
"Use for landing pages",
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Use for portfolios",
|
||||
"Use for image galleries",
|
||||
"Use for product catalogs",
|
||||
"Use for e-commerce",
|
||||
"Requires buttons?[]",
|
||||
"Requires carouselItems[]"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use less than 6 items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
125
registry/components/HeroBillboardScroll.json
Normal file
125
registry/components/HeroBillboardScroll.json
Normal file
@@ -0,0 +1,125 @@
|
||||
{
|
||||
"name": "HeroBillboardScroll",
|
||||
"description": "Full-screen hero section with centered text, configurable background, and media card that animates with 3D perspective transforms on scroll (desktop only).",
|
||||
"details": "Use for modern, interactive landing pages showcasing products, dashboards, or applications with scroll-triggered effects. Features required background variant (choose from animated grids, gradient effects, or 'plain' for no background), centered TextBox, and animated media card. On desktop, the media card animates from rotated (20deg X-axis) and scaled (1.05) to flat and normal scale as user scrolls down. Mobile displays a static 3D-rotated card without animation to avoid performance issues. Background variants include preset options for zero-config usage. Requires ReactLenis for smooth scroll tracking.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Scroll Animations",
|
||||
"minChars": 2,
|
||||
"maxChars": 60
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Experience smooth, performant animations as you scroll through your content",
|
||||
"minChars": 5,
|
||||
"maxChars": 200
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Unleash the Power",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"imageSrc": {
|
||||
"required": false,
|
||||
"example": "/dashboard.jpg",
|
||||
"note": "Image to display in the animated card. Supports external URLs with unoptimized prop Either imageSrc or videoSrc should be provided. Image is recommended if no videoSrc."
|
||||
},
|
||||
"videoSrc": {
|
||||
"required": false,
|
||||
"example": "/demo.mp4",
|
||||
"note": "Video to display in the animated card. Takes precedence over imageSrc if both provided"
|
||||
},
|
||||
"imageAlt": {
|
||||
"required": false,
|
||||
"example": "Dashboard preview",
|
||||
"note": "Empty string marks image as decorative (aria-hidden)"
|
||||
},
|
||||
"animationBehavior": {
|
||||
"desktop": {
|
||||
"rotateX": "Animates from 20deg to 0deg based on scroll progress",
|
||||
"scale": "Animates from 1.05 to 1 based on scroll progress",
|
||||
"height": "h-[75svh] (75% of viewport height)",
|
||||
"note": "Uses Framer Motion's useScroll and useTransform for smooth scroll-linked animations"
|
||||
},
|
||||
"mobile": {
|
||||
"rotateX": "Static 20deg rotation (no animation)",
|
||||
"scale": "No scale animation",
|
||||
"height": "h-[50svh] (50% of viewport height)",
|
||||
"note": "Separate static div implementation to prevent performance issues and hydration errors"
|
||||
},
|
||||
"perspective": "1000px applied to container for 3D effect"
|
||||
}
|
||||
},
|
||||
"buttonRules": {
|
||||
"maxButtons": 2,
|
||||
"structure": {
|
||||
"text": "string - Button label (required)",
|
||||
"href": "string - Link destination (optional). External URLs (https://, http://, www.) open in new tab. Internal values (e.g., 'about', 'contact') scroll to #about, #contact sections",
|
||||
"onClick": "() => void - Additional click handler (optional)",
|
||||
"props": "Partial<ButtonPropsForVariant> - Additional button props like className, textClassName (optional)"
|
||||
},
|
||||
"examples": [
|
||||
"{ text: 'Get Started', onClick: () => console.log('Get Started clicked') }",
|
||||
"{ text: 'Learn More', href: 'about' }"
|
||||
],
|
||||
"note": "Button variant is controlled by ThemeProvider's defaultButtonVariant. Border radius is controlled by ThemeProvider's borderRadius (options: 'sharp', 'rounded', 'soft', 'pill'). All sections should be wrapped in a single ThemeProvider at the app/page level to maintain consistent styling across the entire site."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string",
|
||||
"description": "string",
|
||||
"background": "{ variant: 'plain' | 'animated-grid' | 'canvas-reveal' | 'cell-wave' | 'downward-rays-animated' | 'downward-rays-animated-grid' | 'downward-rays-static' | 'downward-rays-static-grid' | 'gradient-bars' | 'radial-gradient' | 'rotated-rays-animated' | 'rotated-rays-animated-grid' | 'rotated-rays-static' | 'rotated-rays-static-grid' | 'sparkles-gradient' }",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"imageSrc?": "string",
|
||||
"videoSrc?": "string",
|
||||
"imageAlt?": "string (default: '')",
|
||||
"videoAriaLabel?": "string (default: 'Hero video')",
|
||||
"mediaAspectRatio?": "string (default: 'aspect-[4/3] md:aspect-[16/9]')",
|
||||
"marqueeItems?": "Array<MarqueeItem>",
|
||||
"marqueeSpeed?": "number (default: 30)",
|
||||
"showMarqueeCard?": "boolean (default: true)",
|
||||
"ariaLabel?": "string (default: 'Hero section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"cardWrapperClassName?": "string",
|
||||
"cardInnerClassName?": "string",
|
||||
"imageClassName?": "string",
|
||||
"marqueeClassName?": "string",
|
||||
"marqueeItemClassName?": "string",
|
||||
"marqueeCardClassName?": "string",
|
||||
"marqueeImageClassName?": "string",
|
||||
"marqueeTextClassName?": "string",
|
||||
"marqueeIconClassName?": "string"
|
||||
},
|
||||
"usageExample": "<ThemeProvider defaultButtonVariant=\"hover-bubble\" defaultTextAnimation=\"entrance-slide\" borderRadius=\"pill\">\n <HeroBillboardScroll \n background={{ variant: 'canvas-reveal' }}\n title=\"Scroll Animations\" \n description=\"Experience smooth, performant animations as you scroll through your content\" \n tag=\"Unleash the Power\" \n imageSrc=\"/dashboard.jpg\" \n imageAlt=\"Dashboard preview\"\n buttons={[{ text: 'Get Started', onClick: () => console.log('Get Started clicked') }, { text: 'Learn More', href: 'about' }]} \n />\n</ThemeProvider>",
|
||||
"do": [
|
||||
"Use for landing pages",
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Use for product catalogs",
|
||||
"Use for e-commerce",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
136
registry/components/HeroBillboardTestimonial.json
Normal file
136
registry/components/HeroBillboardTestimonial.json
Normal file
@@ -0,0 +1,136 @@
|
||||
{
|
||||
"name": "HeroBillboardTestimonial",
|
||||
"description": "Billboard-layout hero section with centered text content above full-width image/video with rotating testimonial card overlay.",
|
||||
"details": "Use for hero sections that combine centered messaging with social proof. Features billboard layout with centered text content above full-width media. Testimonials rotate automatically every 5 seconds with smooth fade animation. Each testimonial displays star rating, quote text, and author info with avatar. The testimonial card is positioned at the bottom-right of the media. Supports optional logo marquee below the media. Responsive design with square aspect ratio on mobile.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Build Modern Web Experiences",
|
||||
"minChars": 2,
|
||||
"maxChars": 36
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Create stunning, responsive websites with our comprehensive component library",
|
||||
"minChars": 5,
|
||||
"maxChars": 200
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "New Release",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"testimonialRules": {
|
||||
"testimonials": {
|
||||
"required": true,
|
||||
"minItems": 1,
|
||||
"example": "[{ name: 'Sarah Johnson', handle: 'CEO, TechCorp', testimonial: 'Amazing product!', rating: 5, imageSrc: '/avatar.jpg' }]",
|
||||
"note": "Array of testimonial objects. Each requires name, handle, testimonial text, and rating (1-5). imageSrc is optional."
|
||||
},
|
||||
"testimonialRotationInterval": {
|
||||
"required": false,
|
||||
"default": 5000,
|
||||
"note": "Rotation interval in milliseconds"
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"imageSrc": {
|
||||
"required": false,
|
||||
"example": "/hero-image.jpg",
|
||||
"note": "Supports external URLs with unoptimized prop Either imageSrc or videoSrc should be provided. Image is recommended if no videoSrc."
|
||||
},
|
||||
"videoSrc": {
|
||||
"required": false,
|
||||
"example": "/hero-video.mp4",
|
||||
"note": "Takes precedence over imageSrc if both provided"
|
||||
},
|
||||
"imageAlt": {
|
||||
"required": false,
|
||||
"example": "Product showcase",
|
||||
"note": "Empty string marks image as decorative"
|
||||
}
|
||||
},
|
||||
"buttonRules": {
|
||||
"maxButtons": 2,
|
||||
"structure": {
|
||||
"text": "string - Button label",
|
||||
"href": "string - Link URL or section ID for scroll",
|
||||
"onClick": "() => void - Optional click handler"
|
||||
},
|
||||
"examples": [
|
||||
"{ text: 'Get Started', href: 'https://example.com' }",
|
||||
"{ text: 'Learn More', href: 'about' }"
|
||||
],
|
||||
"note": "Button variant controlled by ThemeProvider. External URLs open in new tab, internal values scroll to sections."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string",
|
||||
"description": "string",
|
||||
"background": "{ variant: 'plain' | 'animated-grid' | 'canvas-reveal' | 'cell-wave' | 'downward-rays-animated' | 'downward-rays-animated-grid' | 'downward-rays-static' | 'downward-rays-static-grid' | 'glowing-orb' | 'gradient-bars' | 'radial-gradient' | 'rotated-rays-animated' | 'rotated-rays-animated-grid' | 'rotated-rays-static' | 'rotated-rays-static-grid' | 'sparkles-gradient' }",
|
||||
"testimonials": "Array<{ name: string, handle: string, testimonial: string, rating: number, imageSrc?: string, imageAlt?: string }>",
|
||||
"testimonialRotationInterval?": "number (default: 5000)",
|
||||
"useInvertedBackground?": "boolean (default: false)",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"avatars?": "Avatar[]",
|
||||
"avatarText?": "string",
|
||||
"imageSrc?": "string",
|
||||
"videoSrc?": "string",
|
||||
"imageAlt?": "string (default: '')",
|
||||
"videoAriaLabel?": "string (default: 'Hero video')",
|
||||
"mediaAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal' (default: 'none')",
|
||||
"ariaLabel?": "string (default: 'Hero section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"avatarGroupClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"imageClassName?": "string",
|
||||
"testimonialCardClassName?": "string",
|
||||
"testimonialContentClassName?": "string",
|
||||
"testimonialTextClassName?": "string",
|
||||
"testimonialRatingClassName?": "string",
|
||||
"testimonialAuthorClassName?": "string",
|
||||
"testimonialAuthorImageClassName?": "string",
|
||||
"testimonialAuthorNameClassName?": "string",
|
||||
"testimonialAuthorHandleClassName?": "string",
|
||||
"marqueeItems?": "MarqueeItem[]",
|
||||
"marqueeSpeed?": "number (default: 30)",
|
||||
"showMarqueeCard?": "boolean (default: true)",
|
||||
"marqueeClassName?": "string",
|
||||
"marqueeItemClassName?": "string",
|
||||
"marqueeCardClassName?": "string",
|
||||
"marqueeImageClassName?": "string",
|
||||
"marqueeTextClassName?": "string",
|
||||
"marqueeIconClassName?": "string"
|
||||
},
|
||||
"usageExample": "<ThemeProvider defaultButtonVariant=\"icon-arrow\" defaultTextAnimation=\"entrance-slide\" borderRadius=\"pill\" background=\"aurora\" cardStyle=\"glass-elevated\" primaryButtonStyle=\"gradient\" secondaryButtonStyle=\"glass\">\n <HeroBillboardTestimonial \n background={{ variant: 'glowing-orb' }}\n title=\"Build Modern Web Experiences\" \n description=\"Create stunning, responsive websites with our comprehensive component library\" \n tag=\"New Release\"\n imageSrc=\"/hero.jpg\"\n imageAlt=\"Product showcase\"\n mediaAnimation=\"slide-up\"\n testimonials={[{ name: 'Sarah Johnson', handle: 'CEO, TechCorp', testimonial: 'This transformed our workflow!', rating: 5, imageSrc: '/avatar.jpg' }]}\n buttons={[{ text: 'Get Started', href: 'https://example.com' }, { text: 'Learn More', href: 'about' }]} \n />\n</ThemeProvider>",
|
||||
"do": [
|
||||
"Use for landing pages with social proof",
|
||||
"Use for product showcases with testimonials",
|
||||
"Use when customer reviews add credibility",
|
||||
"Use when centered layout is preferred over split",
|
||||
"Requires testimonials[]",
|
||||
"Requires buttons?[]",
|
||||
"Requires avatars?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
91
registry/components/HeroCarouselLogo.json
Normal file
91
registry/components/HeroCarouselLogo.json
Normal file
@@ -0,0 +1,91 @@
|
||||
{
|
||||
"name": "HeroCarouselLogo",
|
||||
"description": "Full-screen hero section with auto-playing carousel background, large text logo at bottom that scales to fill container width, description and button row above, with progress bars and linear gradient blur overlay.",
|
||||
"details": "Use for brand-focused landing pages with multiple background images/videos that auto-rotate. Combines auto-playing carousel with logo layout. Features full viewport height with carousel of background media slides (image or video), auto-advancing with customizable delay (default 3000ms). Linear gradient blur overlay at bottom (75vh height) for improved logo visibility. Large responsive text logo automatically fills the container width below content. Above logo is horizontal row with description text on left and up to 2 buttons on right (stacked vertically on mobile). Progress bars at bottom show carousel progress with animated fill. Users can click progress bars to navigate slides directly.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"logoText": {
|
||||
"required": true,
|
||||
"example": "WEBILD",
|
||||
"minChars": 2,
|
||||
"maxChars": 20
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Create stunning, responsive websites with our comprehensive component library",
|
||||
"minChars": 5,
|
||||
"maxChars": 200
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"slides": {
|
||||
"required": true,
|
||||
"example": "[{ imageSrc: '/slide1.jpg', imageAlt: 'Slide 1' }, { imageSrc: '/slide2.jpg', imageAlt: 'Slide 2' }]",
|
||||
"note": "Array of CarouselSlide objects. Each slide can have imageSrc, videoSrc, imageAlt, videoAriaLabel. Video takes precedence over image if both provided in a slide."
|
||||
},
|
||||
"autoplayDelay": {
|
||||
"required": false,
|
||||
"default": 3000,
|
||||
"note": "Milliseconds between automatic slide transitions"
|
||||
},
|
||||
"showDimOverlay": {
|
||||
"required": false,
|
||||
"default": false,
|
||||
"note": "Adds semi-transparent dark overlay (bg-background/20) over background media for improved text and logo contrast"
|
||||
}
|
||||
},
|
||||
"buttonRules": {
|
||||
"maxButtons": 2,
|
||||
"structure": {
|
||||
"text": "string - Button label (required)",
|
||||
"href": "string - Link destination (optional). External URLs (https://, http://, www.) open in new tab. Internal values (e.g., 'about', 'contact') scroll to #about, #contact sections",
|
||||
"onClick": "() => void - Additional click handler (optional)",
|
||||
"props": "Partial<ButtonPropsForVariant> - Additional button props like className, textClassName (optional)"
|
||||
},
|
||||
"examples": [
|
||||
"{ text: 'Get Started', href: 'https://github.com' }",
|
||||
"{ text: 'Learn More', href: 'about' }"
|
||||
],
|
||||
"note": "Buttons are required (cannot be empty array). Button variant is controlled by ThemeProvider's defaultButtonVariant. Border radius is controlled by ThemeProvider's borderRadius (options: 'sharp', 'rounded', 'soft', 'pill'). All sections should be wrapped in a single ThemeProvider at the app/page level to maintain consistent styling across the entire site."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"logoText": "string",
|
||||
"description": "string",
|
||||
"buttons": "Array<{text: string, onClick?: () => void, href?: string}> (required)",
|
||||
"slides": "Array<{ imageSrc?: string, videoSrc?: string, imageAlt?: string, videoAriaLabel?: string }> - Carousel slide items",
|
||||
"autoplayDelay?": "number (default: 3000)",
|
||||
"showDimOverlay?": "boolean (default: false)",
|
||||
"ariaLabel?": "string (default: 'Hero section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"contentContainerClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"logoContainerClassName?": "string",
|
||||
"logoClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"imageClassName?": "string",
|
||||
"blurClassName?": "string",
|
||||
"dimOverlayClassName?": "string",
|
||||
"progressBarClassName?": "string"
|
||||
},
|
||||
"usageExample": "<ThemeProvider defaultButtonVariant=\"icon-arrow\" defaultTextAnimation=\"entrance-slide\" borderRadius=\"pill\">\n <HeroCarouselLogo \n logoText=\"WEBILD\" \n description=\"Create stunning, responsive websites with our comprehensive component library\" \n buttons={[{ text: 'Get Started', href: 'https://github.com' }, { text: 'Learn More', href: 'about' }]} \n slides={[{ imageSrc: '/slide1.jpg', imageAlt: 'Slide 1' }, { imageSrc: '/slide2.jpg', imageAlt: 'Slide 2' }, { imageSrc: '/slide3.jpg', imageAlt: 'Slide 3' }]}\n autoplayDelay={5000}\n />\n</ThemeProvider>",
|
||||
"do": [
|
||||
"Use for landing pages",
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Requires buttons[]",
|
||||
"Requires slides[]"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use less than 5 items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
92
registry/components/HeroCentered.json
Normal file
92
registry/components/HeroCentered.json
Normal file
@@ -0,0 +1,92 @@
|
||||
{
|
||||
"name": "HeroCentered",
|
||||
"description": "Full-screen centered hero section with avatar group above title, centered text content, configurable background, and optional buttons.",
|
||||
"details": "Use for impactful landing pages with social proof emphasis. Features full viewport height (h-svh on mobile, h-screen on desktop) with vertically and horizontally centered content. Avatar group with optional text is displayed above the title for social proof. Includes animated title and description via TextBox, required background variant, and up to 2 CTA buttons. No media content below - purely text-focused hero.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Build Modern Web Experiences",
|
||||
"minChars": 2,
|
||||
"maxChars": 60
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Create stunning, responsive websites with our comprehensive component library",
|
||||
"minChars": 5,
|
||||
"maxChars": 200
|
||||
},
|
||||
"avatarText": {
|
||||
"required": false,
|
||||
"example": "Trusted by 1000+ users",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
}
|
||||
},
|
||||
"avatarRules": {
|
||||
"avatars": {
|
||||
"required": true,
|
||||
"minItems": 1,
|
||||
"maxItems": 5,
|
||||
"structure": {
|
||||
"src": "string - Avatar image source (required)",
|
||||
"alt": "string - Alt text for accessibility (required)"
|
||||
},
|
||||
"note": "Avatars are displayed above the title for social proof"
|
||||
}
|
||||
},
|
||||
"buttonRules": {
|
||||
"maxButtons": 2,
|
||||
"structure": {
|
||||
"text": "string - Button label (required)",
|
||||
"href": "string - Link destination (optional). External URLs open in new tab. Internal values scroll to sections",
|
||||
"onClick": "() => void - Additional click handler (optional)"
|
||||
},
|
||||
"note": "Button variant is controlled by ThemeProvider's defaultButtonVariant"
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string",
|
||||
"description": "string",
|
||||
"background": "{ variant: 'plain' | 'animated-grid' | 'canvas-reveal' | 'cell-wave' | 'downward-rays-animated' | 'downward-rays-animated-grid' | 'downward-rays-static' | 'downward-rays-static-grid' | 'gradient-bars' | 'radial-gradient' | 'rotated-rays-animated' | 'rotated-rays-animated-grid' | 'rotated-rays-static' | 'rotated-rays-static-grid' | 'sparkles-gradient' }",
|
||||
"avatars": "Array<{ src: string, alt: string }> (required)",
|
||||
"avatarText?": "string",
|
||||
"buttons?": "Array<{ text: string, onClick?: () => void, href?: string }>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"ariaLabel?": "string (default: 'Hero section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"avatarGroupClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"marqueeItems?": "Array<{ type: 'image', src: string, alt?: string } | { type: 'text', text: string } | { type: 'text-icon', text: string, icon: LucideIcon }> - Optional marquee at bottom of hero",
|
||||
"marqueeSpeed?": "number (default: 30)",
|
||||
"showMarqueeCard?": "boolean (default: true) - Card styling for text/text-icon items, images never have cards",
|
||||
"marqueeClassName?": "string",
|
||||
"marqueeItemClassName?": "string",
|
||||
"marqueeCardClassName?": "string",
|
||||
"marqueeImageClassName?": "string",
|
||||
"marqueeTextClassName?": "string",
|
||||
"marqueeIconClassName?": "string"
|
||||
},
|
||||
"usageExample": "<ThemeProvider defaultButtonVariant=\"hover-bubble\" defaultTextAnimation=\"entrance-slide\" borderRadius=\"pill\">\n <HeroCentered \n background={{ variant: 'downward-rays-static' }}\n avatars={[{ src: '/avatar1.jpg', alt: 'User 1' }, { src: '/avatar2.jpg', alt: 'User 2' }, { src: '/avatar3.jpg', alt: 'User 3' }]}\n avatarText=\"Trusted by 1000+ users\"\n title=\"Build Modern Web Experiences\" \n description=\"Create stunning, responsive websites with our comprehensive component library\" \n buttons={[{ text: 'Get Started', href: 'https://example.com' }, { text: 'Learn More', href: 'about' }]} \n />\n</ThemeProvider>",
|
||||
"do": [
|
||||
"Use for impactful landing pages with social proof emphasis",
|
||||
"Include avatars for social proof",
|
||||
"Use appropriate background variant",
|
||||
"Full viewport height - purely text-focused hero"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use without avatars",
|
||||
"Do not use for heroes with media content below"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
95
registry/components/HeroLogo.json
Normal file
95
registry/components/HeroLogo.json
Normal file
@@ -0,0 +1,95 @@
|
||||
{
|
||||
"name": "HeroLogo",
|
||||
"description": "Full-screen hero section with background media, large text logo at bottom that scales to fill container width, description and button row above, featuring a linear gradient blur overlay.",
|
||||
"details": "Use for brand-focused landing pages that emphasize logo and visual identity with strong background imagery. Features full viewport height with background media (image or video), linear gradient blur overlay at bottom (75vh height) for improved logo visibility, and large responsive text logo that automatically fills the container width. Above the logo is a horizontal row with description text on the left and up to 2 buttons on the right (stacked vertically on mobile).",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"logoText": {
|
||||
"required": true,
|
||||
"example": "Webild",
|
||||
"minChars": 2,
|
||||
"maxChars": 20
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Building the future of web design with innovative solutions",
|
||||
"minChars": 5,
|
||||
"maxChars": 200
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"imageSrc": {
|
||||
"required": false,
|
||||
"example": "/hero-background.jpg",
|
||||
"note": "Background image that fills the viewport. Supports external URLs with unoptimized prop Either imageSrc or videoSrc should be provided. Image is recommended if no videoSrc."
|
||||
},
|
||||
"videoSrc": {
|
||||
"required": false,
|
||||
"example": "/hero-background.mp4",
|
||||
"note": "Background video that fills the viewport. Takes precedence over imageSrc if both provided"
|
||||
},
|
||||
"imageAlt": {
|
||||
"required": false,
|
||||
"example": "Hero background",
|
||||
"note": "Empty string marks image as decorative (aria-hidden)"
|
||||
},
|
||||
"showDimOverlay": {
|
||||
"required": false,
|
||||
"default": false,
|
||||
"note": "Adds semi-transparent dark overlay (bg-background/20) over background media for improved text and logo contrast"
|
||||
}
|
||||
},
|
||||
"buttonRules": {
|
||||
"maxButtons": 2,
|
||||
"structure": {
|
||||
"text": "string - Button label (required)",
|
||||
"href": "string - Link destination (optional). External URLs (https://, http://, www.) open in new tab. Internal values (e.g., 'about', 'contact') scroll to #about, #contact sections",
|
||||
"onClick": "() => void - Additional click handler (optional)",
|
||||
"props": "Partial<ButtonPropsForVariant> - Additional button props like className, textClassName (optional)"
|
||||
},
|
||||
"examples": [
|
||||
"{ text: 'Get Started', href: 'https://github.com' }",
|
||||
"{ text: 'Learn More', href: 'about' }"
|
||||
],
|
||||
"note": "Buttons are required (cannot be empty array). Button variant is controlled by ThemeProvider's defaultButtonVariant. Border radius is controlled by ThemeProvider's borderRadius (options: 'sharp', 'rounded', 'soft', 'pill'). All sections should be wrapped in a single ThemeProvider at the app/page level to maintain consistent styling across the entire site."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"logoText": "string",
|
||||
"description": "string",
|
||||
"buttons": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"imageSrc?": "string",
|
||||
"videoSrc?": "string",
|
||||
"imageAlt?": "string (default: '')",
|
||||
"videoAriaLabel?": "string (default: 'Hero video')",
|
||||
"showDimOverlay?": "boolean (default: false)",
|
||||
"ariaLabel?": "string (default: 'Hero section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"contentContainerClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"logoContainerClassName?": "string",
|
||||
"logoClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"imageClassName?": "string",
|
||||
"blurClassName?": "string",
|
||||
"dimOverlayClassName?": "string"
|
||||
},
|
||||
"usageExample": "<ThemeProvider defaultButtonVariant=\"hover-bubble\" defaultTextAnimation=\"entrance-slide\" borderRadius=\"pill\">\n <HeroLogo \n logoText=\"Webild\" \n description=\"Building the future of web design with innovative solutions\" \n buttons={[{ text: 'Get Started', href: 'https://github.com' }, { text: 'Learn More', href: 'about' }]} \n imageSrc=\"/placeholders/placeholder5.jpg\" \n imageAlt=\"Hero background\"\n />\n</ThemeProvider>",
|
||||
"do": [
|
||||
"Use for landing pages",
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Requires buttons[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
87
registry/components/HeroLogoBillboard.json
Normal file
87
registry/components/HeroLogoBillboard.json
Normal file
@@ -0,0 +1,87 @@
|
||||
{
|
||||
"name": "HeroLogoBillboard",
|
||||
"description": "Hero section with large text logo at top that scales to fill container width, description text, and single framed media (card or browser style) below.",
|
||||
"details": "Use for brand-focused landing pages that emphasize logo with a key hero image or video. Features large responsive text logo that automatically fills the container width at the top, followed by description text aligned to the right (desktop) or centered (mobile), and single media below with optional card or browser frame styling. Description text is larger on desktop (text-3xl) than mobile (text-lg). Media can be displayed in simple card frame or browser mockup with address bar.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"logoText": {
|
||||
"required": true,
|
||||
"example": "klime studio",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "we help driven founders build the brands of tomorrow through websites, product design & branding.",
|
||||
"minChars": 5,
|
||||
"maxChars": 300
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"imageSrc": {
|
||||
"required": false,
|
||||
"example": "/hero-image.jpg",
|
||||
"note": "Supports external URLs with unoptimized prop Either imageSrc or videoSrc should be provided. Image is recommended if no videoSrc."
|
||||
},
|
||||
"videoSrc": {
|
||||
"required": false,
|
||||
"example": "/hero-video.mp4",
|
||||
"note": "Takes precedence over imageSrc if both provided"
|
||||
},
|
||||
"imageAlt": {
|
||||
"required": false,
|
||||
"example": "Product showcase",
|
||||
"note": "Empty string marks image as decorative (aria-hidden)"
|
||||
},
|
||||
"frameStyle": {
|
||||
"required": false,
|
||||
"options": [
|
||||
"card",
|
||||
"browser"
|
||||
],
|
||||
"default": "card",
|
||||
"note": "'card' displays media in simple card with padding. 'browser' wraps media in browser mockup with address bar and window controls."
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"logoText": "string",
|
||||
"description": "string",
|
||||
"buttons": "Array<{ text: string, onClick?: () => void, href?: string }> - Primary and secondary buttons (required, max 2)",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"background": "{ variant: 'plain' | 'animated-grid' | 'canvas-reveal' | 'cell-wave' | 'downward-rays-animated' | 'downward-rays-animated-grid' | 'downward-rays-static' | 'downward-rays-static-grid' | 'glowing-orb' | 'gradient-bars' | 'radial-gradient' | 'rotated-rays-animated' | 'rotated-rays-animated-grid' | 'rotated-rays-static' | 'rotated-rays-static-grid' | 'sparkles-gradient' }",
|
||||
"imageSrc?": "string",
|
||||
"videoSrc?": "string",
|
||||
"imageAlt?": "string (default: '')",
|
||||
"videoAriaLabel?": "string (default: 'Hero video')",
|
||||
"mediaAnimation": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"frameStyle?": "'card' | 'browser' (default: 'card')",
|
||||
"ariaLabel?": "string (default: 'Hero section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"logoContainerClassName?": "string",
|
||||
"logoClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"imageClassName?": "string",
|
||||
"browserBarClassName?": "string",
|
||||
"addressBarClassName?": "string"
|
||||
},
|
||||
"usageExample": "<ThemeProvider defaultButtonVariant=\"text-stagger\" defaultTextAnimation=\"entrance-slide\" borderRadius=\"pill\" cardStyle=\"layered-gradient\">\n <HeroLogoBillboard \n logoText=\"klime studio\" \n description=\"we help driven founders build the brands of tomorrow through websites, product design & branding.\"\n buttons={[{ text: 'Get Started' }, { text: 'Learn More' }]}\n background={{ variant: \"sparkles-gradient\" }}\n imageSrc=\"/hero.jpg\"\n imageAlt=\"Hero showcase\"\n frameStyle=\"card\"\n />\n</ThemeProvider>",
|
||||
"do": [
|
||||
"Use for landing pages",
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use multiple items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
114
registry/components/HeroOverlay.json
Normal file
114
registry/components/HeroOverlay.json
Normal file
@@ -0,0 +1,114 @@
|
||||
{
|
||||
"name": "HeroOverlay",
|
||||
"description": "Full-screen hero section with background image/video overlay, circular blur effect, and bottom-left text positioning.",
|
||||
"details": "Use for dramatic, immersive landing pages with strong visual impact. Features full viewport height with background media (image or video), text overlay positioned at bottom-left for modern editorial layouts. Includes optional circular blur effect with radial gradient mask (enabled by default) and optional dim overlay for improved text readability. Text automatically styled with light colors for visibility over background media.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Build Modern Web Experiences",
|
||||
"minChars": 2,
|
||||
"maxChars": 40
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Create stunning, responsive websites with our comprehensive component library",
|
||||
"minChars": 5,
|
||||
"maxChars": 200
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "New Release",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"imageSrc": {
|
||||
"required": false,
|
||||
"example": "/hero-background.jpg",
|
||||
"note": "Background image that fills the viewport. Supports external URLs with unoptimized prop Either imageSrc or videoSrc should be provided. Image is recommended if no videoSrc."
|
||||
},
|
||||
"videoSrc": {
|
||||
"required": false,
|
||||
"example": "/hero-background.mp4",
|
||||
"note": "Background video that fills the viewport. Takes precedence over imageSrc if both provided"
|
||||
},
|
||||
"imageAlt": {
|
||||
"required": false,
|
||||
"example": "Hero background",
|
||||
"note": "Empty string marks image as decorative (aria-hidden)"
|
||||
},
|
||||
"showBlur": {
|
||||
"required": false,
|
||||
"default": true,
|
||||
"note": "Controls circular blur effect with radial gradient at bottom-left corner"
|
||||
},
|
||||
"showDimOverlay": {
|
||||
"required": false,
|
||||
"default": false,
|
||||
"note": "Adds semi-transparent dark overlay (bg-background/20) over background media for improved text contrast"
|
||||
}
|
||||
},
|
||||
"buttonRules": {
|
||||
"maxButtons": 2,
|
||||
"structure": {
|
||||
"text": "string - Button label (required)",
|
||||
"href": "string - Link destination (optional). External URLs (https://, http://, www.) open in new tab. Internal values (e.g., 'about', 'contact') scroll to #about, #contact sections",
|
||||
"onClick": "() => void - Additional click handler (optional)",
|
||||
"props": "Partial<ButtonPropsForVariant> - Additional button props like className, textClassName (optional)"
|
||||
},
|
||||
"examples": [
|
||||
"{ text: 'Get Started', href: 'https://example.com' }",
|
||||
"{ text: 'Learn More', href: 'about' }"
|
||||
],
|
||||
"note": "Button variant is controlled by ThemeProvider's defaultButtonVariant. Border radius is controlled by ThemeProvider's borderRadius (options: 'sharp', 'rounded', 'soft', 'pill'). All sections should be wrapped in a single ThemeProvider at the app/page level to maintain consistent styling across the entire site."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"avatars?": "Array<{ src: string, alt: string }>",
|
||||
"avatarText?": "string",
|
||||
"imageSrc?": "string",
|
||||
"videoSrc?": "string",
|
||||
"imageAlt?": "string (default: '')",
|
||||
"videoAriaLabel?": "string (default: 'Hero video')",
|
||||
"showDimOverlay?": "boolean (default: false)",
|
||||
"showBlur?": "boolean (default: true)",
|
||||
"textPosition?": "'top' | 'bottom' (default: 'bottom')",
|
||||
"ariaLabel?": "string (default: 'Hero section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"avatarGroupClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"imageClassName?": "string",
|
||||
"blurClassName?": "string",
|
||||
"dimOverlayClassName?": "string"
|
||||
},
|
||||
"usageExample": "<ThemeProvider defaultButtonVariant=\"hover-bubble\" defaultTextAnimation=\"entrance-slide\" borderRadius=\"pill\">\n <HeroOverlay \n title=\"Build Modern Web Experiences\" \n description=\"Create stunning, responsive websites with our comprehensive component library\" \n tag=\"New Release\" \n imageSrc=\"/hero-background.jpg\" \n imageAlt=\"Hero background\"\n showBlur={true}\n showDimOverlay={false}\n buttons={[{ text: 'Get Started', href: 'https://example.com' }, { text: 'Learn More', href: 'about' }]} \n />\n</ThemeProvider>",
|
||||
"do": [
|
||||
"Use for landing pages",
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
167
registry/components/HeroOverlayTestimonial.json
Normal file
167
registry/components/HeroOverlayTestimonial.json
Normal file
@@ -0,0 +1,167 @@
|
||||
{
|
||||
"name": "HeroOverlayTestimonial",
|
||||
"description": "Full-screen hero section with background image/video overlay, circular blur effect, bottom-left text positioning, and rotating testimonial card.",
|
||||
"details": "Use for dramatic, immersive landing pages with strong visual impact and social proof. Features full viewport height with background media (image or video), text overlay positioned at bottom-left for modern editorial layouts, and a testimonial card with star ratings at bottom-right. Includes optional circular blur effect with radial gradient mask (enabled by default) and optional dim overlay for improved text readability. Testimonials rotate automatically with configurable interval. Text automatically styled with light colors for visibility over background media. Testimonial card is hidden on mobile for better layout.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Build Modern Web Experiences",
|
||||
"minChars": 2,
|
||||
"maxChars": 40
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Create stunning, responsive websites with our comprehensive component library",
|
||||
"minChars": 5,
|
||||
"maxChars": 200
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "New Release",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"testimonialRules": {
|
||||
"name": {
|
||||
"required": true,
|
||||
"example": "Sarah Johnson",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"handle": {
|
||||
"required": true,
|
||||
"example": "CEO, TechCorp",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"testimonial": {
|
||||
"required": true,
|
||||
"example": "This component library transformed our development workflow.",
|
||||
"minChars": 10,
|
||||
"maxChars": 200
|
||||
},
|
||||
"rating": {
|
||||
"required": true,
|
||||
"example": 5,
|
||||
"min": 1,
|
||||
"max": 5
|
||||
},
|
||||
"imageSrc": {
|
||||
"required": false,
|
||||
"example": "/testimonials/sarah.jpg"
|
||||
},
|
||||
"imageAlt": {
|
||||
"required": false,
|
||||
"example": "Sarah Johnson"
|
||||
}
|
||||
},
|
||||
"itemRules": {
|
||||
"minItems": 1,
|
||||
"maxItems": 10,
|
||||
"recommendedItems": "3-5",
|
||||
"note": "Multiple testimonials rotate automatically. At least one testimonial required."
|
||||
},
|
||||
"mediaRules": {
|
||||
"imageSrc": {
|
||||
"required": false,
|
||||
"example": "/hero-background.jpg",
|
||||
"note": "Background image that fills the viewport. Supports external URLs with unoptimized prop. Either imageSrc or videoSrc should be provided. Image is recommended if no videoSrc."
|
||||
},
|
||||
"videoSrc": {
|
||||
"required": false,
|
||||
"example": "/hero-background.mp4",
|
||||
"note": "Background video that fills the viewport. Takes precedence over imageSrc if both provided"
|
||||
},
|
||||
"imageAlt": {
|
||||
"required": false,
|
||||
"example": "Hero background",
|
||||
"note": "Empty string marks image as decorative (aria-hidden)"
|
||||
},
|
||||
"showBlur": {
|
||||
"required": false,
|
||||
"default": true,
|
||||
"note": "Controls circular blur effect with radial gradient at bottom-left corner"
|
||||
},
|
||||
"showDimOverlay": {
|
||||
"required": false,
|
||||
"default": false,
|
||||
"note": "Adds semi-transparent dark overlay (bg-background/20) over background media for improved text contrast"
|
||||
}
|
||||
},
|
||||
"buttonRules": {
|
||||
"maxButtons": 2,
|
||||
"structure": {
|
||||
"text": "string - Button label (required)",
|
||||
"href": "string - Link destination (optional). External URLs (https://, http://, www.) open in new tab. Internal values (e.g., 'about', 'contact') scroll to #about, #contact sections",
|
||||
"onClick": "() => void - Additional click handler (optional)",
|
||||
"props": "Partial<ButtonPropsForVariant> - Additional button props like className, textClassName (optional)"
|
||||
},
|
||||
"examples": [
|
||||
"{ text: 'Get Started', href: 'https://example.com' }",
|
||||
"{ text: 'Learn More', href: 'about' }"
|
||||
],
|
||||
"note": "Button variant is controlled by ThemeProvider's defaultButtonVariant. Border radius is controlled by ThemeProvider's borderRadius (options: 'sharp', 'rounded', 'soft', 'pill'). All sections should be wrapped in a single ThemeProvider at the app/page level to maintain consistent styling across the entire site."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string",
|
||||
"description": "string",
|
||||
"testimonials": "Array<{ name: string, handle: string, testimonial: string, rating: number, imageSrc?: string, imageAlt?: string }>",
|
||||
"testimonialRotationInterval?": "number (default: 5000)",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"avatars?": "Array<{ src: string, alt: string }>",
|
||||
"avatarText?": "string",
|
||||
"imageSrc?": "string",
|
||||
"videoSrc?": "string",
|
||||
"imageAlt?": "string (default: '')",
|
||||
"videoAriaLabel?": "string (default: 'Hero video')",
|
||||
"showDimOverlay?": "boolean (default: false)",
|
||||
"showBlur?": "boolean (default: true)",
|
||||
"textPosition?": "'top' | 'bottom' (default: 'bottom')",
|
||||
"ariaLabel?": "string (default: 'Hero section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"avatarGroupClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"imageClassName?": "string",
|
||||
"blurClassName?": "string",
|
||||
"dimOverlayClassName?": "string",
|
||||
"testimonialCardClassName?": "string",
|
||||
"testimonialContentClassName?": "string",
|
||||
"testimonialTextClassName?": "string",
|
||||
"testimonialRatingClassName?": "string",
|
||||
"testimonialAuthorClassName?": "string",
|
||||
"testimonialAuthorImageClassName?": "string",
|
||||
"testimonialAuthorNameClassName?": "string",
|
||||
"testimonialAuthorHandleClassName?": "string"
|
||||
},
|
||||
"usageExample": "<ThemeProvider defaultButtonVariant=\"hover-bubble\" defaultTextAnimation=\"entrance-slide\" borderRadius=\"pill\">\n <HeroOverlayTestimonial \n title=\"Build Modern Web Experiences\" \n description=\"Create stunning, responsive websites with our comprehensive component library\" \n tag=\"New Release\" \n imageSrc=\"/hero-background.jpg\" \n imageAlt=\"Hero background\"\n showBlur={true}\n showDimOverlay={false}\n testimonials={[{ name: 'Sarah Johnson', handle: 'CEO, TechCorp', testimonial: 'This transformed our workflow!', rating: 5 }]}\n buttons={[{ text: 'Get Started', href: 'https://example.com' }, { text: 'Learn More', href: 'about' }]} \n />\n</ThemeProvider>",
|
||||
"do": [
|
||||
"Use for landing pages",
|
||||
"Use for feature showcases",
|
||||
"Use for social proof sections",
|
||||
"Requires testimonials[]"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use without testimonials",
|
||||
"Do not use less than 1 testimonial"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
81
registry/components/HeroPersonalLinks.json
Normal file
81
registry/components/HeroPersonalLinks.json
Normal file
@@ -0,0 +1,81 @@
|
||||
{
|
||||
"name": "HeroPersonalLinks",
|
||||
"description": "Full-screen centered hero section with title, social link buttons, and link cards for personal/portfolio pages.",
|
||||
"details": "Use for single-section personal brand websites (link-in-bio style). Features a centered title with optional title segments for inline images, social media link buttons, and link cards with icon/media content. Each link card has a title, description, and action button. Can optionally include a footer section.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Hi, I'm John Doe",
|
||||
"minChars": 2,
|
||||
"maxChars": 36
|
||||
}
|
||||
},
|
||||
"socialLinkRules": {
|
||||
"required": false,
|
||||
"structure": {
|
||||
"icon": "LucideIcon",
|
||||
"label": "string - Display label",
|
||||
"href": "string - Link destination"
|
||||
},
|
||||
"note": "Array of social media links displayed as pill buttons"
|
||||
},
|
||||
"linkCardRules": {
|
||||
"required": true,
|
||||
"minItems": 1,
|
||||
"structure": {
|
||||
"icon": "LucideIcon (optional if imageSrc/videoSrc provided)",
|
||||
"imageSrc": "string - Image source (optional) Image is recommended if no videoSrc.",
|
||||
"videoSrc": "string - Video source (optional)",
|
||||
"imageAlt": "string - Alt text for image",
|
||||
"videoAriaLabel": "string - Aria label for video",
|
||||
"title": "string - Card title",
|
||||
"description": "string - Card description",
|
||||
"button": "ButtonConfig - Card action button"
|
||||
},
|
||||
"note": "Array of link cards with icon/media, title, description, and action button"
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"background": "{ variant: 'plain' | 'animated-grid' | 'canvas-reveal' | 'cell-wave' | 'downward-rays-animated' | 'downward-rays-animated-grid' | 'downward-rays-static' | 'downward-rays-static-grid' | 'gradient-bars' | 'radial-gradient' | 'rotated-rays-animated' | 'rotated-rays-animated-grid' | 'rotated-rays-static' | 'rotated-rays-static-grid' | 'sparkles-gradient' }",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"socialLinks?": "Array<{ icon: LucideIcon, label: string, href: string }> - Social media links",
|
||||
"linkCards": "Array<{ icon?: LucideIcon, imageSrc?: string, videoSrc?: string, imageAlt?: string, videoAriaLabel?: string, title: string, description: string, button: ButtonConfig }> (required)",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"ariaLabel?": "string (default: 'Personal links section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textboxClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"titleImageWrapperClassName?": "string",
|
||||
"titleImageClassName?": "string",
|
||||
"socialLinksClassName?": "string",
|
||||
"socialLinkClassName?": "string",
|
||||
"linkCardsClassName?": "string",
|
||||
"linkCardClassName?": "string",
|
||||
"linkCardIconClassName?": "string",
|
||||
"linkCardTitleClassName?": "string",
|
||||
"linkCardDescriptionClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<HeroPersonalLinks background={{ variant: 'plain' }} title=\"Hi, I'm John Doe\" socialLinks={[{ icon: Twitter, label: 'Twitter', href: 'https://twitter.com' }, { icon: Linkedin, label: 'LinkedIn', href: 'https://linkedin.com' }]} linkCards={[{ icon: Briefcase, title: 'My Portfolio', description: 'Check out my latest work', button: { text: 'View', href: '/portfolio' } }, { imageSrc: '/project.jpg', title: 'Latest Project', description: 'A new design system', button: { text: 'Explore', href: '/project' } }]} />",
|
||||
"do": [
|
||||
"Use only for single-section personal brand websites (link-in-bio style)",
|
||||
"Can optionally include a footer section",
|
||||
"Include at least one link card",
|
||||
"Use social links for social media presence"
|
||||
],
|
||||
"dont": [
|
||||
"Never use with other sections",
|
||||
"Never use for multi-page or multi-section websites",
|
||||
"Do not use without link cards",
|
||||
"Do not use for product or company landing pages"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
80
registry/components/HeroSignup.json
Normal file
80
registry/components/HeroSignup.json
Normal file
@@ -0,0 +1,80 @@
|
||||
{
|
||||
"name": "HeroSignup",
|
||||
"description": "Full-screen centered hero section with tag badge above title, centered text content, configurable background, and email signup form below.",
|
||||
"details": "Use for lead generation landing pages focused on email capture. Features full viewport height (h-svh on mobile, h-screen on desktop) with vertically and horizontally centered content. Tag badge with optional icon is displayed above the title. Includes animated title and description via TextBox, required background variant, and EmailSignupForm for newsletter/early access signups. No buttons prop - CTA is the email signup form.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Join the Future of Web Development",
|
||||
"minChars": 2,
|
||||
"maxChars": 60
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Be the first to experience our revolutionary platform. Sign up now and get exclusive early access.",
|
||||
"minChars": 5,
|
||||
"maxChars": 200
|
||||
},
|
||||
"tag": {
|
||||
"required": true,
|
||||
"example": "Early Access",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
},
|
||||
"inputPlaceholder": {
|
||||
"required": false,
|
||||
"example": "Enter your email",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"buttonText": {
|
||||
"required": false,
|
||||
"example": "Get Early Access",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string (required)",
|
||||
"description": "string (required)",
|
||||
"background": "{ variant: 'plain' | 'animated-grid' | 'canvas-reveal' | 'cell-wave' | 'downward-rays-animated' | 'downward-rays-animated-grid' | 'downward-rays-static' | 'downward-rays-static-grid' | 'glowing-orb' | 'glowing-orb-sparkles' | 'gradient-bars' | 'radial-gradient' | 'rotated-rays-animated' | 'rotated-rays-animated-grid' | 'rotated-rays-static' | 'rotated-rays-static-grid' | 'sparkles-gradient' }",
|
||||
"tag": "string (required)",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"inputPlaceholder?": "string (default: 'Enter your email')",
|
||||
"buttonText?": "string (default: 'Get Started')",
|
||||
"onSubmit?": "(email: string) => void",
|
||||
"ariaLabel?": "string (default: 'Hero section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"formWrapperClassName?": "string",
|
||||
"formClassName?": "string",
|
||||
"inputClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<ThemeProvider defaultButtonVariant=\"hover-bubble\" defaultTextAnimation=\"entrance-slide\" borderRadius=\"pill\">\n <HeroSignup \n background={{ variant: 'sparkles-gradient' }}\n tag=\"Early Access\"\n tagIcon={Sparkles}\n title=\"Join the Future of Web Development\" \n description=\"Be the first to experience our revolutionary platform. Sign up now and get exclusive early access.\" \n inputPlaceholder=\"Enter your email\"\n buttonText=\"Get Early Access\"\n onSubmit={(email) => console.log('Email:', email)}\n />\n</ThemeProvider>",
|
||||
"do": [
|
||||
"Use ONLY for waitlist or coming soon websites",
|
||||
"Use for single-page early access email capture",
|
||||
"Include a compelling tag badge"
|
||||
],
|
||||
"dont": [
|
||||
"Never use for any other type of website",
|
||||
"Never use for multi-section websites",
|
||||
"Never use for product, company, or portfolio websites",
|
||||
"Do not use for heroes that need multiple CTA buttons",
|
||||
"Do not use for heroes with media content"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
121
registry/components/HeroSplit.json
Normal file
121
registry/components/HeroSplit.json
Normal file
@@ -0,0 +1,121 @@
|
||||
{
|
||||
"name": "HeroSplit",
|
||||
"description": "Split-layout hero section with configurable background, text content on one side, and single image/video on the other, with responsive centering.",
|
||||
"details": "Use for hero sections where visual content and text have equal weight. Features required background variant (choose from animated grids, gradient effects, glowing orb, or 'plain' for no background), split layout with configurable image position (left/right), one image or video with fixed height control. Responsive design centers content on mobile. Optional tag with icon and up to 2 CTA buttons. Text automatically centers on mobile and aligns left on desktop. Background variants include preset options for zero-config usage.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Build Better Products",
|
||||
"minChars": 2,
|
||||
"maxChars": 36
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Create exceptional user experiences with our design system",
|
||||
"minChars": 5,
|
||||
"maxChars": 200
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "New Release",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"imageSrc": {
|
||||
"required": false,
|
||||
"example": "/hero-image.jpg",
|
||||
"note": "Supports external URLs with unoptimized prop Either imageSrc or videoSrc should be provided. Image is recommended if no videoSrc."
|
||||
},
|
||||
"videoSrc": {
|
||||
"required": false,
|
||||
"example": "/hero-video.mp4",
|
||||
"note": "Takes precedence over imageSrc if both provided"
|
||||
},
|
||||
"imageAlt": {
|
||||
"required": false,
|
||||
"example": "Product showcase",
|
||||
"note": "Empty string marks image as decorative (aria-hidden)"
|
||||
},
|
||||
"imagePosition": {
|
||||
"required": false,
|
||||
"options": [
|
||||
"left",
|
||||
"right"
|
||||
],
|
||||
"default": "right"
|
||||
}
|
||||
},
|
||||
"buttonRules": {
|
||||
"maxButtons": 2,
|
||||
"structure": {
|
||||
"text": "string - Button label (required)",
|
||||
"href": "string - Link destination (optional). External URLs (https://, http://, www.) open in new tab. Internal values (e.g., 'about', 'contact') scroll to #about, #contact sections",
|
||||
"onClick": "() => void - Additional click handler (optional)",
|
||||
"props": "Partial<ButtonPropsForVariant> - Additional button props like className, textClassName (optional)"
|
||||
},
|
||||
"examples": [
|
||||
"{ text: 'Get Started', href: 'https://example.com' }",
|
||||
"{ text: 'Learn More', href: 'about' }"
|
||||
],
|
||||
"note": "Button variant is controlled by ThemeProvider's defaultButtonVariant. Border radius is controlled by ThemeProvider's borderRadius (options: 'sharp', 'rounded', 'soft', 'pill'). All sections should be wrapped in a single ThemeProvider at the app/page level to maintain consistent styling across the entire site."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string",
|
||||
"description": "string",
|
||||
"background": "{ variant: 'plain' | 'animated-grid' | 'canvas-reveal' | 'cell-wave' | 'downward-rays-animated' | 'downward-rays-animated-grid' | 'downward-rays-static' | 'downward-rays-static-grid' | 'glowing-orb' | 'gradient-bars' | 'radial-gradient' | 'rotated-rays-animated' | 'rotated-rays-animated-grid' | 'rotated-rays-static' | 'rotated-rays-static-grid' | 'sparkles-gradient' }",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"avatars?": "Avatar[] - Array of avatar objects with src and alt properties",
|
||||
"avatarText?": "string - Text displayed next to the avatar group",
|
||||
"imageSrc?": "string",
|
||||
"videoSrc?": "string",
|
||||
"imageAlt?": "string (default: '')",
|
||||
"videoAriaLabel?": "string (default: 'Hero video')",
|
||||
"mediaAnimation": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"ariaLabel?": "string (default: 'Hero section')",
|
||||
"imagePosition?": "'left' | 'right' (default: 'right')",
|
||||
"fixedMediaHeight?": "boolean (default: true) - When true, media wrapper is aspect-square on mobile and md:h-[65vh] on desktop",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"imageClassName?": "string",
|
||||
"avatarGroupClassName?": "string",
|
||||
"marqueeItems?": "Array<{ type: 'image', src: string, alt?: string } | { type: 'text', text: string } | { type: 'text-icon', text: string, icon: LucideIcon }> - Optional marquee at bottom of hero",
|
||||
"marqueeSpeed?": "number (default: 30)",
|
||||
"showMarqueeCard?": "boolean (default: true) - Card styling for text/text-icon items, images never have cards",
|
||||
"marqueeClassName?": "string",
|
||||
"marqueeItemClassName?": "string",
|
||||
"marqueeCardClassName?": "string",
|
||||
"marqueeImageClassName?": "string",
|
||||
"marqueeTextClassName?": "string",
|
||||
"marqueeIconClassName?": "string"
|
||||
},
|
||||
"usageExample": "<ThemeProvider defaultButtonVariant=\"text-stagger\" defaultTextAnimation=\"entrance-slide\" borderRadius=\"rounded\" background=\"aurora\" cardStyle=\"glass-elevated\" primaryButtonStyle=\"gradient\" secondaryButtonStyle=\"glass\">\n <HeroSplit \n background={{ variant: 'glowing-orb' }}\n title=\"Build Better Products\" \n description=\"Create exceptional user experiences with our design system\" \n tag=\"New Release\"\n imagePosition=\"right\" \n imageSrc=\"/hero.jpg\"\n imageAlt=\"Product showcase\"\n buttons={[{ text: 'Start Building', href: 'https://example.com' }, { text: 'View Demo', href: 'demo' }]} \n />\n</ThemeProvider>",
|
||||
"do": [
|
||||
"Use for landing pages",
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Requires buttons?[]",
|
||||
"Requires avatars?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
130
registry/components/HeroSplitDoubleCarousel.json
Normal file
130
registry/components/HeroSplitDoubleCarousel.json
Normal file
@@ -0,0 +1,130 @@
|
||||
{
|
||||
"name": "HeroSplitDoubleCarousel",
|
||||
"description": "Split-layout hero section with text content on one side and two vertical marquee columns on the other, with items scrolling in opposite directions.",
|
||||
"details": "Use for landing pages, portfolios, and creative showcases. Features split layout with TextBox on one side and dual vertical carousels on the other. Left carousel scrolls up, right carousel scrolls down, creating a visually engaging infinite scroll effect. Each carousel item displays an image or video in a card container. Supports optional logo marquee at the bottom.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Build Modern Web Experiences",
|
||||
"minChars": 2,
|
||||
"maxChars": 36
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Create stunning, responsive websites with our comprehensive component library",
|
||||
"minChars": 5,
|
||||
"maxChars": 200
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "New Release",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"carouselRules": {
|
||||
"leftCarouselItems": {
|
||||
"required": true,
|
||||
"minItems": 4,
|
||||
"structure": {
|
||||
"imageSrc": "string - Path to image Image is recommended if no videoSrc.",
|
||||
"videoSrc": "string - Path to video (optional)",
|
||||
"imageAlt": "string - Alt text for image",
|
||||
"videoAriaLabel": "string - Aria label for video"
|
||||
},
|
||||
"note": "Items are duplicated 4x for seamless infinite scroll"
|
||||
},
|
||||
"rightCarouselItems": {
|
||||
"required": true,
|
||||
"minItems": 4,
|
||||
"structure": {
|
||||
"imageSrc": "string - Path to image Image is recommended if no videoSrc.",
|
||||
"videoSrc": "string - Path to video (optional)",
|
||||
"imageAlt": "string - Alt text for image",
|
||||
"videoAriaLabel": "string - Aria label for video"
|
||||
},
|
||||
"note": "Items are duplicated 4x for seamless infinite scroll"
|
||||
},
|
||||
"carouselPosition": {
|
||||
"required": false,
|
||||
"options": [
|
||||
"left",
|
||||
"right"
|
||||
],
|
||||
"default": "right"
|
||||
}
|
||||
},
|
||||
"buttonRules": {
|
||||
"maxButtons": 2,
|
||||
"structure": {
|
||||
"text": "string - Button label",
|
||||
"href": "string - Link destination (optional). External URLs (https://, http://, www.) open in new tab. Internal values (e.g., 'about', 'contact') scroll to #about, #contact sections",
|
||||
"onClick": "() => void - Additional click handler (optional)",
|
||||
"props": "Partial<ButtonPropsForVariant> - Additional button props like className, textClassName (optional)"
|
||||
},
|
||||
"examples": [
|
||||
"{ text: 'Get Started', href: 'https://example.com' }",
|
||||
"{ text: 'Learn More', href: 'about' }"
|
||||
],
|
||||
"note": "Button variant is controlled by ThemeProvider's defaultButtonVariant. Border radius is controlled by ThemeProvider's borderRadius (options: 'sharp', 'rounded', 'soft', 'pill'). All sections should be wrapped in a single ThemeProvider at the app/page level to maintain consistent styling across the entire site."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string",
|
||||
"description": "string",
|
||||
"background": "{ variant: 'plain' | 'animated-grid' | 'canvas-reveal' | 'cell-wave' | 'downward-rays-animated' | 'downward-rays-animated-grid' | 'downward-rays-static' | 'downward-rays-static-grid' | 'glowing-orb' | 'gradient-bars' | 'radial-gradient' | 'rotated-rays-animated' | 'rotated-rays-animated-grid' | 'rotated-rays-static' | 'rotated-rays-static-grid' | 'sparkles-gradient' }",
|
||||
"leftCarouselItems": "Array<{ imageSrc?: string; videoSrc?: string; imageAlt?: string; videoAriaLabel?: string }>",
|
||||
"rightCarouselItems": "Array<{ imageSrc?: string; videoSrc?: string; imageAlt?: string; videoAriaLabel?: string }>",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"avatars?": "Avatar[] - Array of avatar objects with src and alt properties",
|
||||
"avatarText?": "string - Text displayed next to the avatar group",
|
||||
"carouselPosition?": "'left' | 'right' (default: 'right')",
|
||||
"ariaLabel?": "string (default: 'Hero section')",
|
||||
"marqueeItems?": "MarqueeItem[] - Optional logo marquee items for bottom of section",
|
||||
"marqueeSpeed?": "number (default: 30)",
|
||||
"showMarqueeCard?": "boolean (default: true)",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"carouselWrapperClassName?": "string",
|
||||
"carouselColumnClassName?": "string",
|
||||
"carouselItemClassName?": "string",
|
||||
"carouselImageClassName?": "string",
|
||||
"avatarGroupClassName?": "string",
|
||||
"marqueeClassName?": "string",
|
||||
"marqueeItemClassName?": "string",
|
||||
"marqueeCardClassName?": "string",
|
||||
"marqueeImageClassName?": "string",
|
||||
"marqueeTextClassName?": "string",
|
||||
"marqueeIconClassName?": "string"
|
||||
},
|
||||
"usageExample": "<HeroSplitDoubleCarousel background={{ variant: 'glowing-orb' }} tag=\"New Release\" tagIcon={Sparkles} title=\"Build Modern Web Experiences\" description=\"Create stunning, responsive websites with our comprehensive component library\" carouselPosition=\"right\" leftCarouselItems={[{ imageSrc: '/placeholder1.jpg', imageAlt: 'Gallery 1' }, { imageSrc: '/placeholder2.jpg', imageAlt: 'Gallery 2' }, { imageSrc: '/placeholder3.jpg', imageAlt: 'Gallery 3' }, { imageSrc: '/placeholder4.jpg', imageAlt: 'Gallery 4' }]} rightCarouselItems={[{ imageSrc: '/placeholder5.jpg', imageAlt: 'Gallery 5' }, { imageSrc: '/placeholder6.jpg', imageAlt: 'Gallery 6' }, { imageSrc: '/placeholder7.jpg', imageAlt: 'Gallery 7' }, { imageSrc: '/placeholder8.jpg', imageAlt: 'Gallery 8' }]} buttons={[{ text: 'Get Started', href: 'https://example.com' }, { text: 'Learn More', href: 'about' }]} />",
|
||||
"do": [
|
||||
"Use for landing pages with visual portfolios",
|
||||
"Use for image galleries and creative showcases",
|
||||
"Use when you want continuous visual motion",
|
||||
"Requires leftCarouselItems[]",
|
||||
"Requires rightCarouselItems[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use with fewer than 4 items per column",
|
||||
"Do not use when static media is preferred"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
109
registry/components/HeroSplitDualMedia.json
Normal file
109
registry/components/HeroSplitDualMedia.json
Normal file
@@ -0,0 +1,109 @@
|
||||
{
|
||||
"name": "HeroSplitDualMedia",
|
||||
"description": "Split-layout hero section with configurable background, text content with rating on one side, and dual image/video grid on the other.",
|
||||
"details": "Use for coaching, consulting, or service-focused landing pages. Features full viewport height (h-svh on mobile, h-screen on desktop) with responsive split layout. Left side contains TextBox with tag, title, description, buttons, and a rating section with star icons. Right side displays two media items in a 2-column grid layout. Rating section shows star icons with descriptive text below a divider line.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Transform your business with proven strategies",
|
||||
"minChars": 2,
|
||||
"maxChars": 60
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "I help entrepreneurs and executives unlock their full potential and build thriving businesses.",
|
||||
"minChars": 5,
|
||||
"maxChars": 200
|
||||
},
|
||||
"tag": {
|
||||
"required": true,
|
||||
"example": "Business Coach",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
},
|
||||
"ratingText": {
|
||||
"required": true,
|
||||
"example": "Rated by loving Clients",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"mediaItems": {
|
||||
"required": true,
|
||||
"note": "Array of exactly 2 media items. Each can have imageSrc or videoSrc.",
|
||||
"structure": {
|
||||
"imageSrc": "string - Path to image (optional if videoSrc provided) Image is recommended if no videoSrc.",
|
||||
"videoSrc": "string - Path to video (optional if imageSrc provided)",
|
||||
"imageAlt": "string - Alt text for image",
|
||||
"videoAriaLabel": "string - Aria label for video"
|
||||
},
|
||||
"example": "[{ imageSrc: '/image1.jpg', imageAlt: 'Coaching session' }, { imageSrc: '/image2.jpg', imageAlt: 'Business growth' }]"
|
||||
}
|
||||
},
|
||||
"ratingRules": {
|
||||
"rating": {
|
||||
"required": true,
|
||||
"note": "Number of stars to display (1-5)",
|
||||
"example": 5
|
||||
}
|
||||
},
|
||||
"buttonRules": {
|
||||
"maxButtons": 2,
|
||||
"structure": {
|
||||
"text": "string - Button label (required)",
|
||||
"href": "string - Link destination (optional)",
|
||||
"onClick": "() => void - Click handler (optional)",
|
||||
"props": "Partial<ButtonPropsForVariant> - Additional button props (optional)"
|
||||
},
|
||||
"note": "Button variant controlled by ThemeProvider's defaultButtonVariant."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string (required)",
|
||||
"description": "string (required)",
|
||||
"background": "{ variant: 'plain' | 'animated-grid' | 'canvas-reveal' | 'cell-wave' | 'downward-rays-animated' | 'downward-rays-animated-grid' | 'downward-rays-static' | 'downward-rays-static-grid' | 'glowing-orb' | 'gradient-bars' | 'radial-gradient' | 'rotated-rays-animated' | 'rotated-rays-animated-grid' | 'rotated-rays-static' | 'rotated-rays-static-grid' | 'sparkles-gradient' }",
|
||||
"tag": "string (required)",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"mediaItems": "[MediaItem, MediaItem] - Array of exactly 2 media items with imageSrc/videoSrc",
|
||||
"mediaAnimation": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"rating": "number (required) - Number of stars to display",
|
||||
"ratingText": "string (required) - Text displayed next to rating stars",
|
||||
"ariaLabel?": "string (default: 'Hero section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"mediaItemClassName?": "string",
|
||||
"imageClassName?": "string",
|
||||
"ratingClassName?": "string",
|
||||
"ratingTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<HeroSplitDualMedia background={{ variant: 'plain' }} tag=\"Business Coach\" tagIcon={Sparkles} title=\"Transform your business with proven strategies\" description=\"I help entrepreneurs and executives unlock their full potential and build thriving businesses.\" mediaItems={[{ imageSrc: '/image1.jpg', imageAlt: 'Coaching' }, { imageSrc: '/image2.jpg', imageAlt: 'Growth' }]} rating={5} ratingText=\"Rated by loving Clients\" buttons={[{ text: 'Book a Call', href: '#' }]} />",
|
||||
"do": [
|
||||
"Use for coaching, consulting, or service-focused landing pages",
|
||||
"Include exactly 2 media items",
|
||||
"Include star rating for social proof",
|
||||
"Full viewport height with split layout"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use without 2 media items",
|
||||
"Do not use without rating",
|
||||
"Do not use for product showcases"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
133
registry/components/HeroSplitKpi.json
Normal file
133
registry/components/HeroSplitKpi.json
Normal file
@@ -0,0 +1,133 @@
|
||||
{
|
||||
"name": "HeroSplitKpi",
|
||||
"description": "Split-layout hero with configurable background, media image/video, and three KPI metric boxes positioned around it.",
|
||||
"details": "Use for hero sections showcasing key performance metrics alongside visual content. Features required background variant (choose from animated grids, gradient effects, glowing orb, or 'plain' for no background), split layout with configurable image position (left/right). Displays media content (image or video) scaled to 75% within a card wrapper, with three KPI boxes positioned around it (top-left, right, bottom-left). Each KPI box shows a large value and label with glass styling and backdrop blur. Responsive design centers content on mobile with square aspect ratio. Optional tag with icon and CTA buttons. Background variants include preset options for zero-config usage.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "The Future of Supply Chain",
|
||||
"minChars": 2,
|
||||
"maxChars": 36
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Ship globally within 3 days post-production with smart fulfillment",
|
||||
"minChars": 5,
|
||||
"maxChars": 200
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Trusted by 150+ Brands",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"kpiRules": {
|
||||
"kpis": {
|
||||
"required": true,
|
||||
"note": "Array of exactly 3 KPI items. Each item has 'value' (the metric) and 'label' (description)",
|
||||
"structure": {
|
||||
"value": "string - The metric value (e.g., '99.8%', '10x', '4-10 Days')",
|
||||
"label": "string - Description of the metric (e.g., 'Order Accuracy')"
|
||||
},
|
||||
"example": "[{ value: '4-10 Days', label: 'Worldwide Delivery' }, { value: '99.8%', label: 'Order Accuracy' }, { value: '10x', label: 'Faster Lead Times' }]"
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"imageSrc": {
|
||||
"required": false,
|
||||
"example": "/hero-image.jpg",
|
||||
"note": "Image displayed in scaled card wrapper Either imageSrc or videoSrc should be provided. Image is recommended if no videoSrc."
|
||||
},
|
||||
"videoSrc": {
|
||||
"required": false,
|
||||
"example": "/hero-video.mp4",
|
||||
"note": "Video takes precedence over image if both provided"
|
||||
},
|
||||
"imageAlt": {
|
||||
"required": false,
|
||||
"example": "Product showcase",
|
||||
"note": "Empty string marks image as decorative (aria-hidden)"
|
||||
},
|
||||
"imagePosition": {
|
||||
"required": false,
|
||||
"options": [
|
||||
"left",
|
||||
"right"
|
||||
],
|
||||
"default": "right"
|
||||
}
|
||||
},
|
||||
"buttonRules": {
|
||||
"maxButtons": 2,
|
||||
"structure": {
|
||||
"text": "string - Button label (required)",
|
||||
"href": "string - Link destination (optional)",
|
||||
"onClick": "() => void - Additional click handler (optional)"
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string",
|
||||
"description": "string",
|
||||
"background": "{ variant: 'plain' | 'animated-grid' | 'canvas-reveal' | 'cell-wave' | 'downward-rays-animated' | 'downward-rays-animated-grid' | 'downward-rays-static' | 'downward-rays-static-grid' | 'glowing-orb' | 'gradient-bars' | 'radial-gradient' | 'rotated-rays-animated' | 'rotated-rays-animated-grid' | 'rotated-rays-static' | 'rotated-rays-static-grid' | 'sparkles-gradient' }",
|
||||
"kpis": "[KpiItem, KpiItem, KpiItem] - Array of exactly 3 KPI items with value and label",
|
||||
"enableKpiAnimation": "boolean - Enable/disable mouse-following animation on KPI boxes",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"avatars?": "Avatar[] - Array of avatar objects with src and alt properties",
|
||||
"avatarText?": "string - Text displayed next to the avatar group",
|
||||
"imageSrc?": "string",
|
||||
"videoSrc?": "string",
|
||||
"imageAlt?": "string (default: '')",
|
||||
"videoAriaLabel?": "string (default: 'Hero video')",
|
||||
"mediaAnimation": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"ariaLabel?": "string (default: 'Hero section')",
|
||||
"imagePosition?": "'left' | 'right' (default: 'right')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"imageClassName?": "string",
|
||||
"avatarGroupClassName?": "string",
|
||||
"kpiClassName?": "string",
|
||||
"kpiValueClassName?": "string",
|
||||
"kpiLabelClassName?": "string",
|
||||
"marqueeItems?": "Array<{ type: 'image', src: string, alt?: string } | { type: 'text', text: string } | { type: 'text-icon', text: string, icon: LucideIcon }> - Optional marquee at bottom of hero",
|
||||
"marqueeSpeed?": "number (default: 30)",
|
||||
"showMarqueeCard?": "boolean (default: true) - Card styling for text/text-icon items, images never have cards",
|
||||
"marqueeClassName?": "string",
|
||||
"marqueeItemClassName?": "string",
|
||||
"marqueeCardClassName?": "string",
|
||||
"marqueeImageClassName?": "string",
|
||||
"marqueeTextClassName?": "string",
|
||||
"marqueeIconClassName?": "string"
|
||||
},
|
||||
"usageExample": "<HeroSplitKpi background={{ variant: 'glowing-orb' }} title=\"The Future of Supply Chain\" description=\"Ship globally within 3 days with smart fulfillment\" enableKpiAnimation={true} kpis={[{ value: '4-10 Days', label: 'Worldwide Delivery' }, { value: '99.8%', label: 'Order Accuracy' }, { value: '10x', label: 'Faster Lead Times' }]} imageSrc=\"/hero-image.jpg\" imageAlt=\"Supply chain\" buttons={[{ text: 'Get Started', href: 'https://example.com' }]} />",
|
||||
"do": [
|
||||
"Use for landing pages",
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Use for statistics displays",
|
||||
"Use for achievement showcases",
|
||||
"Requires kpis[]",
|
||||
"Requires buttons?[]",
|
||||
"Requires avatars?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
139
registry/components/HeroSplitTestimonial.json
Normal file
139
registry/components/HeroSplitTestimonial.json
Normal file
@@ -0,0 +1,139 @@
|
||||
{
|
||||
"name": "HeroSplitTestimonial",
|
||||
"description": "Split-layout hero section with configurable background, text content on one side, and image/video with rotating testimonial card overlay on the other.",
|
||||
"details": "Use for hero sections that combine product visuals with social proof. Features split layout with media on one side (left/right configurable) and a testimonial card overlay positioned at the bottom-right of the media. Testimonials rotate automatically every 5 seconds with smooth fade animation. Each testimonial displays star rating, quote text, and author info with avatar. Supports optional logo marquee at the bottom. Responsive design with centered layout on mobile.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Build Better Products",
|
||||
"minChars": 2,
|
||||
"maxChars": 36
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Create exceptional user experiences with our design system",
|
||||
"minChars": 5,
|
||||
"maxChars": 200
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "New Release",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"testimonialRules": {
|
||||
"testimonials": {
|
||||
"required": true,
|
||||
"minItems": 1,
|
||||
"example": "[{ name: 'Sarah Johnson', handle: 'CEO, TechCorp', testimonial: 'Amazing product!', rating: 5, imageSrc: '/avatar.jpg' }]",
|
||||
"note": "Array of testimonial objects. Each requires name, handle, testimonial text, and rating (1-5). imageSrc is optional."
|
||||
},
|
||||
"testimonialRotationInterval": {
|
||||
"required": false,
|
||||
"default": 5000,
|
||||
"note": "Rotation interval in milliseconds"
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"imageSrc": {
|
||||
"required": false,
|
||||
"example": "/hero-image.jpg",
|
||||
"note": "Supports external URLs with unoptimized prop Either imageSrc or videoSrc should be provided. Image is recommended if no videoSrc."
|
||||
},
|
||||
"videoSrc": {
|
||||
"required": false,
|
||||
"example": "/hero-video.mp4",
|
||||
"note": "Takes precedence over imageSrc if both provided"
|
||||
},
|
||||
"imagePosition": {
|
||||
"required": false,
|
||||
"options": [
|
||||
"left",
|
||||
"right"
|
||||
],
|
||||
"default": "right"
|
||||
}
|
||||
},
|
||||
"buttonRules": {
|
||||
"maxButtons": 2,
|
||||
"structure": {
|
||||
"text": "string - Button label (required)",
|
||||
"href": "string - Link destination (optional). External URLs (https://, http://, www.) open in new tab. Internal values (e.g., 'about', 'contact') scroll to #about, #contact sections",
|
||||
"onClick": "() => void - Additional click handler (optional)"
|
||||
},
|
||||
"examples": [
|
||||
"{ text: 'Get Started', href: 'https://example.com' }",
|
||||
"{ text: 'Learn More', href: 'about' }"
|
||||
]
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string",
|
||||
"description": "string",
|
||||
"background": "{ variant: 'plain' | 'animated-grid' | 'canvas-reveal' | 'cell-wave' | 'downward-rays-animated' | 'downward-rays-animated-grid' | 'downward-rays-static' | 'downward-rays-static-grid' | 'glowing-orb' | 'gradient-bars' | 'radial-gradient' | 'rotated-rays-animated' | 'rotated-rays-animated-grid' | 'rotated-rays-static' | 'rotated-rays-static-grid' | 'sparkles-gradient' }",
|
||||
"testimonials": "Array<{ name: string, handle: string, testimonial: string, rating: number, imageSrc?: string, imageAlt?: string }>",
|
||||
"testimonialRotationInterval?": "number (default: 5000)",
|
||||
"useInvertedBackground?": "boolean (default: false)",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"avatars?": "Avatar[]",
|
||||
"avatarText?": "string",
|
||||
"imageSrc?": "string",
|
||||
"videoSrc?": "string",
|
||||
"imageAlt?": "string (default: '')",
|
||||
"videoAriaLabel?": "string (default: 'Hero video')",
|
||||
"mediaAnimation": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"ariaLabel?": "string (default: 'Hero section')",
|
||||
"imagePosition?": "'left' | 'right' (default: 'right')",
|
||||
"fixedMediaHeight?": "boolean (default: true)",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"imageClassName?": "string",
|
||||
"avatarGroupClassName?": "string",
|
||||
"testimonialCardClassName?": "string",
|
||||
"testimonialContentClassName?": "string",
|
||||
"testimonialTextClassName?": "string",
|
||||
"testimonialRatingClassName?": "string",
|
||||
"testimonialAuthorClassName?": "string",
|
||||
"testimonialAuthorImageClassName?": "string",
|
||||
"testimonialAuthorNameClassName?": "string",
|
||||
"testimonialAuthorHandleClassName?": "string",
|
||||
"marqueeItems?": "Array<{ type: 'image', src: string, alt?: string } | { type: 'text', text: string } | { type: 'text-icon', text: string, icon: LucideIcon }>",
|
||||
"marqueeSpeed?": "number (default: 30)",
|
||||
"showMarqueeCard?": "boolean (default: true)",
|
||||
"marqueeClassName?": "string",
|
||||
"marqueeItemClassName?": "string",
|
||||
"marqueeCardClassName?": "string",
|
||||
"marqueeImageClassName?": "string",
|
||||
"marqueeTextClassName?": "string",
|
||||
"marqueeIconClassName?": "string"
|
||||
},
|
||||
"usageExample": "<ThemeProvider defaultButtonVariant=\"text-stagger\" defaultTextAnimation=\"entrance-slide\" borderRadius=\"rounded\" background=\"aurora\" cardStyle=\"glass-elevated\" primaryButtonStyle=\"gradient\" secondaryButtonStyle=\"glass\">\n <HeroSplitTestimonial \n background={{ variant: 'glowing-orb' }}\n title=\"Build Better Products\" \n description=\"Create exceptional user experiences with our design system\" \n tag=\"New Release\"\n imagePosition=\"right\" \n imageSrc=\"/hero.jpg\"\n imageAlt=\"Product showcase\"\n testimonials={[{ name: 'Sarah Johnson', handle: 'CEO, TechCorp', testimonial: 'This transformed our workflow!', rating: 5, imageSrc: '/avatar.jpg' }]}\n buttons={[{ text: 'Start Building', href: 'https://example.com' }, { text: 'View Demo', href: 'demo' }]} \n />\n</ThemeProvider>",
|
||||
"do": [
|
||||
"Use for landing pages with social proof",
|
||||
"Use for product showcases with testimonials",
|
||||
"Use when customer reviews add credibility",
|
||||
"Requires testimonials[]",
|
||||
"Requires buttons?[]",
|
||||
"Requires avatars?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
70
registry/components/InlineImageSplitTextAbout.json
Normal file
70
registry/components/InlineImageSplitTextAbout.json
Normal file
@@ -0,0 +1,70 @@
|
||||
{
|
||||
"name": "InlineImageSplitTextAbout",
|
||||
"description": "About section with dynamic heading composed of alternating text and inline image segments.",
|
||||
"details": "Use for impactful about statements with visual branding elements. Heading is composed of an array of segments that can be text or images in any order. Images are styled with primary-button styling and alternate rotation (-rotate-12, rotate-12) for dynamic visual effect. Images are square (1.1em height) with aspect-square ratio, aligned middle with horizontal margins. Up to 2 optional CTA buttons with primary/secondary styling. Button variant controlled by ThemeProvider.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"heading[].content": {
|
||||
"required": "text segments require content",
|
||||
"example": "Building the future with",
|
||||
"minChars": 1,
|
||||
"maxChars": 100,
|
||||
"note": "Each text segment in the heading array"
|
||||
}
|
||||
},
|
||||
"imageRules": {
|
||||
"heading[].src": {
|
||||
"required": "image segments require src",
|
||||
"example": "/brand/logo.png or https://example.com/image.png",
|
||||
"note": "Supports local paths and external URLs. External URLs are rendered with unoptimized flag."
|
||||
},
|
||||
"heading[].alt": {
|
||||
"required": false,
|
||||
"example": "Company logo",
|
||||
"note": "Optional alt text for images. Omit or use empty string for decorative images (aria-hidden=true when empty)."
|
||||
}
|
||||
},
|
||||
"headingRules": {
|
||||
"minSegments": 1,
|
||||
"note": "heading array can contain any number of text and image segments in any order. Images automatically alternate rotation direction (1st: -rotate-12, 2nd: rotate-12, etc.)."
|
||||
},
|
||||
"buttonRules": {
|
||||
"maxButtons": 2,
|
||||
"structure": {
|
||||
"text": "string - Button label (required)",
|
||||
"href": "string - Link destination (optional)",
|
||||
"onClick": "() => void - Click handler (optional)",
|
||||
"props": "Partial<ButtonPropsForVariant> - Additional button props (optional)"
|
||||
},
|
||||
"note": "Button variant controlled by ThemeProvider's defaultButtonVariant. Border radius controlled by ThemeProvider's borderRadius."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"heading": "Array<{ type: 'text'; content: string } | { type: 'image'; src: string; alt?: string }>",
|
||||
"buttons?": "Array<{ text: string, onClick?: () => void, href?: string, props?: Partial<ButtonPropsForVariant<CTAButtonVariant>> }>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"useInvertedBackground": "boolean",
|
||||
"ariaLabel?": "string (default: 'About section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"headingClassName?": "string",
|
||||
"imageWrapperClassName?": "string",
|
||||
"imageClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "// Wrap in ThemeProvider\n<ThemeProvider defaultButtonVariant=\"text-stagger\" defaultTextAnimation=\"entrance-slide\" borderRadius=\"rounded\" background=\"aurora\" cardStyle=\"glass-elevated\" primaryButtonStyle=\"gradient\" secondaryButtonStyle=\"glass\">\n <InlineImageSplitTextAbout heading={[{ type: 'text', content: 'Building the future with' }, { type: 'image', src: '/brand/logo.png', alt: 'Company logo' }, { type: 'text', content: 'innovative solutions' }]} useInvertedBackground={false} buttons={[{ text: 'Get Started', href: '/signup' }, { text: 'Learn More', href: '/about' }]} />\n</ThemeProvider>",
|
||||
"do": [
|
||||
"Use for about pages",
|
||||
"Use for company information",
|
||||
"Requires heading[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
36
registry/components/Input.json
Normal file
36
registry/components/Input.json
Normal file
@@ -0,0 +1,36 @@
|
||||
{
|
||||
"name": "Input",
|
||||
"description": "Styled text input field with secondary-button styling and rounded-theme borders.",
|
||||
"details": "Use for text, email, password, and other input types in forms. Features secondary-button background styling, placeholder text with 75% opacity, and focus states. Includes disabled state with reduced opacity and cursor styling. Supports all standard HTML input types.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"placeholder": {
|
||||
"required": false,
|
||||
"example": "Enter your name",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"value": "string (required)",
|
||||
"onChange": "(value: string) => void (required)",
|
||||
"type?": "string (default: 'text')",
|
||||
"placeholder?": "string",
|
||||
"required?": "boolean (default: false)",
|
||||
"disabled?": "boolean (default: false)",
|
||||
"ariaLabel?": "string",
|
||||
"className?": "string"
|
||||
},
|
||||
"usageExample": "<Input value={name} onChange={(value) => setName(value)} type=\"text\" placeholder=\"Name\" required />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
96
registry/components/MediaAbout.json
Normal file
96
registry/components/MediaAbout.json
Normal file
@@ -0,0 +1,96 @@
|
||||
{
|
||||
"name": "MediaAbout",
|
||||
"description": "Full-width media about section with centered TextBox content overlaid on image or video.",
|
||||
"details": "Use for impactful visual-first about sections where the media is the primary focus with overlaid text content. Features full-width media (image or video) in aspect-video ratio with content-width constraint, rounded corners (theme-capped), and centered TextBox overlay containing title (text-6xl), description, optional tag, and 1-2 CTA buttons. TextBox is constrained to w-content-width md:w-45 for optimal readability. Perfect for hero-like about sections, product showcases, or call-to-action moments where visual impact is key. Section uses standard py-20 padding with useInvertedBackground support for section background.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Elevate Your Experience",
|
||||
"minChars": 2,
|
||||
"maxChars": 100
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Discover a new way to connect, create, and inspire with our innovative solutions.",
|
||||
"minChars": 10,
|
||||
"maxChars": 300
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "About Us",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"mediaRules": {
|
||||
"imageSrc": {
|
||||
"required": false,
|
||||
"example": "/about-hero.jpg",
|
||||
"note": "Either imageSrc or videoSrc should be provided. Image is recommended for static visuals."
|
||||
},
|
||||
"videoSrc": {
|
||||
"required": false,
|
||||
"example": "/about-video.mp4",
|
||||
"note": "Either imageSrc or videoSrc should be provided. Video is recommended for motion content."
|
||||
},
|
||||
"imageAlt": {
|
||||
"required": false,
|
||||
"example": "Our team in action",
|
||||
"note": "Alt text for image. Defaults to empty string (decorative)."
|
||||
},
|
||||
"videoAriaLabel": {
|
||||
"required": false,
|
||||
"example": "About us video",
|
||||
"note": "ARIA label for video accessibility."
|
||||
}
|
||||
},
|
||||
"buttonRules": {
|
||||
"maxButtons": 2,
|
||||
"minButtons": 0,
|
||||
"note": "Buttons are part of TextBox, centered and overlaid on media. First button is primary, second is secondary. Button variant controlled by ThemeProvider's defaultButtonVariant."
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"imageSrc?": "string",
|
||||
"videoSrc?": "string",
|
||||
"imageAlt?": "string",
|
||||
"videoAriaLabel?": "string",
|
||||
"useInvertedBackground": "boolean",
|
||||
"ariaLabel?": "string (default: 'About section')",
|
||||
"className?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"buttonContainerClassName?": "string",
|
||||
"buttonClassName?": "string",
|
||||
"buttonTextClassName?": "string",
|
||||
"mediaWrapperClassName?": "string",
|
||||
"mediaClassName?": "string"
|
||||
},
|
||||
"usageExample": "<MediaAbout title=\"Elevate Your Experience\" description=\"Discover a new way to connect, create, and inspire.\" tag=\"About Us\" imageSrc=\"/about-hero.jpg\" imageAlt=\"Our team\" buttons={[{ text: 'Shop Now', href: '/shop' }]} useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for landing pages",
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Use for about pages",
|
||||
"Use for company information",
|
||||
"Use for product catalogs",
|
||||
"Use for e-commerce",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
115
registry/components/MetricCardEleven.json
Normal file
115
registry/components/MetricCardEleven.json
Normal file
@@ -0,0 +1,115 @@
|
||||
{
|
||||
"name": "MetricCardEleven",
|
||||
"description": "Metrics section with paired text and media cards. Each metric displays a value card alongside an image/video card in a 2-column layout.",
|
||||
"details": "Use for showcasing metrics with visual content. Each metric creates two side-by-side cards: a text card (large value at top, title with accent divider and description at bottom) and a media card (image or video). Layout: 1 item or odd last item spans full width with aspect-video on desktop. 2+ items show 2-column grid on desktop. On mobile, even items (2nd, 4th, etc.) alternate order with media on left. Uses CardStackTextBox for header section. Supports GSAP scroll-triggered animations.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Our Impact",
|
||||
"minChars": 2,
|
||||
"maxChars": 50
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "See the results we've delivered for our clients",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Results",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"metricRules": {
|
||||
"id": {
|
||||
"required": true,
|
||||
"example": "1",
|
||||
"minChars": 1,
|
||||
"maxChars": 20
|
||||
},
|
||||
"value": {
|
||||
"required": true,
|
||||
"example": "10M+",
|
||||
"minChars": 1,
|
||||
"maxChars": 15,
|
||||
"note": "Large metric value displayed prominently at top of text card"
|
||||
},
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Organic Views",
|
||||
"minChars": 2,
|
||||
"maxChars": 50,
|
||||
"note": "Metric title displayed at bottom of text card, truncates"
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Growth through smart content strategy",
|
||||
"minChars": 5,
|
||||
"maxChars": 100,
|
||||
"note": "Metric description below accent divider, truncates to single line"
|
||||
},
|
||||
"media": {
|
||||
"required": true,
|
||||
"note": "Either imageSrc or videoSrc must be provided for each metric"
|
||||
}
|
||||
},
|
||||
"itemRules": {
|
||||
"minItems": 1,
|
||||
"maxItems": 6,
|
||||
"recommendedItems": "2-4"
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"metrics": "Array<{ id: string, value: string, title: string, description: string, imageSrc?: string, imageAlt?: string, videoSrc?: string, videoAriaLabel?: string }>",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal'",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image'",
|
||||
"useInvertedBackground": "boolean",
|
||||
"ariaLabel?": "string (default: 'Metrics section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxTitleImageWrapperClassName?": "string",
|
||||
"textBoxTitleImageClassName?": "string",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string",
|
||||
"gridClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"valueClassName?": "string",
|
||||
"cardTitleClassName?": "string",
|
||||
"cardDescriptionClassName?": "string",
|
||||
"mediaCardClassName?": "string",
|
||||
"mediaClassName?": "string"
|
||||
},
|
||||
"usageExample": "<MetricCardEleven metrics={[{ id: '1', value: '10M+', title: 'Organic Views', description: 'Growth through smart content strategy', imageSrc: '/hero/hero-1.webp', imageAlt: 'Content creator working' }, { id: '2', value: '500K+', title: 'New Followers', description: 'Engaged community members gained', imageSrc: '/hero/hero-2.webp', imageAlt: 'Social media engagement' }]} title=\"Our Impact\" description=\"See the results we've delivered for our clients\" textboxLayout=\"default\" useInvertedBackground={false} animationType=\"slide-up\" />",
|
||||
"do": [
|
||||
"Use for statistics displays",
|
||||
"Use for achievement showcases",
|
||||
"Requires metrics[]",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use more than 4 items",
|
||||
"Do not use more than 6 items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
79
registry/components/MetricCardFourteen.json
Normal file
79
registry/components/MetricCardFourteen.json
Normal file
@@ -0,0 +1,79 @@
|
||||
{
|
||||
"name": "MetricCardFourteen",
|
||||
"description": "Metrics section with animated title, tag badge, and metric cards with large values and descriptions.",
|
||||
"details": "Use for impact metrics or sustainability stats. Layout: Animated title at top, horizontal divider, then tag badge on left with metric cards grid on right. Each metric card has large value at top, divider line, and description text below. Cards are aspect-video with justify-between for proper spacing. Supports 1-2 column grid based on item count. Supports inverted backgrounds.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "We're committed to sustainability and reducing our environmental impact.",
|
||||
"minChars": 10,
|
||||
"maxChars": 200
|
||||
},
|
||||
"tag": {
|
||||
"required": true,
|
||||
"example": "Impact",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"metricRules": {
|
||||
"id": {
|
||||
"required": true,
|
||||
"example": "1",
|
||||
"note": "Unique identifier for each metric"
|
||||
},
|
||||
"value": {
|
||||
"required": true,
|
||||
"example": "16x",
|
||||
"minChars": 1,
|
||||
"maxChars": 10,
|
||||
"note": "Large metric value displayed prominently"
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "By using 80% less steel, we've lowered our carbon footprint by 16x.",
|
||||
"minChars": 10,
|
||||
"maxChars": 200,
|
||||
"note": "Description text below the divider"
|
||||
}
|
||||
},
|
||||
"itemRules": {
|
||||
"minItems": 1,
|
||||
"maxItems": 4,
|
||||
"recommendedItems": 2
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"title": "string",
|
||||
"tag": "string",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"metrics": "Array<{ id: string, value: string, description: string }>",
|
||||
"metricsAnimation": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"useInvertedBackground": "boolean",
|
||||
"ariaLabel?": "string (default: 'Metrics section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"tagClassName?": "string",
|
||||
"metricsContainerClassName?": "string",
|
||||
"metricClassName?": "string",
|
||||
"valueClassName?": "string",
|
||||
"descriptionClassName?": "string"
|
||||
},
|
||||
"usageExample": "<MetricCardFourteen title=\"We're committed to sustainability and reducing our environmental impact.\" tag=\"Impact\" metrics={[{ id: '1', value: '16x', description: 'By using 80% less steel, we've lowered our carbon footprint.' }, { id: '2', value: '95%', description: 'Customer satisfaction rate across all products.' }]} useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for statistics displays",
|
||||
"Use for achievement showcases",
|
||||
"Requires metrics[]"
|
||||
],
|
||||
"dont": [
|
||||
"Do not use more than 4 items",
|
||||
"Do not use more than 4 items"
|
||||
],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
114
registry/components/MetricCardOne.json
Normal file
114
registry/components/MetricCardOne.json
Normal file
@@ -0,0 +1,114 @@
|
||||
{
|
||||
"name": "MetricCardOne",
|
||||
"description": "Metric card with large gradient value text, title, description, and icon badge.",
|
||||
"details": "Use for displaying key metrics, statistics, or KPIs with visual impact. Layout: Large Gradient Value (9xl, overlapping) → Title (4xl, overlaps value with negative margin) → Description (base text, centered) → Icon Badge (bottom-left corner, primary-button styling). Value text uses gradient effect with CSS variables for theme consistency. All fields are required for visual consistency. Best for stats sections, achievement displays, or data visualization. Automatically switches between grid (1-4 items) and carousel (5+ items). Optional header with title, description, tag, and buttons.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Our Impact",
|
||||
"minChars": 2,
|
||||
"maxChars": 35
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Key metrics that showcase our growth and success",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Statistics",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"metricRules": {
|
||||
"id": {
|
||||
"required": true,
|
||||
"example": "1",
|
||||
"minChars": 1,
|
||||
"maxChars": 20
|
||||
},
|
||||
"value": {
|
||||
"required": true,
|
||||
"example": "100",
|
||||
"minChars": 1,
|
||||
"maxChars": 5,
|
||||
"type": "number",
|
||||
"note": "Must be a number (max 5 digits). Large metric value displayed with gradient effect."
|
||||
},
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "million",
|
||||
"minChars": 2,
|
||||
"maxChars": 30,
|
||||
"note": "Metric label displayed below value with negative margin overlap"
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Active users worldwide",
|
||||
"minChars": 5,
|
||||
"maxChars": 150,
|
||||
"note": "Supporting description text displayed below title"
|
||||
},
|
||||
"icon": {
|
||||
"required": true,
|
||||
"example": "TrendingUp",
|
||||
"note": "Lucide icon displayed in bottom-left corner with primary-button styling"
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"metrics": "Array<{ id: string, value: string, title: string, description: string, icon: LucideIcon }>",
|
||||
"carouselMode?": "'auto' | 'buttons' (default: 'buttons')",
|
||||
"gridVariant": "'uniform-all-items-equal' | 'bento-grid' | 'bento-grid-inverted' (required)",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal' | 'depth-3d'",
|
||||
"uniformGridCustomHeightClasses?": "string",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"useInvertedBackground": "boolean",
|
||||
"ariaLabel?": "string (default: 'Metrics section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxTitleImageWrapperClassName?": "string - For styling image wrapper in inline-image layout",
|
||||
"textBoxTitleImageClassName?": "string - For styling images in inline-image layout",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"valueClassName?": "string",
|
||||
"titleClassName?": "string",
|
||||
"descriptionClassName?": "string",
|
||||
"iconContainerClassName?": "string",
|
||||
"iconClassName?": "string",
|
||||
"gridClassName?": "string",
|
||||
"carouselClassName?": "string",
|
||||
"controlsClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<MetricCardOne metrics={[{ id: '1', value: '100', title: 'million', description: 'Active users worldwide', icon: TrendingUp }, { id: '2', value: '700', title: 'thousand', description: 'Projects completed successfully', icon: Users }]} title=\"Our Impact\" description=\"See how we're making a difference\" gridVariant=\"uniform-all-items-equal\" textboxLayout=\"default\" animationType=\"slide-up\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for statistics displays",
|
||||
"Use for achievement showcases",
|
||||
"Requires metrics[]",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
110
registry/components/MetricCardSeven.json
Normal file
110
registry/components/MetricCardSeven.json
Normal file
@@ -0,0 +1,110 @@
|
||||
{
|
||||
"name": "MetricCardSeven",
|
||||
"description": "Metric card with large accent value, title, and feature list with checkmarks.",
|
||||
"details": "Use for metrics with supporting bullet points. Layout: Large Value (9xl accent, h3) → Title (2xl) → Accent border divider → Feature List (PricingFeatureList with checkmarks). Value and title at top, feature list at bottom with border separator. Best for metrics that need additional context or supporting details. Automatically switches between grid (1-4 items) and carousel (5+ items). Optional header with title, description, tag, and buttons.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Our Impact",
|
||||
"minChars": 2,
|
||||
"maxChars": 35
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Key metrics that showcase our growth",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "Stats",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"metricRules": {
|
||||
"id": {
|
||||
"required": true,
|
||||
"example": "1",
|
||||
"minChars": 1,
|
||||
"maxChars": 20
|
||||
},
|
||||
"value": {
|
||||
"required": true,
|
||||
"example": "15+",
|
||||
"minChars": 1,
|
||||
"maxChars": 10,
|
||||
"note": "Large metric value displayed at top of card in accent color"
|
||||
},
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Years in business consulting",
|
||||
"minChars": 5,
|
||||
"maxChars": 60,
|
||||
"note": "Metric description displayed below value"
|
||||
},
|
||||
"items": {
|
||||
"required": true,
|
||||
"example": "['8+ industries served', '5+ countries reached']",
|
||||
"minItems": 1,
|
||||
"maxItems": 5,
|
||||
"note": "Array of supporting bullet points displayed with checkmarks"
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"metrics": "Array<{ id: string, value: string, title: string, items: string[] }>",
|
||||
"carouselMode?": "'auto' | 'buttons' (default: 'buttons')",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal' | 'depth-3d'",
|
||||
"uniformGridCustomHeightClasses?": "string",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"useInvertedBackground": "boolean",
|
||||
"ariaLabel?": "string (default: 'Metrics section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxTitleImageWrapperClassName?": "string - For styling image wrapper in inline-image layout",
|
||||
"textBoxTitleImageClassName?": "string - For styling images in inline-image layout",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"valueClassName?": "string - For styling the large metric value",
|
||||
"metricTitleClassName?": "string - For styling the metric title text",
|
||||
"featuresClassName?": "string - For styling the PricingFeatureList container",
|
||||
"featureItemClassName?": "string - For styling individual feature items",
|
||||
"gridClassName?": "string",
|
||||
"carouselClassName?": "string",
|
||||
"controlsClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<MetricCardSeven metrics={[{ id: '1', value: '15+', title: 'Years in business consulting', items: ['8+ industries served', '5+ countries reached'] }, { id: '2', value: '500+', title: 'Projects completed', items: ['98% client satisfaction', 'Award-winning designs'] }]} title=\"Our Impact\" description=\"Key metrics that showcase our growth\" textboxLayout=\"default\" animationType=\"slide-up\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Use for pricing pages",
|
||||
"Use for subscription tiers",
|
||||
"Use for statistics displays",
|
||||
"Use for achievement showcases",
|
||||
"Requires metrics[]",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
106
registry/components/MetricCardThree.json
Normal file
106
registry/components/MetricCardThree.json
Normal file
@@ -0,0 +1,106 @@
|
||||
{
|
||||
"name": "MetricCardThree",
|
||||
"description": "Metric card with icon badge, title header, and large value display.",
|
||||
"details": "Use for icon-led metric displays with clear categorization. Layout: Icon (primary-button, rounded-theme) + Title (xl text, on same row) → Large Value (7xl, bold, centered). Card has fixed height (h-60 2xl:h-70) with centered layout. Icon uses primary-button styling with text-background for contrast. All fields are required for visual consistency. Best for categorized statistics, feature metrics, or KPIs that need visual identification. Automatically switches between grid (1-4 items) and carousel (5+ items). Optional header with title, description, tag, and buttons.",
|
||||
"constraints": {
|
||||
"textRules": {
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Performance Metrics",
|
||||
"minChars": 2,
|
||||
"maxChars": 35
|
||||
},
|
||||
"description": {
|
||||
"required": true,
|
||||
"example": "Track your key performance indicators",
|
||||
"minChars": 5,
|
||||
"maxChars": 250
|
||||
},
|
||||
"tag": {
|
||||
"required": false,
|
||||
"example": "KPIs",
|
||||
"minChars": 2,
|
||||
"maxChars": 30
|
||||
}
|
||||
},
|
||||
"metricRules": {
|
||||
"id": {
|
||||
"required": true,
|
||||
"example": "1",
|
||||
"minChars": 1,
|
||||
"maxChars": 20
|
||||
},
|
||||
"icon": {
|
||||
"required": true,
|
||||
"example": "TrendingUp",
|
||||
"note": "Lucide icon displayed in primary-button styled circular badge"
|
||||
},
|
||||
"title": {
|
||||
"required": true,
|
||||
"example": "Conversions",
|
||||
"minChars": 2,
|
||||
"maxChars": 30,
|
||||
"note": "Metric category/label displayed next to icon"
|
||||
},
|
||||
"value": {
|
||||
"required": true,
|
||||
"example": "7,000+",
|
||||
"minChars": 1,
|
||||
"maxChars": 15,
|
||||
"note": "Large metric value displayed below icon and title"
|
||||
}
|
||||
}
|
||||
},
|
||||
"propsSchema": {
|
||||
"metrics": "Array<{ id: string, icon: LucideIcon, title: string, value: string }>",
|
||||
"carouselMode?": "'auto' | 'buttons' (default: 'buttons')",
|
||||
"animationType": "'none' | 'opacity' | 'slide-up' | 'scale-rotate' | 'blur-reveal' | 'depth-3d'",
|
||||
"uniformGridCustomHeightClasses?": "string",
|
||||
"title": "string",
|
||||
"titleSegments?": "Array<{ type: 'text', content: string } | { type: 'image', src: string, alt?: string }> - For inline images in title",
|
||||
"description": "string",
|
||||
"tag?": "string",
|
||||
"tagIcon?": "LucideIcon",
|
||||
"tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||
"buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
|
||||
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||
"useInvertedBackground": "boolean",
|
||||
"ariaLabel?": "string (default: 'Metrics section')",
|
||||
"className?": "string",
|
||||
"containerClassName?": "string",
|
||||
"cardClassName?": "string",
|
||||
"textBoxTitleClassName?": "string",
|
||||
"textBoxTitleImageWrapperClassName?": "string - For styling image wrapper in inline-image layout",
|
||||
"textBoxTitleImageClassName?": "string - For styling images in inline-image layout",
|
||||
"textBoxDescriptionClassName?": "string",
|
||||
"iconContainerClassName?": "string",
|
||||
"iconClassName?": "string",
|
||||
"metricTitleClassName?": "string",
|
||||
"valueClassName?": "string",
|
||||
"gridClassName?": "string",
|
||||
"carouselClassName?": "string",
|
||||
"controlsClassName?": "string",
|
||||
"textBoxClassName?": "string",
|
||||
"textBoxTagClassName?": "string",
|
||||
"textBoxButtonContainerClassName?": "string",
|
||||
"textBoxButtonClassName?": "string",
|
||||
"textBoxButtonTextClassName?": "string"
|
||||
},
|
||||
"usageExample": "<MetricCardThree metrics={[{ id: '1', icon: TrendingUp, title: 'Conversions', value: '7,000+' }, { id: '2', icon: Users, title: 'Active Users', value: '50,000+' }]} title=\"Performance Metrics\" description=\"See how we're making a difference\" textboxLayout=\"default\" animationType=\"slide-up\" useInvertedBackground={false} />",
|
||||
"do": [
|
||||
"Use for feature showcases",
|
||||
"Use for capability displays",
|
||||
"Use for statistics displays",
|
||||
"Use for achievement showcases",
|
||||
"Requires metrics[]",
|
||||
"Requires titleSegments?[]",
|
||||
"Requires buttons?[]"
|
||||
],
|
||||
"dont": [],
|
||||
"editRules": {
|
||||
"textOnly": true,
|
||||
"layoutLocked": true,
|
||||
"styleLocked": true
|
||||
}
|
||||
}
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user