Initial commit
2
.env
Normal file
@@ -0,0 +1,2 @@
|
|||||||
|
NEXT_PUBLIC_API_URL=https://dev.api.webild.io
|
||||||
|
NEXT_PUBLIC_PROJECT_ID=4119c0d1-1021-419c-b01a-6151dfcef0ac
|
||||||
57
.gitea/workflows/build.yml
Normal file
@@ -0,0 +1,57 @@
|
|||||||
|
name: Code Check
|
||||||
|
|
||||||
|
on:
|
||||||
|
workflow_dispatch:
|
||||||
|
inputs:
|
||||||
|
branch:
|
||||||
|
description: 'Branch to check'
|
||||||
|
required: true
|
||||||
|
default: 'main'
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
contents: read
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
check:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
timeout-minutes: 10
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- name: Checkout branch
|
||||||
|
uses: actions/checkout@v3
|
||||||
|
with:
|
||||||
|
ref: ${{ gitea.event.inputs.branch }}
|
||||||
|
|
||||||
|
- name: Setup Node.js
|
||||||
|
uses: actions/setup-node@v3
|
||||||
|
with:
|
||||||
|
node-version: 24
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
npm ci --prefer-offline --no-audit 2>&1 | tee install.log
|
||||||
|
env:
|
||||||
|
NODE_OPTIONS: '--max-old-space-size=4096'
|
||||||
|
|
||||||
|
- name: TypeScript check
|
||||||
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
npm run typecheck 2>&1 | tee build.log
|
||||||
|
|
||||||
|
- name: ESLint check
|
||||||
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
npm run lint 2>&1 | tee build.log
|
||||||
|
|
||||||
|
- name: Upload build log on failure
|
||||||
|
if: failure()
|
||||||
|
uses: actions/upload-artifact@v3
|
||||||
|
with:
|
||||||
|
name: build-log
|
||||||
|
path: build.log
|
||||||
|
if-no-files-found: ignore
|
||||||
|
|
||||||
|
- name: Check completed
|
||||||
|
if: success()
|
||||||
|
run: echo "Typecheck and lint passed successfully"
|
||||||
40
.gitignore
vendored
Normal file
@@ -0,0 +1,40 @@
|
|||||||
|
# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
|
||||||
|
|
||||||
|
# dependencies
|
||||||
|
/node_modules
|
||||||
|
/.pnp
|
||||||
|
.pnp.*
|
||||||
|
.yarn/*
|
||||||
|
!.yarn/patches
|
||||||
|
!.yarn/plugins
|
||||||
|
!.yarn/releases
|
||||||
|
!.yarn/versions
|
||||||
|
|
||||||
|
# testing
|
||||||
|
/coverage
|
||||||
|
|
||||||
|
# next.js
|
||||||
|
/.next/
|
||||||
|
/out/
|
||||||
|
|
||||||
|
# production
|
||||||
|
/build
|
||||||
|
|
||||||
|
# misc
|
||||||
|
.DS_Store
|
||||||
|
*.pem
|
||||||
|
|
||||||
|
# debug
|
||||||
|
npm-debug.log*
|
||||||
|
yarn-debug.log*
|
||||||
|
yarn-error.log*
|
||||||
|
.pnpm-debug.log*
|
||||||
|
|
||||||
|
# vercel
|
||||||
|
.vercel
|
||||||
|
|
||||||
|
# typescript
|
||||||
|
*.tsbuildinfo
|
||||||
|
next-env.d.ts
|
||||||
|
|
||||||
|
.idea/
|
||||||
36
README.md
Normal file
@@ -0,0 +1,36 @@
|
|||||||
|
This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
|
||||||
|
|
||||||
|
## Getting Started
|
||||||
|
|
||||||
|
First, run the development server:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm run dev
|
||||||
|
# or
|
||||||
|
yarn dev
|
||||||
|
# or
|
||||||
|
pnpm dev
|
||||||
|
# or
|
||||||
|
bun dev
|
||||||
|
```
|
||||||
|
|
||||||
|
Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
|
||||||
|
|
||||||
|
You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
|
||||||
|
|
||||||
|
This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
|
||||||
|
|
||||||
|
## Learn More
|
||||||
|
|
||||||
|
To learn more about Next.js, take a look at the following resources:
|
||||||
|
|
||||||
|
- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
|
||||||
|
- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
|
||||||
|
|
||||||
|
You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
|
||||||
|
|
||||||
|
## Deploy on Vercel
|
||||||
|
|
||||||
|
The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
|
||||||
|
|
||||||
|
Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
|
||||||
116
THEME_PROVIDER_OPTIONS.txt
Normal file
@@ -0,0 +1,116 @@
|
|||||||
|
================================================================================
|
||||||
|
THEME PROVIDER OPTIONS
|
||||||
|
================================================================================
|
||||||
|
|
||||||
|
PROPS (All Required except showBlurBottom)
|
||||||
|
-------------------------------------------
|
||||||
|
|
||||||
|
1. defaultButtonVariant
|
||||||
|
• "hover-magnetic"
|
||||||
|
• "hover-bubble"
|
||||||
|
• "expand-hover"
|
||||||
|
• "elastic-effect"
|
||||||
|
• "bounce-effect"
|
||||||
|
• "icon-arrow"
|
||||||
|
• "shift-hover"
|
||||||
|
• "text-stagger"
|
||||||
|
• "text-shift"
|
||||||
|
• "directional-hover"
|
||||||
|
• "slide-background"
|
||||||
|
|
||||||
|
2. defaultTextAnimation
|
||||||
|
• "entrance-slide"
|
||||||
|
• "reveal-blur"
|
||||||
|
• "background-highlight"
|
||||||
|
|
||||||
|
3. borderRadius
|
||||||
|
• "sharp"
|
||||||
|
• "rounded"
|
||||||
|
• "soft"
|
||||||
|
• "pill"
|
||||||
|
|
||||||
|
4. contentWidth
|
||||||
|
• "small"
|
||||||
|
• "smallMedium"
|
||||||
|
• "compact"
|
||||||
|
• "mediumSmall"
|
||||||
|
• "medium"
|
||||||
|
• "mediumLarge"
|
||||||
|
|
||||||
|
5. sizing
|
||||||
|
• "medium"
|
||||||
|
• "mediumLarge"
|
||||||
|
• "largeSmall"
|
||||||
|
• "large"
|
||||||
|
• "mediumSizeLargeTitles"
|
||||||
|
• "mediumLargeSizeLargeTitles"
|
||||||
|
• "largeSmallSizeLargeTitles"
|
||||||
|
• "largeSizeMediumTitles"
|
||||||
|
• "mediumLargeSizeMediumTitles"
|
||||||
|
• "largeSmallSizeMediumTitles"
|
||||||
|
|
||||||
|
6. background
|
||||||
|
• "none"
|
||||||
|
• "circleGradient"
|
||||||
|
• "aurora"
|
||||||
|
• "floatingGradient"
|
||||||
|
|
||||||
|
7. cardStyle
|
||||||
|
• "solid"
|
||||||
|
• "outline"
|
||||||
|
• "elevated"
|
||||||
|
• "gradient-mesh"
|
||||||
|
• "gradient-radial"
|
||||||
|
• "inset"
|
||||||
|
• "glass-elevated"
|
||||||
|
• "glass-depth"
|
||||||
|
• "gradient-bordered"
|
||||||
|
• "layered-gradient"
|
||||||
|
• "soft-shadow"
|
||||||
|
• "subtle-shadow"
|
||||||
|
|
||||||
|
8. primaryButtonStyle
|
||||||
|
• "gradient"
|
||||||
|
• "shadow"
|
||||||
|
• "flat"
|
||||||
|
• "radial-glow"
|
||||||
|
• "diagonal-gradient"
|
||||||
|
• "inset-glow"
|
||||||
|
• "double-inset"
|
||||||
|
• "primary-glow"
|
||||||
|
|
||||||
|
9. secondaryButtonStyle
|
||||||
|
• "glass"
|
||||||
|
• "solid"
|
||||||
|
• "layered"
|
||||||
|
• "radial-glow"
|
||||||
|
|
||||||
|
10. headingFontWeight
|
||||||
|
• "light"
|
||||||
|
• "normal"
|
||||||
|
• "medium"
|
||||||
|
• "semibold"
|
||||||
|
• "bold"
|
||||||
|
• "extrabold"
|
||||||
|
|
||||||
|
================================================================================
|
||||||
|
|
||||||
|
EXAMPLE USAGE:
|
||||||
|
|
||||||
|
<ThemeProvider
|
||||||
|
defaultButtonVariant="text-stagger"
|
||||||
|
defaultTextAnimation="entrance-slide"
|
||||||
|
borderRadius="pill"
|
||||||
|
contentWidth="medium"
|
||||||
|
sizing="medium"
|
||||||
|
background="aurora"
|
||||||
|
cardStyle="glass-elevated"
|
||||||
|
primaryButtonStyle="gradient"
|
||||||
|
secondaryButtonStyle="glass"
|
||||||
|
headingFontWeight="medium"
|
||||||
|
showBlurBottom={false}
|
||||||
|
>
|
||||||
|
{children}
|
||||||
|
</ThemeProvider>
|
||||||
|
|
||||||
|
================================================================================
|
||||||
484
colorThemes.css
Normal file
@@ -0,0 +1,484 @@
|
|||||||
|
/* ============================================ */
|
||||||
|
/* LIGHT THEME VARIANTS */
|
||||||
|
/* ============================================ */
|
||||||
|
|
||||||
|
/* Light Theme - Minimal Dark Blue */
|
||||||
|
:root[data-theme="minimal-dark-blue"] {
|
||||||
|
--background: #ffffff;
|
||||||
|
--card: #f9f9f9;
|
||||||
|
--foreground: #000612e6;
|
||||||
|
--primary-cta: #15479c;
|
||||||
|
--secondary-cta: #f9f9f9;
|
||||||
|
--accent: #e2e2e2;
|
||||||
|
--background-accent: #c4c4c4;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Minimal Dark Green */
|
||||||
|
:root[data-theme="minimal-dark-green"] {
|
||||||
|
--background: #ffffff;
|
||||||
|
--card: #f9f9f9;
|
||||||
|
--foreground: #000f06e6;
|
||||||
|
--primary-cta: #0a7039;
|
||||||
|
--secondary-cta: #f9f9f9;
|
||||||
|
--accent: #e2e2e2;
|
||||||
|
--background-accent: #c4c4c4;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Minimal Light Red */
|
||||||
|
:root[data-theme="minimal-light-red"] {
|
||||||
|
--background: #ffffff;
|
||||||
|
--card: #f9f9f9;
|
||||||
|
--foreground: #120006e6;
|
||||||
|
--primary-cta: #e63946;
|
||||||
|
--secondary-cta: #f9f9f9;
|
||||||
|
--accent: #e2e2e2;
|
||||||
|
--background-accent: #c4c4c4;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Minimal Light Orange */
|
||||||
|
:root[data-theme="minimal-light-orange"] {
|
||||||
|
--background: #ffffff;
|
||||||
|
--card: #f9f9f9;
|
||||||
|
--foreground: #120a00e6;
|
||||||
|
--primary-cta: #ff8c42;
|
||||||
|
--secondary-cta: #f9f9f9;
|
||||||
|
--accent: #e2e2e2;
|
||||||
|
--background-accent: #c4c4c4;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Dark Blue */
|
||||||
|
:root[data-theme="dark-blue"] {
|
||||||
|
--background: #f5faff;
|
||||||
|
--card: #f1f8ff;
|
||||||
|
--foreground: #001122;
|
||||||
|
--primary-cta: #15479c;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #a8cce8;
|
||||||
|
--background-accent: #7ba3cf;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Dark Green */
|
||||||
|
:root[data-theme="dark-green"] {
|
||||||
|
--background: #fafffb;
|
||||||
|
--card: #f7fffa;
|
||||||
|
--foreground: #001a0a;
|
||||||
|
--primary-cta: #0a7039;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #a8d9be;
|
||||||
|
--background-accent: #6bbf8e;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Light Red */
|
||||||
|
:root[data-theme="light-red"] {
|
||||||
|
--background: #fffafa;
|
||||||
|
--card: #fff7f7;
|
||||||
|
--foreground: #1a0000;
|
||||||
|
--primary-cta: #e63946;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #f5c4c7;
|
||||||
|
--background-accent: #f09199;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Light Purple */
|
||||||
|
:root[data-theme="light-purple"] {
|
||||||
|
--background: #fbfaff;
|
||||||
|
--card: #f7f5ff;
|
||||||
|
--foreground: #0f0022;
|
||||||
|
--primary-cta: #8b5cf6;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #d8cef5;
|
||||||
|
--background-accent: #c4a8f9;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Warm Cream */
|
||||||
|
:root[data-theme="warm-cream"] {
|
||||||
|
--background: #f6f0e9;
|
||||||
|
--card: #efe7dd;
|
||||||
|
--foreground: #2b180a;
|
||||||
|
--primary-cta: #2b180a;
|
||||||
|
--secondary-cta: #efe7dd;
|
||||||
|
--accent: #94877c;
|
||||||
|
--background-accent: #afa094;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Gray Blue Accent */
|
||||||
|
:root[data-theme="gray-blue-accent"] {
|
||||||
|
--background: #f5f5f5;
|
||||||
|
--card: #ffffff;
|
||||||
|
--foreground: #1c1c1c;
|
||||||
|
--primary-cta: #1c1c1c;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #15479c;
|
||||||
|
--background-accent: #a8cce8;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Gray Green Accent */
|
||||||
|
:root[data-theme="gray-green-accent"] {
|
||||||
|
--background: #f5f5f5;
|
||||||
|
--card: #ffffff;
|
||||||
|
--foreground: #1c1c1c;
|
||||||
|
--primary-cta: #1c1c1c;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #159c49;
|
||||||
|
--background-accent: #a8e8ba;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Gray Red Accent */
|
||||||
|
:root[data-theme="gray-red-accent"] {
|
||||||
|
--background: #f5f5f5;
|
||||||
|
--card: #ffffff;
|
||||||
|
--foreground: #1c1c1c;
|
||||||
|
--primary-cta: #1c1c1c;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #e63946;
|
||||||
|
--background-accent: #e8bea8;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Gray Purple Accent */
|
||||||
|
:root[data-theme="gray-purple-accent"] {
|
||||||
|
--background: #f5f5f5;
|
||||||
|
--card: #ffffff;
|
||||||
|
--foreground: #1c1c1c;
|
||||||
|
--primary-cta: #1c1c1c;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #6139e6;
|
||||||
|
--background-accent: #b3a8e8;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Warm Beige */
|
||||||
|
:root[data-theme="warm-beige"] {
|
||||||
|
--background: #efebe5;
|
||||||
|
--card: #f7f2ea;
|
||||||
|
--foreground: #000000;
|
||||||
|
--primary-cta: #000000;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #ffffff;
|
||||||
|
--background-accent: #e1b875;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Gray Teal Green */
|
||||||
|
:root[data-theme="gray-teal-green"] {
|
||||||
|
--background: #f5f5f5;
|
||||||
|
--card: #ffffff;
|
||||||
|
--foreground: #1c1c1c;
|
||||||
|
--primary-cta: #1f514c;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #159c49;
|
||||||
|
--background-accent: #a8e8ba;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Gray Navy Blue */
|
||||||
|
:root[data-theme="gray-navy-blue"] {
|
||||||
|
--background: #f5f5f5;
|
||||||
|
--card: #ffffff;
|
||||||
|
--foreground: #1c1c1c;
|
||||||
|
--primary-cta: #1f3251;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #15479c;
|
||||||
|
--background-accent: #a8cce8;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Gray Burgundy Red */
|
||||||
|
:root[data-theme="gray-burgundy-red"] {
|
||||||
|
--background: #f5f5f5;
|
||||||
|
--card: #ffffff;
|
||||||
|
--foreground: #1c1c1c;
|
||||||
|
--primary-cta: #511f1f;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #e63946;
|
||||||
|
--background-accent: #e8bea8;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Gray Indigo Purple */
|
||||||
|
:root[data-theme="gray-indigo-purple"] {
|
||||||
|
--background: #f5f5f5;
|
||||||
|
--card: #ffffff;
|
||||||
|
--foreground: #1c1c1c;
|
||||||
|
--primary-cta: #341f51;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #6139e6;
|
||||||
|
--background-accent: #b3a8e8;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Warm Gray Pink */
|
||||||
|
:root[data-theme="warmgray-pink"] {
|
||||||
|
--background: #f7f6f7;
|
||||||
|
--card: #ffffff;
|
||||||
|
--foreground: #1b0c25;
|
||||||
|
--primary-cta: #1b0c25;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #ff93e4;
|
||||||
|
--background-accent: #e8a8c3;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Warm Gray Orange */
|
||||||
|
:root[data-theme="warmgray-orange"] {
|
||||||
|
--background: #f7f6f7;
|
||||||
|
--card: #ffffff;
|
||||||
|
--foreground: #25190c;
|
||||||
|
--primary-cta: #ff6207;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #ffce93;
|
||||||
|
--background-accent: #e8cfa8;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Warm Gray Blue */
|
||||||
|
:root[data-theme="warmgray-blue"] {
|
||||||
|
--background: #f7f6f7;
|
||||||
|
--card: #ffffff;
|
||||||
|
--foreground: #0c1325;
|
||||||
|
--primary-cta: #0798ff;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #93c7ff;
|
||||||
|
--background-accent: #a8cde8;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Warm Gray Indigo */
|
||||||
|
:root[data-theme="warmgray-indigo"] {
|
||||||
|
--background: #f7f6f7;
|
||||||
|
--card: #ffffff;
|
||||||
|
--foreground: #0c1325;
|
||||||
|
--primary-cta: #0b07ff;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #93b7ff;
|
||||||
|
--background-accent: #a8bae8;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Lavender Peach */
|
||||||
|
:root[data-theme="lavender-peach"] {
|
||||||
|
--background: #e3deea;
|
||||||
|
--card: #ffffff;
|
||||||
|
--foreground: #27231f;
|
||||||
|
--primary-cta: #27231f;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #c68a62;
|
||||||
|
--background-accent: #c68a62;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Lavender Blue */
|
||||||
|
:root[data-theme="lavender-blue"] {
|
||||||
|
--background: #e3deea;
|
||||||
|
--card: #ffffff;
|
||||||
|
--foreground: #1f2027;
|
||||||
|
--primary-cta: #1f2027;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #627dc6;
|
||||||
|
--background-accent: #627dc6;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Warm Stone */
|
||||||
|
:root[data-theme="warm-stone"] {
|
||||||
|
--background: #f5f4ef;
|
||||||
|
--card: #dad6cd;
|
||||||
|
--foreground: #2a2928;
|
||||||
|
--primary-cta: #2a2928;
|
||||||
|
--secondary-cta: #ecebea;
|
||||||
|
--accent: #ffffff;
|
||||||
|
--background-accent: #c6b180;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Warm Sand */
|
||||||
|
:root[data-theme="warm-sand"] {
|
||||||
|
--background: #fcf6ec;
|
||||||
|
--card: #f3ede2;
|
||||||
|
--foreground: #2e2521;
|
||||||
|
--primary-cta: #2e2521;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #b2a28b;
|
||||||
|
--background-accent: #b2a28b;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Warm Gray Green */
|
||||||
|
:root[data-theme="warmgray-green"] {
|
||||||
|
--background: #f7f6f7;
|
||||||
|
--card: #ffffff;
|
||||||
|
--foreground: #032419;
|
||||||
|
--primary-cta: #2bb889;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #09b97e;
|
||||||
|
--background-accent: #a8e8c3;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Warm Gray Red */
|
||||||
|
:root[data-theme="warmgray-red"] {
|
||||||
|
--background: #f7f6f7;
|
||||||
|
--card: #ffffff;
|
||||||
|
--foreground: #250c0d;
|
||||||
|
--primary-cta: #b82b40;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #b90941;
|
||||||
|
--background-accent: #e8a8b6;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Light Theme - Warm Gray Yellow */
|
||||||
|
:root[data-theme="warmgray-yellow"] {
|
||||||
|
--background: #f7f6f7;
|
||||||
|
--card: #ffffff;
|
||||||
|
--foreground: #251a0c;
|
||||||
|
--primary-cta: #f4c408;
|
||||||
|
--secondary-cta: #ffffff;
|
||||||
|
--accent: #f4ca26;
|
||||||
|
--background-accent: #e8daa8;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/* ============================================ */
|
||||||
|
/* DARK THEME VARIANTS */
|
||||||
|
/* ============================================ */
|
||||||
|
|
||||||
|
/* Dark Theme - Minimal */
|
||||||
|
:root[data-theme="dark"] {
|
||||||
|
--background: #0a0a0a;
|
||||||
|
--card: #1a1a1a;
|
||||||
|
--foreground: #ffffffe6;
|
||||||
|
--primary-cta: #e6e6e6;
|
||||||
|
--secondary-cta: #1a1a1a;
|
||||||
|
--accent: #737373;
|
||||||
|
--background-accent: #737373;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Dark Theme - Minimal Light Blue */
|
||||||
|
:root[data-theme="dark-minimal-light-blue"] {
|
||||||
|
--background: #0a0a0a;
|
||||||
|
--card: #1a1a1a;
|
||||||
|
--foreground: #f0f8ffe6;
|
||||||
|
--primary-cta: #cee7ff;
|
||||||
|
--secondary-cta: #1a1a1a;
|
||||||
|
--accent: #737373;
|
||||||
|
--background-accent: #737373;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Dark Theme - Minimal Light Green */
|
||||||
|
:root[data-theme="dark-minimal-light-green"] {
|
||||||
|
--background: #0a0a0a;
|
||||||
|
--card: #1a1a1a;
|
||||||
|
--foreground: #f5fffae6;
|
||||||
|
--primary-cta: #80da9b;
|
||||||
|
--secondary-cta: #1a1a1a;
|
||||||
|
--accent: #737373;
|
||||||
|
--background-accent: #737373;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Dark Theme - Minimal Light Red */
|
||||||
|
:root[data-theme="dark-minimal-light-red"] {
|
||||||
|
--background: #0a0a0a;
|
||||||
|
--card: #1a1a1a;
|
||||||
|
--foreground: #fff5f5e6;
|
||||||
|
--primary-cta: #ff7a7a;
|
||||||
|
--secondary-cta: #1a1a1a;
|
||||||
|
--accent: #737373;
|
||||||
|
--background-accent: #737373;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Dark Theme - Minimal Light Purple */
|
||||||
|
:root[data-theme="dark-minimal-light-purple"] {
|
||||||
|
--background: #0a0a0a;
|
||||||
|
--card: #1a1a1a;
|
||||||
|
--foreground: #f8f5ffe6;
|
||||||
|
--primary-cta: #c89bff;
|
||||||
|
--secondary-cta: #1a1a1a;
|
||||||
|
--accent: #737373;
|
||||||
|
--background-accent: #737373;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Dark Theme - Minimal Light Orange */
|
||||||
|
:root[data-theme="dark-minimal-light-orange"] {
|
||||||
|
--background: #0a0a0a;
|
||||||
|
--card: #1a1a1a;
|
||||||
|
--foreground: #fffaf5e6;
|
||||||
|
--primary-cta: #ffaa70;
|
||||||
|
--secondary-cta: #1a1a1a;
|
||||||
|
--accent: #737373;
|
||||||
|
--background-accent: #737373;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/* Dark Theme - Minimal Light Yellow */
|
||||||
|
:root[data-theme="dark-minimal-light-yellow"] {
|
||||||
|
--background: #0a0a0a;
|
||||||
|
--card: #1a1a1a;
|
||||||
|
--foreground: #fffffae6;
|
||||||
|
--primary-cta: #fde047;
|
||||||
|
--secondary-cta: #1a1a1a;
|
||||||
|
--accent: #737373;
|
||||||
|
--background-accent: #737373;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Dark Theme - Light Blue */
|
||||||
|
:root[data-theme="dark-light-blue"] {
|
||||||
|
--background: #010912;
|
||||||
|
--card: #152840;
|
||||||
|
--foreground: #e6f0ff;
|
||||||
|
--primary-cta: #cee7ff;
|
||||||
|
--secondary-cta: #0e1a29;
|
||||||
|
--accent: #3f5c79;
|
||||||
|
--background-accent: #004a93;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Dark Theme - Light Green */
|
||||||
|
:root[data-theme="dark-light-green"] {
|
||||||
|
--background: #000802;
|
||||||
|
--card: #0b1a0b;
|
||||||
|
--foreground: #e6ffe6;
|
||||||
|
--primary-cta: #80da9b;
|
||||||
|
--secondary-cta: #07170b;
|
||||||
|
--accent: #38714a;
|
||||||
|
--background-accent: #2c6541;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Dark Theme - Light Red */
|
||||||
|
:root[data-theme="dark-light-red"] {
|
||||||
|
--background: #080000;
|
||||||
|
--card: #1e0d0d;
|
||||||
|
--foreground: #ffe6e6;
|
||||||
|
--primary-cta: #ff7a7a;
|
||||||
|
--secondary-cta: #1e0909;
|
||||||
|
--accent: #7b4242;
|
||||||
|
--background-accent: #65292c;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Dark Theme - Dark Red */
|
||||||
|
:root[data-theme="dark-dark-red"] {
|
||||||
|
--background: #060000;
|
||||||
|
--card: #1d0d0d;
|
||||||
|
--foreground: #ffe6e6;
|
||||||
|
--primary-cta: #ff3d4a;
|
||||||
|
--secondary-cta: #1f0a0a;
|
||||||
|
--accent: #7b2d2d;
|
||||||
|
--background-accent: #b8111f;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Dark Theme - Light Purple */
|
||||||
|
:root[data-theme="dark-light-purple"] {
|
||||||
|
--background: #050012;
|
||||||
|
--card: #040121;
|
||||||
|
--foreground: #f0e6ff;
|
||||||
|
--primary-cta: #c89bff;
|
||||||
|
--secondary-cta: #1d123b;
|
||||||
|
--accent: #684f7b;
|
||||||
|
--background-accent: #65417c;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Dark Theme - Light Orange */
|
||||||
|
:root[data-theme="dark-light-orange"] {
|
||||||
|
--background: #080200;
|
||||||
|
--card: #1a0d0b;
|
||||||
|
--foreground: #ffe6d5;
|
||||||
|
--primary-cta: #ffaa70;
|
||||||
|
--secondary-cta: #170b07;
|
||||||
|
--accent: #7b5e4a;
|
||||||
|
--background-accent: #b8541e;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Dark Theme - Deep Blue */
|
||||||
|
:root[data-theme="dark-deep-blue"] {
|
||||||
|
--background: #020617;
|
||||||
|
--card: #0f172a;
|
||||||
|
--foreground: #e2e8f0;
|
||||||
|
--primary-cta: #c4d8f9;
|
||||||
|
--secondary-cta: #041633;
|
||||||
|
--accent: #2d30f3;
|
||||||
|
--background-accent: #1d4ed8;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
393
colorThemes.json
Normal file
@@ -0,0 +1,393 @@
|
|||||||
|
{
|
||||||
|
"lightTheme": {
|
||||||
|
"minimalDarkBlue": {
|
||||||
|
"--background": "#ffffff",
|
||||||
|
"--card": "#f9f9f9",
|
||||||
|
"--foreground": "#000612e6",
|
||||||
|
"--primary-cta": "#15479c",
|
||||||
|
"--secondary-cta": "#f9f9f9",
|
||||||
|
"--accent": "#e2e2e2",
|
||||||
|
"--background-accent": "#c4c4c4"
|
||||||
|
},
|
||||||
|
"minimalDarkGreen": {
|
||||||
|
"--background": "#ffffff",
|
||||||
|
"--card": "#f9f9f9",
|
||||||
|
"--foreground": "#000f06e6",
|
||||||
|
"--primary-cta": "#0a7039",
|
||||||
|
"--secondary-cta": "#f9f9f9",
|
||||||
|
"--accent": "#e2e2e2",
|
||||||
|
"--background-accent": "#c4c4c4"
|
||||||
|
},
|
||||||
|
"minimalLightRed": {
|
||||||
|
"--background": "#ffffff",
|
||||||
|
"--card": "#f9f9f9",
|
||||||
|
"--foreground": "#120006e6",
|
||||||
|
"--primary-cta": "#e63946",
|
||||||
|
"--secondary-cta": "#f9f9f9",
|
||||||
|
"--accent": "#e2e2e2",
|
||||||
|
"--background-accent": "#c4c4c4"
|
||||||
|
},
|
||||||
|
"minimalLightOrange": {
|
||||||
|
"--background": "#ffffff",
|
||||||
|
"--card": "#f9f9f9",
|
||||||
|
"--foreground": "#120a00e6",
|
||||||
|
"--primary-cta": "#ff8c42",
|
||||||
|
"--secondary-cta": "#f9f9f9",
|
||||||
|
"--accent": "#e2e2e2",
|
||||||
|
"--background-accent": "#c4c4c4"
|
||||||
|
},
|
||||||
|
"darkBlue": {
|
||||||
|
"--background": "#f5faff",
|
||||||
|
"--card": "#f1f8ff",
|
||||||
|
"--foreground": "#001122",
|
||||||
|
"--primary-cta": "#15479c",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#a8cce8",
|
||||||
|
"--background-accent": "#7ba3cf"
|
||||||
|
},
|
||||||
|
"darkGreen": {
|
||||||
|
"--background": "#fafffb",
|
||||||
|
"--card": "#f7fffa",
|
||||||
|
"--foreground": "#001a0a",
|
||||||
|
"--primary-cta": "#0a7039",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#a8d9be",
|
||||||
|
"--background-accent": "#6bbf8e"
|
||||||
|
},
|
||||||
|
"lightRed": {
|
||||||
|
"--background": "#fffafa",
|
||||||
|
"--card": "#fff7f7",
|
||||||
|
"--foreground": "#1a0000",
|
||||||
|
"--primary-cta": "#e63946",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#f5c4c7",
|
||||||
|
"--background-accent": "#f09199"
|
||||||
|
},
|
||||||
|
"lightPurple": {
|
||||||
|
"--background": "#fbfaff",
|
||||||
|
"--card": "#f7f5ff",
|
||||||
|
"--foreground": "#0f0022",
|
||||||
|
"--primary-cta": "#8b5cf6",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#d8cef5",
|
||||||
|
"--background-accent": "#c4a8f9"
|
||||||
|
},
|
||||||
|
"warmCream": {
|
||||||
|
"--background": "#f6f0e9",
|
||||||
|
"--card": "#efe7dd",
|
||||||
|
"--foreground": "#2b180a",
|
||||||
|
"--primary-cta": "#2b180a",
|
||||||
|
"--secondary-cta": "#efe7dd",
|
||||||
|
"--accent": "#94877c",
|
||||||
|
"--background-accent": "#afa094"
|
||||||
|
},
|
||||||
|
"grayBlueAccent": {
|
||||||
|
"--background": "#f5f5f5",
|
||||||
|
"--card": "#ffffff",
|
||||||
|
"--foreground": "#1c1c1c",
|
||||||
|
"--primary-cta": "#1c1c1c",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#15479c",
|
||||||
|
"--background-accent": "#a8cce8"
|
||||||
|
},
|
||||||
|
"grayGreenAccent": {
|
||||||
|
"--background": "#f5f5f5",
|
||||||
|
"--card": "#ffffff",
|
||||||
|
"--foreground": "#1c1c1c",
|
||||||
|
"--primary-cta": "#1c1c1c",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#159c49",
|
||||||
|
"--background-accent": "#a8e8ba"
|
||||||
|
},
|
||||||
|
"grayRedAccent": {
|
||||||
|
"--background": "#f5f5f5",
|
||||||
|
"--card": "#ffffff",
|
||||||
|
"--foreground": "#1c1c1c",
|
||||||
|
"--primary-cta": "#1c1c1c",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#e63946",
|
||||||
|
"--background-accent": "#e8bea8"
|
||||||
|
},
|
||||||
|
"grayPurpleAccent": {
|
||||||
|
"--background": "#f5f5f5",
|
||||||
|
"--card": "#ffffff",
|
||||||
|
"--foreground": "#1c1c1c",
|
||||||
|
"--primary-cta": "#1c1c1c",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#6139e6",
|
||||||
|
"--background-accent": "#b3a8e8"
|
||||||
|
},
|
||||||
|
"warmBeige": {
|
||||||
|
"--background": "#efebe5",
|
||||||
|
"--card": "#f7f2ea",
|
||||||
|
"--foreground": "#000000",
|
||||||
|
"--primary-cta": "#000000",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#ffffff",
|
||||||
|
"--background-accent": "#e1b875"
|
||||||
|
},
|
||||||
|
"grayTealGreen": {
|
||||||
|
"--background": "#f5f5f5",
|
||||||
|
"--card": "#ffffff",
|
||||||
|
"--foreground": "#1c1c1c",
|
||||||
|
"--primary-cta": "#1f514c",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#159c49",
|
||||||
|
"--background-accent": "#a8e8ba"
|
||||||
|
},
|
||||||
|
"grayNavyBlue": {
|
||||||
|
"--background": "#f5f5f5",
|
||||||
|
"--card": "#ffffff",
|
||||||
|
"--foreground": "#1c1c1c",
|
||||||
|
"--primary-cta": "#1f3251",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#15479c",
|
||||||
|
"--background-accent": "#a8cce8"
|
||||||
|
},
|
||||||
|
"grayBurgundyRed": {
|
||||||
|
"--background": "#f5f5f5",
|
||||||
|
"--card": "#ffffff",
|
||||||
|
"--foreground": "#1c1c1c",
|
||||||
|
"--primary-cta": "#511f1f",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#e63946",
|
||||||
|
"--background-accent": "#e8bea8"
|
||||||
|
},
|
||||||
|
"grayIndigoPurple": {
|
||||||
|
"--background": "#f5f5f5",
|
||||||
|
"--card": "#ffffff",
|
||||||
|
"--foreground": "#1c1c1c",
|
||||||
|
"--primary-cta": "#341f51",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#6139e6",
|
||||||
|
"--background-accent": "#b3a8e8"
|
||||||
|
},
|
||||||
|
"warmgrayPink": {
|
||||||
|
"--background": "#f7f6f7",
|
||||||
|
"--card": "#ffffff",
|
||||||
|
"--foreground": "#1b0c25",
|
||||||
|
"--primary-cta": "#1b0c25",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#ff93e4",
|
||||||
|
"--background-accent": "#e8a8c3"
|
||||||
|
},
|
||||||
|
"warmgrayOrange": {
|
||||||
|
"--background": "#f7f6f7",
|
||||||
|
"--card": "#ffffff",
|
||||||
|
"--foreground": "#25190c",
|
||||||
|
"--primary-cta": "#ff6207",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#ffce93",
|
||||||
|
"--background-accent": "#e8cfa8"
|
||||||
|
},
|
||||||
|
"warmgrayBlue": {
|
||||||
|
"--background": "#f7f6f7",
|
||||||
|
"--card": "#ffffff",
|
||||||
|
"--foreground": "#0c1325",
|
||||||
|
"--primary-cta": "#0798ff",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#93c7ff",
|
||||||
|
"--background-accent": "#a8cde8"
|
||||||
|
},
|
||||||
|
"warmgrayIndigo": {
|
||||||
|
"--background": "#f7f6f7",
|
||||||
|
"--card": "#ffffff",
|
||||||
|
"--foreground": "#0c1325",
|
||||||
|
"--primary-cta": "#0b07ff",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#93b7ff",
|
||||||
|
"--background-accent": "#a8bae8"
|
||||||
|
},
|
||||||
|
"lavenderPeach": {
|
||||||
|
"--background": "#e3deea",
|
||||||
|
"--card": "#ffffff",
|
||||||
|
"--foreground": "#27231f",
|
||||||
|
"--primary-cta": "#27231f",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#c68a62",
|
||||||
|
"--background-accent": "#c68a62"
|
||||||
|
},
|
||||||
|
"lavenderBlue": {
|
||||||
|
"--background": "#e3deea",
|
||||||
|
"--card": "#ffffff",
|
||||||
|
"--foreground": "#1f2027",
|
||||||
|
"--primary-cta": "#1f2027",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#627dc6",
|
||||||
|
"--background-accent": "#627dc6"
|
||||||
|
},
|
||||||
|
"warmStone": {
|
||||||
|
"--background": "#f5f4ef",
|
||||||
|
"--card": "#dad6cd",
|
||||||
|
"--foreground": "#2a2928",
|
||||||
|
"--primary-cta": "#2a2928",
|
||||||
|
"--secondary-cta": "#ecebea",
|
||||||
|
"--accent": "#ffffff",
|
||||||
|
"--background-accent": "#c6b180"
|
||||||
|
},
|
||||||
|
"warmSand": {
|
||||||
|
"--background": "#fcf6ec",
|
||||||
|
"--card": "#f3ede2",
|
||||||
|
"--foreground": "#2e2521",
|
||||||
|
"--primary-cta": "#2e2521",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#b2a28b",
|
||||||
|
"--background-accent": "#b2a28b"
|
||||||
|
},
|
||||||
|
"warmgrayGreen": {
|
||||||
|
"--background": "#f7f6f7",
|
||||||
|
"--card": "#ffffff",
|
||||||
|
"--foreground": "#032419",
|
||||||
|
"--primary-cta": "#2bb889",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#09b97e",
|
||||||
|
"--background-accent": "#a8e8c3"
|
||||||
|
},
|
||||||
|
"warmgrayRed": {
|
||||||
|
"--background": "#f7f6f7",
|
||||||
|
"--card": "#ffffff",
|
||||||
|
"--foreground": "#250c0d",
|
||||||
|
"--primary-cta": "#b82b40",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#b90941",
|
||||||
|
"--background-accent": "#e8a8b6"
|
||||||
|
},
|
||||||
|
"warmgrayYellow": {
|
||||||
|
"--background": "#f7f6f7",
|
||||||
|
"--card": "#ffffff",
|
||||||
|
"--foreground": "#251a0c",
|
||||||
|
"--primary-cta": "#f4c408",
|
||||||
|
"--secondary-cta": "#ffffff",
|
||||||
|
"--accent": "#f4ca26",
|
||||||
|
"--background-accent": "#e8daa8"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"darkTheme": {
|
||||||
|
"minimal": {
|
||||||
|
"--background": "#0a0a0a",
|
||||||
|
"--card": "#1a1a1a",
|
||||||
|
"--foreground": "#ffffffe6",
|
||||||
|
"--primary-cta": "#e6e6e6",
|
||||||
|
"--secondary-cta": "#1a1a1a",
|
||||||
|
"--accent": "#737373",
|
||||||
|
"--background-accent": "#737373"
|
||||||
|
},
|
||||||
|
"minimalLightBlue": {
|
||||||
|
"--background": "#0a0a0a",
|
||||||
|
"--card": "#1a1a1a",
|
||||||
|
"--foreground": "#f0f8ffe6",
|
||||||
|
"--primary-cta": "#cee7ff",
|
||||||
|
"--secondary-cta": "#1a1a1a",
|
||||||
|
"--accent": "#737373",
|
||||||
|
"--background-accent": "#737373"
|
||||||
|
},
|
||||||
|
"minimalLightGreen": {
|
||||||
|
"--background": "#0a0a0a",
|
||||||
|
"--card": "#1a1a1a",
|
||||||
|
"--foreground": "#f5fffae6",
|
||||||
|
"--primary-cta": "#80da9b",
|
||||||
|
"--secondary-cta": "#1a1a1a",
|
||||||
|
"--accent": "#737373",
|
||||||
|
"--background-accent": "#737373"
|
||||||
|
},
|
||||||
|
"minimalLightRed": {
|
||||||
|
"--background": "#0a0a0a",
|
||||||
|
"--card": "#1a1a1a",
|
||||||
|
"--foreground": "#fff5f5e6",
|
||||||
|
"--primary-cta": "#ff7a7a",
|
||||||
|
"--secondary-cta": "#1a1a1a",
|
||||||
|
"--accent": "#737373",
|
||||||
|
"--background-accent": "#737373"
|
||||||
|
},
|
||||||
|
"minimalLightPurple": {
|
||||||
|
"--background": "#0a0a0a",
|
||||||
|
"--card": "#1a1a1a",
|
||||||
|
"--foreground": "#f8f5ffe6",
|
||||||
|
"--primary-cta": "#c89bff",
|
||||||
|
"--secondary-cta": "#1a1a1a",
|
||||||
|
"--accent": "#737373",
|
||||||
|
"--background-accent": "#737373"
|
||||||
|
},
|
||||||
|
"minimalLightOrange": {
|
||||||
|
"--background": "#0a0a0a",
|
||||||
|
"--card": "#1a1a1a",
|
||||||
|
"--foreground": "#fffaf5e6",
|
||||||
|
"--primary-cta": "#ffaa70",
|
||||||
|
"--secondary-cta": "#1a1a1a",
|
||||||
|
"--accent": "#737373",
|
||||||
|
"--background-accent": "#737373"
|
||||||
|
},
|
||||||
|
"minimalLightYellow": {
|
||||||
|
"--background": "#0a0a0a",
|
||||||
|
"--card": "#1a1a1a",
|
||||||
|
"--foreground": "#fffffae6",
|
||||||
|
"--primary-cta": "#fde047",
|
||||||
|
"--secondary-cta": "#1a1a1a",
|
||||||
|
"--accent": "#737373",
|
||||||
|
"--background-accent": "#737373"
|
||||||
|
},
|
||||||
|
"lightBlue": {
|
||||||
|
"--background": "#010912",
|
||||||
|
"--card": "#152840",
|
||||||
|
"--foreground": "#e6f0ff",
|
||||||
|
"--primary-cta": "#cee7ff",
|
||||||
|
"--secondary-cta": "#0e1a29",
|
||||||
|
"--accent": "#3f5c79",
|
||||||
|
"--background-accent": "#004a93"
|
||||||
|
},
|
||||||
|
"lightGreen": {
|
||||||
|
"--background": "#000802",
|
||||||
|
"--card": "#0b1a0b",
|
||||||
|
"--foreground": "#e6ffe6",
|
||||||
|
"--primary-cta": "#80da9b",
|
||||||
|
"--secondary-cta": "#07170b",
|
||||||
|
"--accent": "#38714a",
|
||||||
|
"--background-accent": "#2c6541"
|
||||||
|
},
|
||||||
|
"lightRed": {
|
||||||
|
"--background": "#080000",
|
||||||
|
"--card": "#1e0d0d",
|
||||||
|
"--foreground": "#ffe6e6",
|
||||||
|
"--primary-cta": "#ff7a7a",
|
||||||
|
"--secondary-cta": "#1e0909",
|
||||||
|
"--accent": "#7b4242",
|
||||||
|
"--background-accent": "#65292c"
|
||||||
|
},
|
||||||
|
"darkRed": {
|
||||||
|
"--background": "#060000",
|
||||||
|
"--card": "#1d0d0d",
|
||||||
|
"--foreground": "#ffe6e6",
|
||||||
|
"--primary-cta": "#ff3d4a",
|
||||||
|
"--secondary-cta": "#1f0a0a",
|
||||||
|
"--accent": "#7b2d2d",
|
||||||
|
"--background-accent": "#b8111f"
|
||||||
|
},
|
||||||
|
"lightPurple": {
|
||||||
|
"--background": "#050012",
|
||||||
|
"--card": "#040121",
|
||||||
|
"--foreground": "#f0e6ff",
|
||||||
|
"--primary-cta": "#c89bff",
|
||||||
|
"--secondary-cta": "#1d123b",
|
||||||
|
"--accent": "#684f7b",
|
||||||
|
"--background-accent": "#65417c"
|
||||||
|
},
|
||||||
|
"lightOrange": {
|
||||||
|
"--background": "#080200",
|
||||||
|
"--card": "#1a0d0b",
|
||||||
|
"--foreground": "#ffe6d5",
|
||||||
|
"--primary-cta": "#ffaa70",
|
||||||
|
"--secondary-cta": "#170b07",
|
||||||
|
"--accent": "#7b5e4a",
|
||||||
|
"--background-accent": "#b8541e"
|
||||||
|
},
|
||||||
|
"deepBlue": {
|
||||||
|
"--background": "#020617",
|
||||||
|
"--card": "#0f172a",
|
||||||
|
"--foreground": "#e2e8f0",
|
||||||
|
"--primary-cta": "#c4d8f9",
|
||||||
|
"--secondary-cta": "#041633",
|
||||||
|
"--accent": "#2d30f3",
|
||||||
|
"--background-accent": "#1d4ed8"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
500
docs/ACCESSIBILITY.md
Normal file
@@ -0,0 +1,500 @@
|
|||||||
|
# Accessibility Standards
|
||||||
|
|
||||||
|
This document outlines accessibility (a11y) requirements for all components in the library, ensuring compatibility with screen readers and assistive technologies.
|
||||||
|
|
||||||
|
## Interactive Components
|
||||||
|
|
||||||
|
For buttons, links, and other interactive elements.
|
||||||
|
|
||||||
|
### Required Props
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
interface ButtonProps {
|
||||||
|
text: string;
|
||||||
|
onClick?: () => void;
|
||||||
|
className?: string;
|
||||||
|
// Accessibility props
|
||||||
|
disabled?: boolean;
|
||||||
|
ariaLabel?: string;
|
||||||
|
type?: "button" | "submit" | "reset";
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Implementation Pattern
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
const Button = ({
|
||||||
|
text,
|
||||||
|
onClick,
|
||||||
|
className = "",
|
||||||
|
disabled = false,
|
||||||
|
ariaLabel,
|
||||||
|
type = "button",
|
||||||
|
}: ButtonProps) => {
|
||||||
|
return (
|
||||||
|
<button
|
||||||
|
type={type}
|
||||||
|
onClick={onClick}
|
||||||
|
disabled={disabled}
|
||||||
|
aria-label={ariaLabel || text}
|
||||||
|
className={cls(
|
||||||
|
"base-button-styles",
|
||||||
|
"disabled:cursor-not-allowed disabled:opacity-50",
|
||||||
|
className
|
||||||
|
)}
|
||||||
|
>
|
||||||
|
{text}
|
||||||
|
</button>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
### Key Points
|
||||||
|
|
||||||
|
**ariaLabel:**
|
||||||
|
- Optional prop with sensible fallback
|
||||||
|
- Falls back to `text` content for buttons
|
||||||
|
- Provides context for screen readers
|
||||||
|
|
||||||
|
**type:**
|
||||||
|
- Default: `"button"`
|
||||||
|
- Options: `"button" | "submit" | "reset"`
|
||||||
|
- Prevents accidental form submission
|
||||||
|
|
||||||
|
**disabled:**
|
||||||
|
- Default: `false`
|
||||||
|
- Includes visual disabled states:
|
||||||
|
- `disabled:cursor-not-allowed` - Shows not-allowed cursor
|
||||||
|
- `disabled:opacity-50` - Reduces opacity for visual feedback
|
||||||
|
|
||||||
|
## Media Components
|
||||||
|
|
||||||
|
### Images
|
||||||
|
|
||||||
|
**Required Props:**
|
||||||
|
```tsx
|
||||||
|
interface ImageProps {
|
||||||
|
imageSrc: string;
|
||||||
|
imageAlt?: string; // Empty string for decorative images
|
||||||
|
className?: string;
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Implementation:**
|
||||||
|
```tsx
|
||||||
|
const ImageComponent = ({
|
||||||
|
imageSrc,
|
||||||
|
imageAlt = "",
|
||||||
|
className = "",
|
||||||
|
}: ImageProps) => {
|
||||||
|
return (
|
||||||
|
<Image
|
||||||
|
src={imageSrc}
|
||||||
|
alt={imageAlt}
|
||||||
|
aria-hidden={imageAlt === ""}
|
||||||
|
className={className}
|
||||||
|
/>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
**Key Points:**
|
||||||
|
- `imageAlt` - Alt text for images
|
||||||
|
- Provide descriptive alt text for meaningful images
|
||||||
|
- Use empty string (`""`) for decorative images
|
||||||
|
- `aria-hidden={true}` - When alt is empty, mark as decorative
|
||||||
|
- Screen readers will skip decorative images
|
||||||
|
|
||||||
|
### Videos
|
||||||
|
|
||||||
|
**Required Props:**
|
||||||
|
```tsx
|
||||||
|
interface VideoProps {
|
||||||
|
videoSrc: string;
|
||||||
|
videoAriaLabel?: string;
|
||||||
|
className?: string;
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Implementation:**
|
||||||
|
```tsx
|
||||||
|
const VideoComponent = ({
|
||||||
|
videoSrc,
|
||||||
|
videoAriaLabel = "Video content",
|
||||||
|
className = "",
|
||||||
|
}: VideoProps) => {
|
||||||
|
return (
|
||||||
|
<video
|
||||||
|
src={videoSrc}
|
||||||
|
aria-label={videoAriaLabel}
|
||||||
|
autoPlay
|
||||||
|
loop
|
||||||
|
muted
|
||||||
|
playsInline
|
||||||
|
className={className}
|
||||||
|
/>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
**Key Points:**
|
||||||
|
- `videoAriaLabel` - Descriptive label for video element
|
||||||
|
- Default: Sensible fallback like "Video content" or "Hero video"
|
||||||
|
- Always include for screen reader context
|
||||||
|
|
||||||
|
### Media Content Pattern
|
||||||
|
|
||||||
|
For components supporting both images and videos:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
interface HeroProps {
|
||||||
|
imageSrc?: string;
|
||||||
|
imageAlt?: string;
|
||||||
|
videoSrc?: string;
|
||||||
|
videoAriaLabel?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
const Hero = ({
|
||||||
|
imageSrc,
|
||||||
|
imageAlt = "",
|
||||||
|
videoSrc,
|
||||||
|
videoAriaLabel = "Hero video",
|
||||||
|
}: HeroProps) => {
|
||||||
|
return (
|
||||||
|
<>
|
||||||
|
{videoSrc ? (
|
||||||
|
<video
|
||||||
|
src={videoSrc}
|
||||||
|
aria-label={videoAriaLabel}
|
||||||
|
autoPlay
|
||||||
|
loop
|
||||||
|
muted
|
||||||
|
playsInline
|
||||||
|
/>
|
||||||
|
) : (
|
||||||
|
imageSrc && (
|
||||||
|
<Image
|
||||||
|
src={imageSrc}
|
||||||
|
alt={imageAlt}
|
||||||
|
aria-hidden={imageAlt === ""}
|
||||||
|
/>
|
||||||
|
)
|
||||||
|
)}
|
||||||
|
</>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
## Section Components
|
||||||
|
|
||||||
|
### Semantic HTML
|
||||||
|
|
||||||
|
Use semantic HTML elements for proper document structure:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
<section> // For sections of content
|
||||||
|
<header> // For page/section headers
|
||||||
|
<nav> // For navigation
|
||||||
|
<footer> // For page/section footers
|
||||||
|
<article> // For self-contained content
|
||||||
|
<aside> // For tangentially related content
|
||||||
|
<main> // For main content area
|
||||||
|
```
|
||||||
|
|
||||||
|
### Section Pattern
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
interface SectionProps {
|
||||||
|
title: string;
|
||||||
|
description: string;
|
||||||
|
ariaLabel?: string;
|
||||||
|
className?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
const Section = ({
|
||||||
|
title,
|
||||||
|
description,
|
||||||
|
ariaLabel = "Section name",
|
||||||
|
className = "",
|
||||||
|
}: SectionProps) => {
|
||||||
|
return (
|
||||||
|
<section
|
||||||
|
aria-label={ariaLabel}
|
||||||
|
className={cls("w-full py-20", className)}
|
||||||
|
>
|
||||||
|
<div className="w-content-width mx-auto">
|
||||||
|
<h2>{title}</h2>
|
||||||
|
<p>{description}</p>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
### Sensible Default aria-labels
|
||||||
|
|
||||||
|
Each section type should have a descriptive default:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
// Hero section
|
||||||
|
ariaLabel = "Hero section"
|
||||||
|
|
||||||
|
// About section
|
||||||
|
ariaLabel = "About section"
|
||||||
|
|
||||||
|
// Feature section
|
||||||
|
ariaLabel = "Features section"
|
||||||
|
|
||||||
|
// Testimonial section
|
||||||
|
ariaLabel = "Testimonials section"
|
||||||
|
|
||||||
|
// Footer
|
||||||
|
ariaLabel = "Footer"
|
||||||
|
|
||||||
|
// Navigation
|
||||||
|
ariaLabel = "Navigation"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Heading Hierarchy
|
||||||
|
|
||||||
|
Maintain proper heading levels:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
<h1> // Page title (once per page)
|
||||||
|
<h2> // Section titles
|
||||||
|
<h3> // Subsection titles
|
||||||
|
<h4> // Card/component titles
|
||||||
|
```
|
||||||
|
|
||||||
|
**Example:**
|
||||||
|
```tsx
|
||||||
|
<section aria-label="Features section">
|
||||||
|
<h2>Our Features</h2> {/* Section title */}
|
||||||
|
<div>
|
||||||
|
<h3>Feature One</h3> {/* Feature title */}
|
||||||
|
<p>Description...</p>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
```
|
||||||
|
|
||||||
|
## Form Components
|
||||||
|
|
||||||
|
### Input Fields
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
interface InputProps {
|
||||||
|
label: string;
|
||||||
|
id: string;
|
||||||
|
type?: string;
|
||||||
|
required?: boolean;
|
||||||
|
ariaLabel?: string;
|
||||||
|
ariaDescribedBy?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
const Input = ({
|
||||||
|
label,
|
||||||
|
id,
|
||||||
|
type = "text",
|
||||||
|
required = false,
|
||||||
|
ariaLabel,
|
||||||
|
ariaDescribedBy,
|
||||||
|
}: InputProps) => {
|
||||||
|
return (
|
||||||
|
<div>
|
||||||
|
<label htmlFor={id}>
|
||||||
|
{label}
|
||||||
|
{required && <span aria-label="required">*</span>}
|
||||||
|
</label>
|
||||||
|
<input
|
||||||
|
id={id}
|
||||||
|
type={type}
|
||||||
|
required={required}
|
||||||
|
aria-label={ariaLabel || label}
|
||||||
|
aria-describedby={ariaDescribedBy}
|
||||||
|
/>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
**Key Points:**
|
||||||
|
- Always associate `<label>` with input using `htmlFor` and `id`
|
||||||
|
- Mark required fields visually and semantically
|
||||||
|
- Use `aria-describedby` for error messages or hints
|
||||||
|
|
||||||
|
### Form Validation
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
const [error, setError] = useState("");
|
||||||
|
|
||||||
|
<input
|
||||||
|
aria-invalid={!!error}
|
||||||
|
aria-describedby={error ? "error-message" : undefined}
|
||||||
|
/>
|
||||||
|
{error && (
|
||||||
|
<p id="error-message" role="alert">
|
||||||
|
{error}
|
||||||
|
</p>
|
||||||
|
)}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Focus Management
|
||||||
|
|
||||||
|
### Focus Indicators
|
||||||
|
|
||||||
|
Never remove focus outlines without providing alternatives:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
// ❌ WRONG
|
||||||
|
className="outline-none"
|
||||||
|
|
||||||
|
// ✅ CORRECT - Custom focus indicator
|
||||||
|
className="focus:outline-none focus:ring-2 focus:ring-foreground/50"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Focus Trap (for modals/dialogs)
|
||||||
|
|
||||||
|
When implementing modals or dialogs, ensure:
|
||||||
|
- Focus moves to modal when opened
|
||||||
|
- Tab/Shift+Tab cycles through modal elements only
|
||||||
|
- Focus returns to trigger element when closed
|
||||||
|
- Escape key closes modal
|
||||||
|
|
||||||
|
## Keyboard Navigation
|
||||||
|
|
||||||
|
### Interactive Elements
|
||||||
|
|
||||||
|
All interactive elements must be keyboard accessible:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
// Buttons and links work by default
|
||||||
|
<button onClick={handleClick}>Click me</button>
|
||||||
|
<a href="/page">Link</a>
|
||||||
|
|
||||||
|
// Custom interactive elements need tabIndex and keyboard handlers
|
||||||
|
<div
|
||||||
|
role="button"
|
||||||
|
tabIndex={0}
|
||||||
|
onClick={handleClick}
|
||||||
|
onKeyDown={(e) => {
|
||||||
|
if (e.key === 'Enter' || e.key === ' ') {
|
||||||
|
e.preventDefault();
|
||||||
|
handleClick();
|
||||||
|
}
|
||||||
|
}}
|
||||||
|
>
|
||||||
|
Custom button
|
||||||
|
</div>
|
||||||
|
```
|
||||||
|
|
||||||
|
### Skip Links
|
||||||
|
|
||||||
|
For navigation-heavy pages, provide skip links:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
<a href="#main-content" className="sr-only focus:not-sr-only">
|
||||||
|
Skip to main content
|
||||||
|
</a>
|
||||||
|
```
|
||||||
|
|
||||||
|
## Screen Reader Only Content
|
||||||
|
|
||||||
|
Use the `sr-only` class for content that should only be read by screen readers:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
<span className="sr-only">Additional context for screen readers</span>
|
||||||
|
```
|
||||||
|
|
||||||
|
Tailwind's `sr-only` class:
|
||||||
|
```css
|
||||||
|
.sr-only {
|
||||||
|
position: absolute;
|
||||||
|
width: 1px;
|
||||||
|
height: 1px;
|
||||||
|
padding: 0;
|
||||||
|
margin: -1px;
|
||||||
|
overflow: hidden;
|
||||||
|
clip: rect(0, 0, 0, 0);
|
||||||
|
white-space: nowrap;
|
||||||
|
border-width: 0;
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## ARIA Roles
|
||||||
|
|
||||||
|
Use ARIA roles when semantic HTML isn't sufficient:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
// Navigation
|
||||||
|
<nav role="navigation" aria-label="Main navigation">
|
||||||
|
|
||||||
|
// Button (for non-button elements)
|
||||||
|
<div role="button" tabIndex={0}>
|
||||||
|
|
||||||
|
// Alert/Status messages
|
||||||
|
<div role="alert">Error message</div>
|
||||||
|
<div role="status">Loading...</div>
|
||||||
|
|
||||||
|
// Presentation (decorative)
|
||||||
|
<div role="presentation">
|
||||||
|
|
||||||
|
// Dialog/Modal
|
||||||
|
<div role="dialog" aria-modal="true" aria-labelledby="dialog-title">
|
||||||
|
```
|
||||||
|
|
||||||
|
## Loading States
|
||||||
|
|
||||||
|
Provide feedback for loading states:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
const [isLoading, setIsLoading] = useState(false);
|
||||||
|
|
||||||
|
<button disabled={isLoading} aria-busy={isLoading}>
|
||||||
|
{isLoading ? (
|
||||||
|
<>
|
||||||
|
<span className="sr-only">Loading...</span>
|
||||||
|
<Spinner aria-hidden="true" />
|
||||||
|
</>
|
||||||
|
) : (
|
||||||
|
"Submit"
|
||||||
|
)}
|
||||||
|
</button>
|
||||||
|
```
|
||||||
|
|
||||||
|
## Accessibility Checklist
|
||||||
|
|
||||||
|
### Interactive Components
|
||||||
|
- [ ] Add `ariaLabel` prop (optional with sensible fallback)
|
||||||
|
- [ ] Add `type` prop for buttons (default: `"button"`)
|
||||||
|
- [ ] Add `disabled` prop with visual states
|
||||||
|
- [ ] Include disabled state styling (`disabled:cursor-not-allowed disabled:opacity-50`)
|
||||||
|
- [ ] Ensure keyboard accessibility (Enter/Space for custom elements)
|
||||||
|
- [ ] Provide custom focus indicators if removing default outline
|
||||||
|
|
||||||
|
### Media Components
|
||||||
|
- [ ] Images: Add `imageAlt` prop
|
||||||
|
- [ ] Images: Use `aria-hidden={true}` when alt is empty (decorative)
|
||||||
|
- [ ] Videos: Add `videoAriaLabel` prop with sensible default
|
||||||
|
- [ ] Provide meaningful default labels
|
||||||
|
|
||||||
|
### Section Components
|
||||||
|
- [ ] Use semantic HTML (`<section>`, `<header>`, `<nav>`, `<footer>`)
|
||||||
|
- [ ] Add `ariaLabel` prop with sensible default
|
||||||
|
- [ ] Follow proper heading hierarchy (h1 → h2 → h3)
|
||||||
|
- [ ] Use `w-full py-20` for section spacing (except hero/footer)
|
||||||
|
- [ ] Use `w-content-width mx-auto` for content wrapper
|
||||||
|
|
||||||
|
### Form Components
|
||||||
|
- [ ] Associate labels with inputs using `htmlFor` and `id`
|
||||||
|
- [ ] Mark required fields semantically
|
||||||
|
- [ ] Use `aria-invalid` for validation errors
|
||||||
|
- [ ] Use `aria-describedby` for error messages/hints
|
||||||
|
- [ ] Provide `role="alert"` for error messages
|
||||||
|
|
||||||
|
### General
|
||||||
|
- [ ] Test with keyboard navigation (Tab, Shift+Tab, Enter, Space, Escape)
|
||||||
|
- [ ] Test with screen reader (VoiceOver, NVDA, JAWS)
|
||||||
|
- [ ] Ensure sufficient color contrast (WCAG AA minimum)
|
||||||
|
- [ ] Provide focus indicators for all interactive elements
|
||||||
|
- [ ] Use semantic HTML before ARIA roles
|
||||||
|
- [ ] Include screen reader only text when needed (`sr-only`)
|
||||||
491
docs/CARDSTACK_SECTIONS.md
Normal file
@@ -0,0 +1,491 @@
|
|||||||
|
# CardStack Section Pattern
|
||||||
|
|
||||||
|
This document covers the CardStack pattern used in Feature, Product, Pricing, Testimonial, Team, Blog, and Metrics section components.
|
||||||
|
|
||||||
|
## Required Type Imports
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
// Centralized type definitions
|
||||||
|
import type { TextboxLayout, InvertedBackground } from "@/providers/themeProvider/config/constants";
|
||||||
|
import type { ButtonConfig, GridVariant, CardAnimationType, TitleSegment } from "@/components/cardStack/types";
|
||||||
|
```
|
||||||
|
|
||||||
|
**Key Types:**
|
||||||
|
- `TextboxLayout` - Layout options for section headers ("default" | "split" | "split-actions" | "split-description" | "inline-image")
|
||||||
|
- `InvertedBackground` - Background inversion options ("noInvert" | "invertDefault")
|
||||||
|
- `TitleSegment` - Type for inline image segments ({ type: "text" | "image", content/src, alt? })
|
||||||
|
- `ButtonConfig` - Button configuration interface
|
||||||
|
- `GridVariant` - Grid layout variants
|
||||||
|
- `CardAnimationType` - Card animation types
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
CardStack is an intelligent layout component that automatically switches between grid, carousel, and timeline layouts based on item count and configuration.
|
||||||
|
|
||||||
|
**Mode Selection (Automatic):**
|
||||||
|
- **1-4 items**: Grid mode (displays as bento grid)
|
||||||
|
- **5+ items**: Carousel mode (auto-scrolling or button-controlled)
|
||||||
|
- **3-6 items with timeline variant**: Timeline layout (or carousel if 7+)
|
||||||
|
|
||||||
|
## Grid Variants
|
||||||
|
|
||||||
|
There are 9 bento grid layouts plus uniform layouts:
|
||||||
|
|
||||||
|
### Uniform Layouts
|
||||||
|
- `uniform-all-items-equal` - All items same size (default)
|
||||||
|
- `uniform-2-items` - Two equal columns
|
||||||
|
- `uniform-3-items` - Three equal columns
|
||||||
|
- `uniform-4-items` - Four equal columns
|
||||||
|
|
||||||
|
### Bento Layouts (Asymmetric)
|
||||||
|
- `two-columns-alternating-heights` - Alternating tall/short columns
|
||||||
|
- `asymmetric-60-wide-40-narrow` - 60% wide left, 40% narrow right
|
||||||
|
- `three-columns-all-equal-width` - Three equal columns
|
||||||
|
- `four-items-2x2-equal-grid` - Perfect 2x2 grid
|
||||||
|
- `one-large-right-three-stacked-left` - Left: 3 items, Right: 1 large
|
||||||
|
- `items-top-row-full-width-bottom` - Top: full width, Bottom: items
|
||||||
|
- `full-width-top-items-bottom-row` - Full width top, items below
|
||||||
|
- `one-large-left-three-stacked-right` - Left: 1 large, Right: 3 items
|
||||||
|
- `timeline` - Zigzag timeline layout
|
||||||
|
|
||||||
|
## Height Control Pattern
|
||||||
|
|
||||||
|
### uniformGridCustomHeightClasses Prop
|
||||||
|
|
||||||
|
All CardStack-based components should accept this optional prop to control item heights in both grid and carousel modes.
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
interface SectionCardProps {
|
||||||
|
items: ItemType[];
|
||||||
|
gridVariant: GridVariant;
|
||||||
|
uniformGridCustomHeightClasses?: string;
|
||||||
|
carouselMode?: "auto" | "buttons";
|
||||||
|
// ... other props
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Default Values by Component Type
|
||||||
|
|
||||||
|
**Most components (Feature, Product, Pricing, Team, Metrics, Blog):**
|
||||||
|
```tsx
|
||||||
|
uniformGridCustomHeightClasses = "min-h-80 2xl:min-h-90"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Testimonial components (need flexible heights):**
|
||||||
|
```tsx
|
||||||
|
uniformGridCustomHeightClasses = "min-h-none"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Hero carousel components (no minimum):**
|
||||||
|
```tsx
|
||||||
|
uniformGridCustomHeightClasses = "min-h-0"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Feature components (optimized for compact layout):**
|
||||||
|
```tsx
|
||||||
|
// Hardcoded in FeatureCardFour
|
||||||
|
uniformGridCustomHeightClasses = "min-h-0"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Implementation Pattern
|
||||||
|
|
||||||
|
The prop flows: Section Component → CardStack → GridLayout/Carousel
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
// In section component (e.g., ProductCardOne.tsx)
|
||||||
|
const ProductCardOne = ({
|
||||||
|
products,
|
||||||
|
gridVariant,
|
||||||
|
uniformGridCustomHeightClasses = "min-h-80 2xl:min-h-90",
|
||||||
|
// ... other props
|
||||||
|
}: ProductCardOneProps) => {
|
||||||
|
return (
|
||||||
|
<CardStack
|
||||||
|
gridVariant={gridVariant}
|
||||||
|
uniformGridCustomHeightClasses={uniformGridCustomHeightClasses}
|
||||||
|
// ... other props
|
||||||
|
>
|
||||||
|
{products.map((product) => (
|
||||||
|
<div className="card">...</div>
|
||||||
|
))}
|
||||||
|
</CardStack>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
**Individual card elements must use `min-h-0`:**
|
||||||
|
```tsx
|
||||||
|
<div className={cls("card p-6 rounded-theme-capped h-full min-h-0")}>
|
||||||
|
{/* Product content */}
|
||||||
|
</div>
|
||||||
|
```
|
||||||
|
|
||||||
|
This prevents height conflicts and ensures proper flex behavior.
|
||||||
|
|
||||||
|
## Carousel Modes
|
||||||
|
|
||||||
|
### carouselMode Prop
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
carouselMode?: "auto" | "buttons"
|
||||||
|
```
|
||||||
|
|
||||||
|
- **`"auto"`** - Auto-scrolling carousel (uses AutoCarousel with embla-carousel-auto-scroll)
|
||||||
|
- **`"buttons"`** - Button-controlled carousel (uses ButtonCarousel with prev/next buttons)
|
||||||
|
|
||||||
|
**Default is typically `"buttons"`** for better accessibility and user control.
|
||||||
|
|
||||||
|
## TextBox Integration
|
||||||
|
|
||||||
|
CardStack components integrate with TextBox for section headers.
|
||||||
|
|
||||||
|
### TextBox Layout Options
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
import type { TextboxLayout } from "@/providers/themeProvider/config/constants";
|
||||||
|
|
||||||
|
textboxLayout: TextboxLayout // "default" | "split" | "split-actions" | "split-description" | "inline-image"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Layout Modes:**
|
||||||
|
|
||||||
|
1. **`"default"`** - Title and description stacked vertically, centered or left-aligned
|
||||||
|
```
|
||||||
|
[Tag]
|
||||||
|
Title
|
||||||
|
Description
|
||||||
|
[Buttons]
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **`"split"`** - Title and description on left (60%), buttons on right (40%)
|
||||||
|
```
|
||||||
|
[Tag]
|
||||||
|
Title | Description | [Buttons]
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **`"split-actions"`** - Title and description on left, buttons on right (no description on right)
|
||||||
|
```
|
||||||
|
[Tag]
|
||||||
|
Title | [Buttons]
|
||||||
|
Description |
|
||||||
|
```
|
||||||
|
|
||||||
|
4. **`"split-description"`** - Title on left, description on right, buttons below
|
||||||
|
```
|
||||||
|
[Tag]
|
||||||
|
Title | Description
|
||||||
|
[Buttons]
|
||||||
|
```
|
||||||
|
|
||||||
|
5. **`"inline-image"`** - Centered heading with inline images between text segments, buttons below
|
||||||
|
```
|
||||||
|
Text [Image] Text [Image] Text
|
||||||
|
[Buttons]
|
||||||
|
```
|
||||||
|
|
||||||
|
**Special props for inline-image layout:**
|
||||||
|
```tsx
|
||||||
|
import type { TitleSegment } from "@/components/cardStack/types";
|
||||||
|
|
||||||
|
titleSegments?: TitleSegment[] // Array of text and image segments
|
||||||
|
titleImageWrapperClassName?: string // Styling for image wrapper
|
||||||
|
titleImageClassName?: string // Styling for the image itself
|
||||||
|
```
|
||||||
|
|
||||||
|
**Example usage:**
|
||||||
|
```tsx
|
||||||
|
<FeatureCardOne
|
||||||
|
titleSegments={[
|
||||||
|
{ type: "text", content: "Discover" },
|
||||||
|
{ type: "image", src: "/icon.png", alt: "Icon" },
|
||||||
|
{ type: "text", content: "powerful features" }
|
||||||
|
]}
|
||||||
|
textboxLayout="inline-image"
|
||||||
|
// ... other props
|
||||||
|
/>
|
||||||
|
```
|
||||||
|
|
||||||
|
**Inline Image Behavior:**
|
||||||
|
- Images are styled with `primary-button` background
|
||||||
|
- Automatic rotation alternation: 1st: -rotate-12, 2nd: rotate-12, etc.
|
||||||
|
- Square aspect ratio (1.1em height)
|
||||||
|
- Proper spacing with mx-1 margins
|
||||||
|
- Supports both local paths and external URLs
|
||||||
|
|
||||||
|
### TextBox Props in CardStack
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
<CardStack
|
||||||
|
title="Our Products"
|
||||||
|
titleSegments={[
|
||||||
|
{ type: "text", content: "Our" },
|
||||||
|
{ type: "image", src: "/icon.png", alt: "Product Icon" },
|
||||||
|
{ type: "text", content: "Products" }
|
||||||
|
]} // Optional: use titleSegments for inline-image layout
|
||||||
|
description="Discover our latest offerings"
|
||||||
|
tag="Products"
|
||||||
|
tagIcon={Package}
|
||||||
|
buttons={[
|
||||||
|
{ text: "View All", href: "/products" }
|
||||||
|
]}
|
||||||
|
textboxLayout="split" // or "inline-image" with titleSegments
|
||||||
|
useInvertedBackground="noInvert" // "noInvert" | "invertDefault"
|
||||||
|
// TextBox className overrides
|
||||||
|
textBoxClassName=""
|
||||||
|
titleClassName=""
|
||||||
|
titleImageWrapperClassName="" // For inline-image layout
|
||||||
|
titleImageClassName="" // For inline-image layout
|
||||||
|
descriptionClassName=""
|
||||||
|
tagClassName=""
|
||||||
|
buttonContainerClassName=""
|
||||||
|
buttonClassName=""
|
||||||
|
buttonTextClassName=""
|
||||||
|
// ... other props
|
||||||
|
>
|
||||||
|
```
|
||||||
|
|
||||||
|
## Button System
|
||||||
|
|
||||||
|
### ButtonConfig Interface
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
interface ButtonConfig {
|
||||||
|
text: string;
|
||||||
|
onClick?: () => void;
|
||||||
|
href?: string;
|
||||||
|
props?: Partial<ButtonPropsForVariant<CTAButtonVariant>>;
|
||||||
|
// NO variant property - controlled by ThemeProvider
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Button Rendering Logic
|
||||||
|
|
||||||
|
Buttons are rendered with automatic primary/secondary styling:
|
||||||
|
|
||||||
|
- **Index 0**: Primary button (`primary-button` class)
|
||||||
|
- **Index 1+**: Secondary button (`secondary-button` class)
|
||||||
|
|
||||||
|
**Maximum 2 buttons** per section (enforced in TextBox component).
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
const buttons: ButtonConfig[] = [
|
||||||
|
{ text: "Get Started", href: "/signup" }, // Primary
|
||||||
|
{ text: "Learn More", onClick: () => {} } // Secondary
|
||||||
|
];
|
||||||
|
```
|
||||||
|
|
||||||
|
The `variant` is determined by ThemeProvider's `defaultButtonVariant` setting.
|
||||||
|
|
||||||
|
## Complete CardStack Section Example
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
"use client";
|
||||||
|
|
||||||
|
import React, { memo } from "react";
|
||||||
|
import CardStack from "@/components/cardStack/CardStack";
|
||||||
|
import { cls } from "@/lib/utils";
|
||||||
|
import type { GridVariant, ButtonConfig } from "@/components/cardStack/types";
|
||||||
|
import type { LucideIcon } from "lucide-react";
|
||||||
|
|
||||||
|
type Product = {
|
||||||
|
title: string;
|
||||||
|
description: string;
|
||||||
|
price: string;
|
||||||
|
image: string;
|
||||||
|
};
|
||||||
|
|
||||||
|
interface ProductCardOneProps {
|
||||||
|
products: Product[];
|
||||||
|
carouselMode?: "auto" | "buttons";
|
||||||
|
gridVariant: GridVariant;
|
||||||
|
uniformGridCustomHeightClasses?: string;
|
||||||
|
title: string;
|
||||||
|
description: string;
|
||||||
|
tag?: string;
|
||||||
|
tagIcon?: LucideIcon;
|
||||||
|
buttons?: ButtonConfig[];
|
||||||
|
textboxLayout: "default" | "split" | "split-actions" | "split-description";
|
||||||
|
ariaLabel?: string;
|
||||||
|
// Main wrapper
|
||||||
|
className?: string;
|
||||||
|
// CardStack customization
|
||||||
|
cardStackClassName?: string;
|
||||||
|
// TextBox customization
|
||||||
|
textBoxClassName?: string;
|
||||||
|
titleClassName?: string;
|
||||||
|
descriptionClassName?: string;
|
||||||
|
tagClassName?: string;
|
||||||
|
buttonsWrapperClassName?: string;
|
||||||
|
// Card customization
|
||||||
|
cardClassName?: string;
|
||||||
|
cardTitleClassName?: string;
|
||||||
|
cardDescriptionClassName?: string;
|
||||||
|
cardPriceClassName?: string;
|
||||||
|
cardImageClassName?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
const ProductCardOne = ({
|
||||||
|
products,
|
||||||
|
carouselMode = "buttons",
|
||||||
|
gridVariant,
|
||||||
|
uniformGridCustomHeightClasses = "min-h-80 2xl:min-h-90",
|
||||||
|
title,
|
||||||
|
description,
|
||||||
|
tag,
|
||||||
|
tagIcon,
|
||||||
|
buttons,
|
||||||
|
textboxLayout,
|
||||||
|
ariaLabel = "Product section",
|
||||||
|
className = "",
|
||||||
|
cardStackClassName = "",
|
||||||
|
textBoxClassName = "",
|
||||||
|
titleClassName = "",
|
||||||
|
descriptionClassName = "",
|
||||||
|
tagClassName = "",
|
||||||
|
buttonsWrapperClassName = "",
|
||||||
|
cardClassName = "",
|
||||||
|
cardTitleClassName = "",
|
||||||
|
cardDescriptionClassName = "",
|
||||||
|
cardPriceClassName = "",
|
||||||
|
cardImageClassName = "",
|
||||||
|
}: ProductCardOneProps) => {
|
||||||
|
return (
|
||||||
|
<section
|
||||||
|
aria-label={ariaLabel}
|
||||||
|
className={cls("w-full py-20", className)}
|
||||||
|
>
|
||||||
|
<div className="w-content-width mx-auto">
|
||||||
|
<CardStack
|
||||||
|
mode={carouselMode}
|
||||||
|
gridVariant={gridVariant}
|
||||||
|
uniformGridCustomHeightClasses={uniformGridCustomHeightClasses}
|
||||||
|
title={title}
|
||||||
|
description={description}
|
||||||
|
tag={tag}
|
||||||
|
tagIcon={tagIcon}
|
||||||
|
buttons={buttons}
|
||||||
|
textboxLayout={textboxLayout}
|
||||||
|
className={cardStackClassName}
|
||||||
|
textBoxClassName={textBoxClassName}
|
||||||
|
titleClassName={titleClassName}
|
||||||
|
descriptionClassName={descriptionClassName}
|
||||||
|
tagClassName={tagClassName}
|
||||||
|
buttonsWrapperClassName={buttonsWrapperClassName}
|
||||||
|
>
|
||||||
|
{products.map((product, index) => (
|
||||||
|
<div
|
||||||
|
key={`${product.title}-${index}`}
|
||||||
|
className={cls(
|
||||||
|
"card p-6 rounded-theme-capped h-full min-h-0 flex flex-col",
|
||||||
|
cardClassName
|
||||||
|
)}
|
||||||
|
>
|
||||||
|
<img
|
||||||
|
src={product.image}
|
||||||
|
alt={product.title}
|
||||||
|
className={cls("w-full h-48 object-cover mb-4", cardImageClassName)}
|
||||||
|
/>
|
||||||
|
<h3 className={cls("text-xl font-semibold mb-2", cardTitleClassName)}>
|
||||||
|
{product.title}
|
||||||
|
</h3>
|
||||||
|
<p className={cls("text-foreground/75 flex-1", cardDescriptionClassName)}>
|
||||||
|
{product.description}
|
||||||
|
</p>
|
||||||
|
<p className={cls("text-2xl font-bold mt-4", cardPriceClassName)}>
|
||||||
|
{product.price}
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
))}
|
||||||
|
</CardStack>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
|
||||||
|
ProductCardOne.displayName = "ProductCardOne";
|
||||||
|
|
||||||
|
export default memo(ProductCardOne);
|
||||||
|
```
|
||||||
|
|
||||||
|
## Animation Types
|
||||||
|
|
||||||
|
CardStack supports GSAP-powered scroll-triggered animations:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
animationType?: "none" | "opacity" | "slide-up" | "scale-rotate" | "blur-reveal"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Animation Descriptions:**
|
||||||
|
- **`none`** - No animation
|
||||||
|
- **`opacity`** - Fade in
|
||||||
|
- **`slide-up`** - Slide up from below with stagger
|
||||||
|
- **`scale-rotate`** - Scale + rotate entrance with stagger
|
||||||
|
- **`blur-reveal`** - Blur to clear reveal with stagger
|
||||||
|
|
||||||
|
Each animation uses GSAP ScrollTrigger with staggered effect on children.
|
||||||
|
|
||||||
|
## Best Practices
|
||||||
|
|
||||||
|
### ✅ DO:
|
||||||
|
|
||||||
|
- Accept `uniformGridCustomHeightClasses` as optional prop with sensible default
|
||||||
|
- Use `min-h-0` on individual card elements for proper flex behavior
|
||||||
|
- Pass through all CardStack customization props (className overrides)
|
||||||
|
- Use appropriate default height for your component type
|
||||||
|
- Document the default value in registry propsSchema
|
||||||
|
- Provide className props for all card sub-elements
|
||||||
|
- Use `card` class for consistent card styling (theme-aware)
|
||||||
|
- Use `rounded-theme-capped` for card border radius
|
||||||
|
- Set `carouselMode` default to `"buttons"` for accessibility
|
||||||
|
|
||||||
|
### ❌ DO NOT:
|
||||||
|
|
||||||
|
- Hardcode height classes in CardStack (let it be controlled via prop)
|
||||||
|
- Remove the `uniformGridCustomHeightClasses` prop without specific reason
|
||||||
|
- Use different height classes for grid vs carousel (they should match)
|
||||||
|
- Forget to apply `min-h-0` on card wrapper divs
|
||||||
|
- Specify button `variant` in ButtonConfig (controlled by ThemeProvider)
|
||||||
|
- Create more than 2 buttons per section
|
||||||
|
- Use `lg:` or `xl:` breakpoints for layout changes
|
||||||
|
|
||||||
|
## CardStack Component Checklist
|
||||||
|
|
||||||
|
When creating a new CardStack-based section component:
|
||||||
|
|
||||||
|
### Props & Configuration
|
||||||
|
- [ ] Accept `uniformGridCustomHeightClasses` prop with appropriate default
|
||||||
|
- [ ] Accept `carouselMode` prop (default: `"buttons"`)
|
||||||
|
- [ ] Accept `gridVariant` as required prop (or hardcode if single variant)
|
||||||
|
- [ ] Accept `textboxLayout` for TextBox configuration
|
||||||
|
- [ ] Accept `animationType` for scroll animations (optional)
|
||||||
|
|
||||||
|
### CardStack Integration
|
||||||
|
- [ ] Pass `uniformGridCustomHeightClasses` to CardStack
|
||||||
|
- [ ] Pass all TextBox props (title, description, tag, tagIcon, buttons)
|
||||||
|
- [ ] Pass all TextBox className overrides
|
||||||
|
- [ ] Pass cardStackClassName for CardStack wrapper customization
|
||||||
|
|
||||||
|
### Card Implementation
|
||||||
|
- [ ] Apply `min-h-0` to individual card wrapper divs
|
||||||
|
- [ ] Use `card` class for card background/border styling
|
||||||
|
- [ ] Use `rounded-theme-capped` for border radius
|
||||||
|
- [ ] Provide className override props for all card sub-elements
|
||||||
|
- [ ] Use `h-full` on cards for consistent heights within grid
|
||||||
|
|
||||||
|
### Button System
|
||||||
|
- [ ] Use ButtonConfig type for buttons array
|
||||||
|
- [ ] Do NOT specify variant in ButtonConfig
|
||||||
|
- [ ] Maximum 2 buttons
|
||||||
|
- [ ] Let ThemeProvider control button variant
|
||||||
|
|
||||||
|
### Section Structure
|
||||||
|
- [ ] Use semantic `<section>` tag with aria-label
|
||||||
|
- [ ] Use `w-full py-20` on section
|
||||||
|
- [ ] Use `w-content-width mx-auto` wrapper
|
||||||
|
- [ ] Provide section className override
|
||||||
|
|
||||||
|
### Documentation
|
||||||
|
- [ ] Document `uniformGridCustomHeightClasses` default in registry
|
||||||
|
- [ ] Document all grid variants supported
|
||||||
|
- [ ] Document carousel mode options
|
||||||
|
- [ ] Include usage example with typical props
|
||||||
433
docs/COMPONENT_IMPLEMENTATION.md
Normal file
@@ -0,0 +1,433 @@
|
|||||||
|
# Component Implementation Standards
|
||||||
|
|
||||||
|
This document outlines the core implementation patterns for creating components in this library, optimized for AI website builders.
|
||||||
|
|
||||||
|
## Component Structure Template
|
||||||
|
|
||||||
|
Every component should follow this structure:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
"use client";
|
||||||
|
|
||||||
|
import React from "react";
|
||||||
|
import { cls } from "@/lib/utils";
|
||||||
|
|
||||||
|
interface ComponentProps {
|
||||||
|
// Required props first
|
||||||
|
text: string;
|
||||||
|
// Optional props with explicit types
|
||||||
|
onClick?: () => void;
|
||||||
|
className?: string;
|
||||||
|
disabled?: boolean;
|
||||||
|
ariaLabel?: string;
|
||||||
|
type?: "button" | "submit" | "reset";
|
||||||
|
}
|
||||||
|
|
||||||
|
const Component = ({
|
||||||
|
text,
|
||||||
|
onClick,
|
||||||
|
className = "",
|
||||||
|
disabled = false,
|
||||||
|
ariaLabel,
|
||||||
|
type = "button",
|
||||||
|
}: ComponentProps) => {
|
||||||
|
return (
|
||||||
|
<element
|
||||||
|
type={type}
|
||||||
|
onClick={onClick}
|
||||||
|
disabled={disabled}
|
||||||
|
aria-label={ariaLabel || text}
|
||||||
|
className={cls("base-classes", "disabled-states", className)}
|
||||||
|
>
|
||||||
|
{text}
|
||||||
|
</element>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
|
||||||
|
Component.displayName = "Component";
|
||||||
|
|
||||||
|
export default React.memo(Component);
|
||||||
|
```
|
||||||
|
|
||||||
|
**Key Requirements:**
|
||||||
|
- `"use client"` directive when needed (interactive components, hooks)
|
||||||
|
- Named exports with `displayName` for debugging
|
||||||
|
- Wrap in `React.memo()` for performance optimization
|
||||||
|
- Use `cls()` utility for class composition (never plain string concatenation)
|
||||||
|
|
||||||
|
## Prop Structure & Defaults
|
||||||
|
|
||||||
|
### Required Props
|
||||||
|
Core content props should be **required** with no default values:
|
||||||
|
- Section components: `title`, `description`
|
||||||
|
- Button components: `text`
|
||||||
|
- Media components: `imageSrc` or `videoSrc` (when applicable)
|
||||||
|
|
||||||
|
### Optional Props with Defaults
|
||||||
|
|
||||||
|
**Standard className defaults:**
|
||||||
|
```tsx
|
||||||
|
className = "",
|
||||||
|
textClassName = "",
|
||||||
|
iconClassName = "",
|
||||||
|
containerClassName = "",
|
||||||
|
```
|
||||||
|
|
||||||
|
Empty string defaults prevent undefined checks and are standard practice.
|
||||||
|
|
||||||
|
**Common optional props:**
|
||||||
|
```tsx
|
||||||
|
disabled = false,
|
||||||
|
type = "button",
|
||||||
|
ariaLabel, // No default, falls back to sensible value in component
|
||||||
|
```
|
||||||
|
|
||||||
|
**Component-specific props:**
|
||||||
|
Document defaults clearly in both code and registry:
|
||||||
|
```tsx
|
||||||
|
strengthFactor = 20,
|
||||||
|
carouselMode = "buttons",
|
||||||
|
uniformGridCustomHeightClasses = "min-h-80 2xl:min-h-90",
|
||||||
|
```
|
||||||
|
|
||||||
|
## Naming Conventions
|
||||||
|
|
||||||
|
### Section Components (Hero, About, Feature, etc.)
|
||||||
|
|
||||||
|
**✅ CORRECT:**
|
||||||
|
```tsx
|
||||||
|
interface HeroProps {
|
||||||
|
title: string; // Primary heading
|
||||||
|
description: string; // Supporting text
|
||||||
|
buttons?: ButtonConfig[];
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**❌ WRONG:**
|
||||||
|
```tsx
|
||||||
|
interface HeroProps {
|
||||||
|
heading: string; // Should be "title"
|
||||||
|
subtitle: string; // Should be "description"
|
||||||
|
text: string; // Ambiguous
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Button Components
|
||||||
|
|
||||||
|
**✅ CORRECT:**
|
||||||
|
```tsx
|
||||||
|
interface ButtonProps {
|
||||||
|
text: string; // Button label
|
||||||
|
onClick?: () => void;
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**❌ WRONG:**
|
||||||
|
```tsx
|
||||||
|
interface ButtonProps {
|
||||||
|
title: string; // Should be "text"
|
||||||
|
label: string; // Should be "text"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Button Config (for sections)
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
interface ButtonConfig {
|
||||||
|
text: string; // Button label (not "title" or "label")
|
||||||
|
href?: string;
|
||||||
|
onClick?: () => void;
|
||||||
|
props?: Partial<ButtonPropsForVariant<CTAButtonVariant>>;
|
||||||
|
// NO variant property - controlled by ThemeProvider
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Consistency is critical:**
|
||||||
|
- All hero sections must use the same prop names
|
||||||
|
- All about sections must use the same prop names
|
||||||
|
- Registry documentation must match component prop names exactly
|
||||||
|
|
||||||
|
## Component Customizability
|
||||||
|
|
||||||
|
Provide className props for **all major elements** to allow full styling control:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
interface SectionProps {
|
||||||
|
title: string;
|
||||||
|
description: string;
|
||||||
|
// Main wrapper
|
||||||
|
className?: string;
|
||||||
|
// Inner container
|
||||||
|
containerClassName?: string;
|
||||||
|
// Content areas
|
||||||
|
textClassName?: string;
|
||||||
|
mediaWrapperClassName?: string;
|
||||||
|
imageClassName?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
const Section = ({
|
||||||
|
title,
|
||||||
|
description,
|
||||||
|
className = "",
|
||||||
|
containerClassName = "",
|
||||||
|
textClassName = "",
|
||||||
|
mediaWrapperClassName = "",
|
||||||
|
imageClassName = "",
|
||||||
|
}: SectionProps) => {
|
||||||
|
return (
|
||||||
|
<section className={cls("base-section-styles", className)}>
|
||||||
|
<div className={cls("base-container-styles", containerClassName)}>
|
||||||
|
<div className={cls("base-text-styles", textClassName)}>
|
||||||
|
{/* content */}
|
||||||
|
</div>
|
||||||
|
<div className={cls("base-media-wrapper-styles", mediaWrapperClassName)}>
|
||||||
|
<img className={cls("base-image-styles", imageClassName)} />
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
**Naming convention:**
|
||||||
|
- `className` - Main wrapper element
|
||||||
|
- `containerClassName` - Inner container
|
||||||
|
- `[element]ClassName` - Specific elements (e.g., `textClassName`, `imageClassName`)
|
||||||
|
|
||||||
|
## Component Composition & Base Styles
|
||||||
|
|
||||||
|
When composing higher-level components from base components, **set sensible base styles** while accepting className overrides:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
interface HeroProps {
|
||||||
|
title: string;
|
||||||
|
description: string;
|
||||||
|
titleClassName?: string;
|
||||||
|
descriptionClassName?: string;
|
||||||
|
textBoxClassName?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
const Hero = ({
|
||||||
|
title,
|
||||||
|
description,
|
||||||
|
titleClassName = "",
|
||||||
|
descriptionClassName = "",
|
||||||
|
textBoxClassName = "",
|
||||||
|
}: HeroProps) => {
|
||||||
|
return (
|
||||||
|
<section>
|
||||||
|
<TextBox
|
||||||
|
title={title}
|
||||||
|
description={description}
|
||||||
|
// Set base styles, allow overrides
|
||||||
|
className={cls("flex flex-col gap-3 md:gap-1", textBoxClassName)}
|
||||||
|
titleClassName={cls("text-6xl font-medium", titleClassName)}
|
||||||
|
descriptionClassName={cls("text-lg leading-[1.2]", descriptionClassName)}
|
||||||
|
center={true}
|
||||||
|
/>
|
||||||
|
</section>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
**Key principles:**
|
||||||
|
- Base styles come first in `cls()`, overrides second
|
||||||
|
- This ensures good defaults while maintaining full customizability
|
||||||
|
- AI builders can use components without styling knowledge, but advanced users can override
|
||||||
|
- Use `cls()` utility for proper class merging (prevents Tailwind conflicts)
|
||||||
|
|
||||||
|
## Type Safety
|
||||||
|
|
||||||
|
### Use Explicit Prop Interfaces
|
||||||
|
```tsx
|
||||||
|
// ✅ CORRECT - Clear and explicit
|
||||||
|
interface ButtonProps {
|
||||||
|
text: string;
|
||||||
|
onClick?: () => void;
|
||||||
|
variant?: "primary" | "secondary";
|
||||||
|
}
|
||||||
|
|
||||||
|
// ❌ WRONG - Over-complicated
|
||||||
|
interface ButtonProps extends React.ComponentPropsWithoutRef<'button'> {
|
||||||
|
// ... harder for AI to understand
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Use Discriminated Unions for Variants
|
||||||
|
```tsx
|
||||||
|
type MediaProps =
|
||||||
|
| {
|
||||||
|
imageSrc: string;
|
||||||
|
imageAlt?: string;
|
||||||
|
videoSrc?: never;
|
||||||
|
}
|
||||||
|
| {
|
||||||
|
videoSrc: string;
|
||||||
|
videoAriaLabel?: string;
|
||||||
|
imageSrc?: never;
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
### Export Reusable Types
|
||||||
|
```tsx
|
||||||
|
export type ButtonConfig = {
|
||||||
|
text: string;
|
||||||
|
href?: string;
|
||||||
|
onClick?: () => void;
|
||||||
|
};
|
||||||
|
|
||||||
|
export type GridVariant =
|
||||||
|
| "uniform-all-items-equal"
|
||||||
|
| "two-columns-alternating-heights"
|
||||||
|
| "asymmetric-60-wide-40-narrow"
|
||||||
|
// ... etc
|
||||||
|
```
|
||||||
|
|
||||||
|
## Responsive Design
|
||||||
|
|
||||||
|
### Mobile-First Approach
|
||||||
|
|
||||||
|
**Default styles apply to mobile devices:**
|
||||||
|
```tsx
|
||||||
|
// ✅ CORRECT - Mobile until md breakpoint (768px)
|
||||||
|
<div className="flex-col md:flex-row">
|
||||||
|
<img className="w-full h-auto md:h-8 md:w-auto" />
|
||||||
|
</div>
|
||||||
|
|
||||||
|
// ❌ WRONG - Using lg: breakpoint
|
||||||
|
<div className="flex-col lg:flex-row">
|
||||||
|
<img className="w-full h-auto lg:h-8 lg:w-auto" />
|
||||||
|
</div>
|
||||||
|
```
|
||||||
|
|
||||||
|
**Breakpoint Rules:**
|
||||||
|
- **Mobile styles**: No prefix (default)
|
||||||
|
- **Desktop styles**: `md:` prefix only (768px breakpoint)
|
||||||
|
- **Never use**: `lg:`, `xl:`, `2xl:` breakpoints for layout changes
|
||||||
|
|
||||||
|
**Exceptions:** Only use larger breakpoints for minor tweaks:
|
||||||
|
```tsx
|
||||||
|
// Acceptable for minor adjustments
|
||||||
|
className="min-h-80 2xl:min-h-90"
|
||||||
|
```
|
||||||
|
|
||||||
|
## Content Width Pattern
|
||||||
|
|
||||||
|
All section content must follow this structure:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
<section aria-label={ariaLabel || "Section name"} className="w-full py-20">
|
||||||
|
<div className="w-content-width mx-auto">
|
||||||
|
{/* content */}
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
```
|
||||||
|
|
||||||
|
**Rules:**
|
||||||
|
- Section: `w-full py-20` (full width with vertical padding)
|
||||||
|
- Inner div: `w-content-width mx-auto` (centered content with max width)
|
||||||
|
- `w-content-width` is controlled by ThemeProvider (small/medium/large)
|
||||||
|
|
||||||
|
**Exceptions:**
|
||||||
|
- Heroes and footers do NOT use `py-20` (they have custom spacing)
|
||||||
|
- Full-bleed sections may skip inner wrapper
|
||||||
|
|
||||||
|
## Vertical Spacing
|
||||||
|
|
||||||
|
**Standard sections:**
|
||||||
|
```tsx
|
||||||
|
className="w-full py-20"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Exceptions (NO py-20):**
|
||||||
|
- Hero sections (custom spacing)
|
||||||
|
- Footer sections (custom spacing)
|
||||||
|
- Full-bleed sections with background colors
|
||||||
|
|
||||||
|
## Text Constraints
|
||||||
|
|
||||||
|
For button text and short labels:
|
||||||
|
```tsx
|
||||||
|
{
|
||||||
|
"text": {
|
||||||
|
"required": true,
|
||||||
|
"example": "Get Started",
|
||||||
|
"minChars": 2,
|
||||||
|
"maxChars": 15
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Button text rules:**
|
||||||
|
- Minimum: 2 characters
|
||||||
|
- Maximum: 15 characters
|
||||||
|
- Single-line only (no multiline support)
|
||||||
|
|
||||||
|
## Section Structure Pattern
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
<section
|
||||||
|
aria-label={ariaLabel || "Default section label"}
|
||||||
|
className={cls(
|
||||||
|
"relative py-20 w-full",
|
||||||
|
useInvertedBackground === "invertDefault" && "bg-foreground",
|
||||||
|
className
|
||||||
|
)}
|
||||||
|
>
|
||||||
|
<div className="w-content-width mx-auto">
|
||||||
|
<TextBox
|
||||||
|
title={title}
|
||||||
|
description={description}
|
||||||
|
tag={tag}
|
||||||
|
tagIcon={tagIcon}
|
||||||
|
buttons={buttons}
|
||||||
|
textboxLayout={textboxLayout}
|
||||||
|
useInvertedBackground={useInvertedBackground}
|
||||||
|
// ... className overrides
|
||||||
|
/>
|
||||||
|
|
||||||
|
{/* Section-specific content */}
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
```
|
||||||
|
|
||||||
|
**Key Pattern Notes:**
|
||||||
|
- `useInvertedBackground` is a required prop: `"noInvert" | "invertDefault"`
|
||||||
|
- `"invertDefault"` creates a full-width inverted section with `bg-foreground`
|
||||||
|
- `"noInvert"` is the standard section with no background
|
||||||
|
- Always use explicit string equality checks (not truthy/falsy)
|
||||||
|
- Text colors should check for `"invertDefault"` mode
|
||||||
|
|
||||||
|
## Implementation Checklist
|
||||||
|
|
||||||
|
### Core Requirements
|
||||||
|
- [ ] Add `"use client"` directive if needed (hooks, interactivity)
|
||||||
|
- [ ] Use explicit prop interfaces (no over-complicated types)
|
||||||
|
- [ ] Set appropriate defaults for optional props
|
||||||
|
- [ ] Add `displayName` for debugging
|
||||||
|
- [ ] Wrap in `React.memo()` for performance
|
||||||
|
- [ ] Use semantic HTML tags (`<section>`, `<button>`, etc.)
|
||||||
|
|
||||||
|
### Customizability
|
||||||
|
- [ ] Provide className props for all major elements
|
||||||
|
- [ ] Use `cls()` utility for class composition
|
||||||
|
- [ ] Set base styles with override capability
|
||||||
|
- [ ] Follow naming convention (className, containerClassName, [element]ClassName)
|
||||||
|
|
||||||
|
### Responsive Design
|
||||||
|
- [ ] Mobile-first styles (no prefix)
|
||||||
|
- [ ] Desktop styles with `md:` prefix only
|
||||||
|
- [ ] Avoid `lg:`, `xl:`, `2xl:` for layout changes
|
||||||
|
- [ ] Use `w-content-width mx-auto` pattern
|
||||||
|
|
||||||
|
### Naming Conventions
|
||||||
|
- [ ] Section components: Use `title` and `description`
|
||||||
|
- [ ] Button components: Use `text`
|
||||||
|
- [ ] Button configs: Use `text` (not variant - controlled by theme)
|
||||||
|
- [ ] Consistent naming across similar component types
|
||||||
|
|
||||||
|
### Structure
|
||||||
|
- [ ] Required props first in interface
|
||||||
|
- [ ] Optional props with defaults after
|
||||||
|
- [ ] Empty string defaults for className props
|
||||||
|
- [ ] Document default values clearly
|
||||||
499
docs/PREVIEW_PAGE_STANDARDS.md
Normal file
@@ -0,0 +1,499 @@
|
|||||||
|
# Preview Page Standards
|
||||||
|
|
||||||
|
This document outlines how to create preview pages for components in `/app/components/`.
|
||||||
|
|
||||||
|
## Purpose
|
||||||
|
|
||||||
|
Preview pages allow developers and AI builders to:
|
||||||
|
- See components in isolation
|
||||||
|
- Test component behavior and styling
|
||||||
|
- Verify responsive design
|
||||||
|
- Experiment with different prop configurations
|
||||||
|
- Ensure smooth scrolling and theme integration
|
||||||
|
|
||||||
|
## File Structure
|
||||||
|
|
||||||
|
### Location Pattern
|
||||||
|
|
||||||
|
```
|
||||||
|
/app/components/
|
||||||
|
├── sections/
|
||||||
|
│ ├── hero/
|
||||||
|
│ │ ├── billboard/
|
||||||
|
│ │ │ └── page.tsx // Preview for HeroBillboard
|
||||||
|
│ │ ├── split/
|
||||||
|
│ │ │ └── page.tsx // Preview for HeroSplit
|
||||||
|
│ ├── feature/
|
||||||
|
│ │ ├── card-one/
|
||||||
|
│ │ │ └── page.tsx // Preview for FeatureCardOne
|
||||||
|
├── buttons/
|
||||||
|
│ ├── text-stagger/
|
||||||
|
│ │ └── page.tsx // Preview for ButtonTextStagger
|
||||||
|
└── page.tsx // Main components index
|
||||||
|
```
|
||||||
|
|
||||||
|
**Pattern:** `/app/components/[category]/[component-name]/page.tsx`
|
||||||
|
|
||||||
|
**Component name formatting:**
|
||||||
|
- Use kebab-case for folder names
|
||||||
|
- `HeroBillboard` → `hero/billboard/`
|
||||||
|
- `FeatureCardOne` → `feature/card-one/`
|
||||||
|
- `ButtonTextStagger` → `buttons/text-stagger/`
|
||||||
|
|
||||||
|
## Preview Page Template
|
||||||
|
|
||||||
|
### Basic Template (Non-Section Components)
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
"use client";
|
||||||
|
|
||||||
|
import React from "react";
|
||||||
|
import ReactLenis from "lenis/react";
|
||||||
|
import { ThemeProvider } from "@/providers/themeProvider/ThemeProvider";
|
||||||
|
import ComponentName from "@/components/category/ComponentName";
|
||||||
|
|
||||||
|
export default function ComponentPreviewPage() {
|
||||||
|
return (
|
||||||
|
<ThemeProvider
|
||||||
|
defaultButtonVariant="text-stagger"
|
||||||
|
defaultTextAnimation="entrance-slide"
|
||||||
|
borderRadius="rounded"
|
||||||
|
contentWidth="medium"
|
||||||
|
sizing="medium"
|
||||||
|
background="plain"
|
||||||
|
cardStyle="glass-flat"
|
||||||
|
primaryButtonStyle="gradient"
|
||||||
|
secondaryButtonStyle="glass"
|
||||||
|
headingFontWeight="medium"
|
||||||
|
>
|
||||||
|
<ReactLenis root>
|
||||||
|
<ComponentName
|
||||||
|
// Add realistic props here
|
||||||
|
text="Example"
|
||||||
|
onClick={() => console.log("clicked")}
|
||||||
|
/>
|
||||||
|
</ReactLenis>
|
||||||
|
</ThemeProvider>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Section Component Template
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
"use client";
|
||||||
|
|
||||||
|
import React from "react";
|
||||||
|
import ReactLenis from "lenis/react";
|
||||||
|
import { ThemeProvider } from "@/providers/themeProvider/ThemeProvider";
|
||||||
|
import SectionName from "@/components/sections/category/SectionName";
|
||||||
|
|
||||||
|
export default function SectionPreviewPage() {
|
||||||
|
return (
|
||||||
|
<ThemeProvider
|
||||||
|
defaultButtonVariant="icon-arrow"
|
||||||
|
defaultTextAnimation="entrance-slide"
|
||||||
|
borderRadius="pill"
|
||||||
|
contentWidth="medium"
|
||||||
|
sizing="medium"
|
||||||
|
background="animatedGrid"
|
||||||
|
cardStyle="glass-flat"
|
||||||
|
primaryButtonStyle="gradient"
|
||||||
|
secondaryButtonStyle="glass"
|
||||||
|
headingFontWeight="medium"
|
||||||
|
>
|
||||||
|
<ReactLenis root>
|
||||||
|
<SectionName
|
||||||
|
title="Preview Section Title"
|
||||||
|
description="This is a preview of the section component with example content."
|
||||||
|
buttons={[
|
||||||
|
{ text: "Get Started", href: "#" },
|
||||||
|
{ text: "Learn More", onClick: () => console.log("Learn more") }
|
||||||
|
]}
|
||||||
|
// Add section-specific props
|
||||||
|
/>
|
||||||
|
</ReactLenis>
|
||||||
|
</ThemeProvider>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### CardStack Section Template
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
"use client";
|
||||||
|
|
||||||
|
import React from "react";
|
||||||
|
import ReactLenis from "lenis/react";
|
||||||
|
import { ThemeProvider } from "@/providers/themeProvider/ThemeProvider";
|
||||||
|
import { Package, Zap, Shield, Sparkles } from "lucide-react";
|
||||||
|
import FeatureCardOne from "@/components/sections/feature/FeatureCardOne";
|
||||||
|
|
||||||
|
export default function FeatureCardOnePreviewPage() {
|
||||||
|
const features = [
|
||||||
|
{
|
||||||
|
icon: Package,
|
||||||
|
title: "Feature One",
|
||||||
|
description: "Lorem ipsum dolor sit amet, consectetur adipiscing elit."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
icon: Zap,
|
||||||
|
title: "Feature Two",
|
||||||
|
description: "Sed do eiusmod tempor incididunt ut labore et dolore."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
icon: Shield,
|
||||||
|
title: "Feature Three",
|
||||||
|
description: "Ut enim ad minim veniam, quis nostrud exercitation."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
icon: Sparkles,
|
||||||
|
title: "Feature Four",
|
||||||
|
description: "Duis aute irure dolor in reprehenderit in voluptate."
|
||||||
|
}
|
||||||
|
];
|
||||||
|
|
||||||
|
return (
|
||||||
|
<ThemeProvider
|
||||||
|
defaultButtonVariant="icon-arrow"
|
||||||
|
defaultTextAnimation="entrance-slide"
|
||||||
|
borderRadius="rounded"
|
||||||
|
contentWidth="medium"
|
||||||
|
sizing="medium"
|
||||||
|
background="animatedGrid"
|
||||||
|
cardStyle="glass-flat"
|
||||||
|
primaryButtonStyle="gradient"
|
||||||
|
secondaryButtonStyle="glass"
|
||||||
|
headingFontWeight="medium"
|
||||||
|
>
|
||||||
|
<ReactLenis root>
|
||||||
|
<FeatureCardOne
|
||||||
|
features={features}
|
||||||
|
gridVariant="uniform-all-items-equal"
|
||||||
|
textboxLayout="default"
|
||||||
|
title="Our Features"
|
||||||
|
description="Discover what makes us unique"
|
||||||
|
tag="Features"
|
||||||
|
tagIcon={Sparkles}
|
||||||
|
buttons={[
|
||||||
|
{ text: "View All", href: "#" }
|
||||||
|
]}
|
||||||
|
/>
|
||||||
|
</ReactLenis>
|
||||||
|
</ThemeProvider>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Critical Requirements
|
||||||
|
|
||||||
|
### Wrapper Order
|
||||||
|
|
||||||
|
**MUST follow this order:**
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
<ThemeProvider>
|
||||||
|
<ReactLenis root>
|
||||||
|
<Component />
|
||||||
|
</ReactLenis>
|
||||||
|
</ThemeProvider>
|
||||||
|
```
|
||||||
|
|
||||||
|
**❌ WRONG:**
|
||||||
|
```tsx
|
||||||
|
<ReactLenis root>
|
||||||
|
<ThemeProvider>
|
||||||
|
<Component />
|
||||||
|
</ThemeProvider>
|
||||||
|
</ReactLenis>
|
||||||
|
```
|
||||||
|
|
||||||
|
ReactLenis must be **inside** ThemeProvider, not outside.
|
||||||
|
|
||||||
|
### "use client" Directive
|
||||||
|
|
||||||
|
All preview pages must include `"use client"` at the top:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
"use client";
|
||||||
|
|
||||||
|
import React from "react";
|
||||||
|
// ...
|
||||||
|
```
|
||||||
|
|
||||||
|
This is required because:
|
||||||
|
- ReactLenis uses client-side hooks
|
||||||
|
- ThemeProvider uses React Context
|
||||||
|
- Components may use interactive features
|
||||||
|
|
||||||
|
### ReactLenis Root Prop
|
||||||
|
|
||||||
|
Always include the `root` prop:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
<ReactLenis root>
|
||||||
|
{/* components */}
|
||||||
|
</ReactLenis>
|
||||||
|
```
|
||||||
|
|
||||||
|
This enables page-wide smooth scrolling.
|
||||||
|
|
||||||
|
## Theme Configuration
|
||||||
|
|
||||||
|
### Recommended Defaults
|
||||||
|
|
||||||
|
**For most previews:**
|
||||||
|
```tsx
|
||||||
|
<ThemeProvider
|
||||||
|
defaultButtonVariant="icon-arrow"
|
||||||
|
defaultTextAnimation="entrance-slide"
|
||||||
|
borderRadius="rounded"
|
||||||
|
contentWidth="medium"
|
||||||
|
sizing="medium"
|
||||||
|
background="animatedGrid"
|
||||||
|
cardStyle="glass-flat"
|
||||||
|
primaryButtonStyle="gradient"
|
||||||
|
secondaryButtonStyle="glass"
|
||||||
|
headingFontWeight="medium"
|
||||||
|
>
|
||||||
|
```
|
||||||
|
|
||||||
|
**For button previews:**
|
||||||
|
```tsx
|
||||||
|
<ThemeProvider
|
||||||
|
defaultButtonVariant="text-stagger" // Match button being previewed
|
||||||
|
defaultTextAnimation="entrance-slide"
|
||||||
|
borderRadius="pill"
|
||||||
|
contentWidth="medium"
|
||||||
|
sizing="medium"
|
||||||
|
background="plain"
|
||||||
|
cardStyle="glass-flat"
|
||||||
|
primaryButtonStyle="gradient"
|
||||||
|
secondaryButtonStyle="glass"
|
||||||
|
headingFontWeight="medium"
|
||||||
|
>
|
||||||
|
```
|
||||||
|
|
||||||
|
**For hero previews:**
|
||||||
|
```tsx
|
||||||
|
<ThemeProvider
|
||||||
|
defaultButtonVariant="icon-arrow"
|
||||||
|
defaultTextAnimation="entrance-slide"
|
||||||
|
borderRadius="rounded"
|
||||||
|
contentWidth="large" // Wider for heroes
|
||||||
|
sizing="large" // Larger sizing for heroes
|
||||||
|
background="aurora" // Visual background
|
||||||
|
cardStyle="glass-flat"
|
||||||
|
primaryButtonStyle="gradient"
|
||||||
|
secondaryButtonStyle="glass"
|
||||||
|
headingFontWeight="semibold" // Bolder for heroes
|
||||||
|
>
|
||||||
|
```
|
||||||
|
|
||||||
|
### When to Customize
|
||||||
|
|
||||||
|
Customize theme settings when:
|
||||||
|
- Testing different button variants
|
||||||
|
- Showcasing card styles
|
||||||
|
- Demonstrating responsive behavior
|
||||||
|
- Highlighting specific theme features
|
||||||
|
|
||||||
|
## Realistic Props
|
||||||
|
|
||||||
|
### Use Realistic Content
|
||||||
|
|
||||||
|
**✅ GOOD:**
|
||||||
|
```tsx
|
||||||
|
<HeroBillboard
|
||||||
|
title="Build Amazing Websites Faster"
|
||||||
|
description="Create stunning, responsive websites with our modern component library. Ship faster, iterate quicker."
|
||||||
|
buttons={[
|
||||||
|
{ text: "Get Started", href: "/signup" },
|
||||||
|
{ text: "View Demo", onClick: () => window.open("/demo") }
|
||||||
|
]}
|
||||||
|
/>
|
||||||
|
```
|
||||||
|
|
||||||
|
**❌ BAD:**
|
||||||
|
```tsx
|
||||||
|
<HeroBillboard
|
||||||
|
title="Test"
|
||||||
|
description="Test description"
|
||||||
|
buttons={[
|
||||||
|
{ text: "Click", href: "#" }
|
||||||
|
]}
|
||||||
|
/>
|
||||||
|
```
|
||||||
|
|
||||||
|
### Sample Data Patterns
|
||||||
|
|
||||||
|
**Features:**
|
||||||
|
```tsx
|
||||||
|
const features = [
|
||||||
|
{
|
||||||
|
icon: Package,
|
||||||
|
title: "Fast Shipping",
|
||||||
|
description: "Get your order delivered within 2-3 business days."
|
||||||
|
},
|
||||||
|
// ... more features
|
||||||
|
];
|
||||||
|
```
|
||||||
|
|
||||||
|
**Products:**
|
||||||
|
```tsx
|
||||||
|
const products = [
|
||||||
|
{
|
||||||
|
title: "Premium Headphones",
|
||||||
|
description: "Wireless noise-cancelling headphones with 30-hour battery life.",
|
||||||
|
price: "$299",
|
||||||
|
image: "/images/headphones.jpg"
|
||||||
|
},
|
||||||
|
// ... more products
|
||||||
|
];
|
||||||
|
```
|
||||||
|
|
||||||
|
**Testimonials:**
|
||||||
|
```tsx
|
||||||
|
const testimonials = [
|
||||||
|
{
|
||||||
|
name: "Sarah Johnson",
|
||||||
|
role: "CEO, TechCorp",
|
||||||
|
content: "This component library transformed our development workflow. Highly recommend!",
|
||||||
|
image: "/images/avatar-1.jpg",
|
||||||
|
rating: 5
|
||||||
|
},
|
||||||
|
// ... more testimonials
|
||||||
|
];
|
||||||
|
```
|
||||||
|
|
||||||
|
## Multiple Sections Example
|
||||||
|
|
||||||
|
Preview pages can show multiple components together:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
"use client";
|
||||||
|
|
||||||
|
import React from "react";
|
||||||
|
import ReactLenis from "lenis/react";
|
||||||
|
import { ThemeProvider } from "@/providers/themeProvider/ThemeProvider";
|
||||||
|
import HeroBillboard from "@/components/sections/hero/HeroBillboard";
|
||||||
|
import FeatureCardOne from "@/components/sections/feature/FeatureCardOne";
|
||||||
|
import Footer from "@/components/sections/footer/FooterBase";
|
||||||
|
|
||||||
|
export default function FullPagePreview() {
|
||||||
|
return (
|
||||||
|
<ThemeProvider
|
||||||
|
defaultButtonVariant="icon-arrow"
|
||||||
|
defaultTextAnimation="entrance-slide"
|
||||||
|
borderRadius="rounded"
|
||||||
|
contentWidth="medium"
|
||||||
|
sizing="medium"
|
||||||
|
background="animatedGrid"
|
||||||
|
cardStyle="glass-flat"
|
||||||
|
primaryButtonStyle="gradient"
|
||||||
|
secondaryButtonStyle="glass"
|
||||||
|
headingFontWeight="medium"
|
||||||
|
>
|
||||||
|
<ReactLenis root>
|
||||||
|
<HeroBillboard {...heroProps} />
|
||||||
|
<FeatureCardOne {...featureProps} />
|
||||||
|
<Footer {...footerProps} />
|
||||||
|
</ReactLenis>
|
||||||
|
</ThemeProvider>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Preview Page Checklist
|
||||||
|
|
||||||
|
### File Setup
|
||||||
|
- [ ] Create in correct location: `/app/components/[category]/[component-name]/page.tsx`
|
||||||
|
- [ ] Use kebab-case for folder names
|
||||||
|
- [ ] Add `"use client"` directive at top
|
||||||
|
- [ ] Export default function with descriptive name
|
||||||
|
|
||||||
|
### Wrapper Configuration
|
||||||
|
- [ ] Wrap in ThemeProvider (outer)
|
||||||
|
- [ ] Wrap in ReactLenis with `root` prop (inner)
|
||||||
|
- [ ] Correct order: ThemeProvider > ReactLenis > Component
|
||||||
|
- [ ] Import both wrappers
|
||||||
|
|
||||||
|
### Component Props
|
||||||
|
- [ ] Use realistic, representative content
|
||||||
|
- [ ] Include all required props
|
||||||
|
- [ ] Test with typical prop combinations
|
||||||
|
- [ ] Use proper TypeScript types (no `any`)
|
||||||
|
|
||||||
|
### Theme Settings
|
||||||
|
- [ ] Configure appropriate theme settings for component type
|
||||||
|
- [ ] Use sensible defaults that showcase the component well
|
||||||
|
- [ ] Test with different theme configurations if needed
|
||||||
|
|
||||||
|
### Quality Checks
|
||||||
|
- [ ] Component renders without errors
|
||||||
|
- [ ] Smooth scrolling works
|
||||||
|
- [ ] Responsive design functions correctly
|
||||||
|
- [ ] Animations trigger properly
|
||||||
|
- [ ] No console warnings or errors
|
||||||
|
|
||||||
|
## Common Patterns
|
||||||
|
|
||||||
|
### Background for Preview
|
||||||
|
|
||||||
|
If the component needs a background color to be visible:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
<ReactLenis root>
|
||||||
|
<div className="min-h-screen bg-background">
|
||||||
|
<Component {...props} />
|
||||||
|
</div>
|
||||||
|
</ReactLenis>
|
||||||
|
```
|
||||||
|
|
||||||
|
### Centered Preview
|
||||||
|
|
||||||
|
For small components that need centering:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
<ReactLenis root>
|
||||||
|
<div className="min-h-screen flex items-center justify-center bg-background">
|
||||||
|
<Component {...props} />
|
||||||
|
</div>
|
||||||
|
</ReactLenis>
|
||||||
|
```
|
||||||
|
|
||||||
|
### Multiple Variants
|
||||||
|
|
||||||
|
Show multiple variants of the same component:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
<ReactLenis root>
|
||||||
|
<div className="min-h-screen bg-background py-20 space-y-20">
|
||||||
|
<ComponentName variant="primary" {...props} />
|
||||||
|
<ComponentName variant="secondary" {...props} />
|
||||||
|
<ComponentName variant="ghost" {...props} />
|
||||||
|
</div>
|
||||||
|
</ReactLenis>
|
||||||
|
```
|
||||||
|
|
||||||
|
## Best Practices
|
||||||
|
|
||||||
|
### ✅ DO:
|
||||||
|
|
||||||
|
- Use realistic, production-quality content
|
||||||
|
- Test responsive behavior
|
||||||
|
- Include all ThemeProvider configuration
|
||||||
|
- Use ReactLenis for smooth scrolling
|
||||||
|
- Follow naming conventions (kebab-case folders)
|
||||||
|
- Include required props only (let optional props use defaults)
|
||||||
|
- Test with different theme settings
|
||||||
|
|
||||||
|
### ❌ DO NOT:
|
||||||
|
|
||||||
|
- Use placeholder text like "Lorem ipsum" (use realistic content)
|
||||||
|
- Skip ThemeProvider or ReactLenis
|
||||||
|
- Put ReactLenis outside ThemeProvider
|
||||||
|
- Use hardcoded colors that break theming
|
||||||
|
- Create overly complex multi-component demos (keep focused)
|
||||||
|
- Forget "use client" directive
|
||||||
|
- Use incorrect folder structure
|
||||||
145
docs/README.md
Normal file
@@ -0,0 +1,145 @@
|
|||||||
|
# Component Library Documentation
|
||||||
|
|
||||||
|
This directory contains focused documentation for building components in this AI-optimized component library.
|
||||||
|
|
||||||
|
## Documentation Files
|
||||||
|
|
||||||
|
### 📋 [COMPONENT_IMPLEMENTATION.md](./COMPONENT_IMPLEMENTATION.md)
|
||||||
|
**Core component implementation patterns**
|
||||||
|
|
||||||
|
Load when: Creating or modifying component code
|
||||||
|
|
||||||
|
Covers:
|
||||||
|
- Component structure template
|
||||||
|
- Prop structure & defaults
|
||||||
|
- Naming conventions
|
||||||
|
- Component customizability
|
||||||
|
- Type safety
|
||||||
|
- Responsive design
|
||||||
|
- Content width pattern
|
||||||
|
- Implementation checklist
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 🎴 [CARDSTACK_SECTIONS.md](./CARDSTACK_SECTIONS.md)
|
||||||
|
**CardStack-based section components**
|
||||||
|
|
||||||
|
Load when: Creating Feature, Product, Pricing, Testimonial, Team, Blog, or Metrics sections
|
||||||
|
|
||||||
|
Covers:
|
||||||
|
- CardStack pattern overview
|
||||||
|
- Grid variants (10+ layouts)
|
||||||
|
- Height control (`uniformGridCustomHeightClasses`)
|
||||||
|
- Carousel modes
|
||||||
|
- TextBox integration
|
||||||
|
- Button system
|
||||||
|
- Animation types
|
||||||
|
- Complete examples & checklist
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 🎨 [THEME_AND_STYLING.md](./THEME_AND_STYLING.md)
|
||||||
|
**Theme system and styling patterns**
|
||||||
|
|
||||||
|
Load when: Setting up themes, working with colors, or styling components
|
||||||
|
|
||||||
|
Covers:
|
||||||
|
- Theme Provider configuration
|
||||||
|
- Color theming (CSS variables)
|
||||||
|
- Inverted background pattern
|
||||||
|
- Content width pattern
|
||||||
|
- Card styling
|
||||||
|
- Border radius patterns
|
||||||
|
- Button styling classes
|
||||||
|
- Styling checklist
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### ♿ [ACCESSIBILITY.md](./ACCESSIBILITY.md)
|
||||||
|
**Accessibility (a11y) standards**
|
||||||
|
|
||||||
|
Load when: Adding interactive elements, media, or sections
|
||||||
|
|
||||||
|
Covers:
|
||||||
|
- Interactive components (buttons, links)
|
||||||
|
- Media components (images, videos)
|
||||||
|
- Section components (semantic HTML)
|
||||||
|
- Form components
|
||||||
|
- Focus management
|
||||||
|
- Keyboard navigation
|
||||||
|
- ARIA roles
|
||||||
|
- Accessibility checklist
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 📚 [REGISTRY_STANDARDS.md](./REGISTRY_STANDARDS.md)
|
||||||
|
**Registry documentation rules**
|
||||||
|
|
||||||
|
Load when: Adding or updating component entries in `registry.json`
|
||||||
|
|
||||||
|
Covers:
|
||||||
|
- Registry structure
|
||||||
|
- Component entry format
|
||||||
|
- Field descriptions
|
||||||
|
- propsSchema rules
|
||||||
|
- Constraints format
|
||||||
|
- Usage examples
|
||||||
|
- What to include/exclude
|
||||||
|
- Validation checklist
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 📄 [PREVIEW_PAGE_STANDARDS.md](./PREVIEW_PAGE_STANDARDS.md)
|
||||||
|
**Preview page setup and patterns**
|
||||||
|
|
||||||
|
Load when: Creating preview pages in `/app/components/`
|
||||||
|
|
||||||
|
Covers:
|
||||||
|
- File structure & location
|
||||||
|
- Preview page templates
|
||||||
|
- Wrapper order (ThemeProvider > ReactLenis)
|
||||||
|
- Theme configuration
|
||||||
|
- Realistic props
|
||||||
|
- Multiple sections example
|
||||||
|
- Preview page checklist
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Quick Reference
|
||||||
|
|
||||||
|
### When creating a new component:
|
||||||
|
1. Load `COMPONENT_IMPLEMENTATION.md` for structure
|
||||||
|
2. Load `ACCESSIBILITY.md` for a11y requirements
|
||||||
|
3. Load `THEME_AND_STYLING.md` for styling patterns
|
||||||
|
4. Load `CARDSTACK_SECTIONS.md` if using CardStack
|
||||||
|
|
||||||
|
### When updating the registry:
|
||||||
|
1. Load `REGISTRY_STANDARDS.md` only
|
||||||
|
|
||||||
|
### When creating a preview page:
|
||||||
|
1. Load `PREVIEW_PAGE_STANDARDS.md` only
|
||||||
|
|
||||||
|
### When modifying themes:
|
||||||
|
1. Load `THEME_AND_STYLING.md` only
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Documentation Principles
|
||||||
|
|
||||||
|
These docs are optimized for:
|
||||||
|
- **AI builders** (Lovable, V0, Claude Code)
|
||||||
|
- **Focused context** (load only what you need)
|
||||||
|
- **Quick reference** (checklists and examples)
|
||||||
|
- **Consistency** (standardized patterns across all components)
|
||||||
|
|
||||||
|
Each file is:
|
||||||
|
- **Single-purpose** - covers one concern thoroughly
|
||||||
|
- **Self-contained** - minimal cross-references
|
||||||
|
- **Example-driven** - shows good/bad patterns
|
||||||
|
- **Checklist-equipped** - actionable validation steps
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Legacy Documentation
|
||||||
|
|
||||||
|
The original `COMPONENT_STANDARDS.md` file has been split into these focused documents. Refer to these new files for all component development.
|
||||||
487
docs/REGISTRY_STANDARDS.md
Normal file
@@ -0,0 +1,487 @@
|
|||||||
|
# Registry Documentation Standards
|
||||||
|
|
||||||
|
This document outlines how to document components in `registry.json` for AI website builders.
|
||||||
|
|
||||||
|
## Registry Structure
|
||||||
|
|
||||||
|
The registry is organized into two main sections:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"componentRegistry": {
|
||||||
|
"button": [...],
|
||||||
|
"text": [...],
|
||||||
|
"navbar": [...],
|
||||||
|
"layout": [...]
|
||||||
|
},
|
||||||
|
"sectionRegistry": {
|
||||||
|
"hero": [...],
|
||||||
|
"about": [...],
|
||||||
|
"feature": [...],
|
||||||
|
"testimonial": [...],
|
||||||
|
"pricing": [...],
|
||||||
|
"team": [...],
|
||||||
|
"product": [...],
|
||||||
|
"metrics": [...],
|
||||||
|
"blog": [...],
|
||||||
|
"footer": [...],
|
||||||
|
"contact": [...],
|
||||||
|
"faq": [...],
|
||||||
|
"socialProof": [...]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**componentRegistry** - Base/utility components (buttons, text, navbar, CardStack, etc.)
|
||||||
|
**sectionRegistry** - Section components (hero, about, feature, etc.)
|
||||||
|
|
||||||
|
## Component Entry Format
|
||||||
|
|
||||||
|
Every component entry must follow this structure:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"import": "import ComponentName from '@/components/category/ComponentName';",
|
||||||
|
"name": "ComponentName",
|
||||||
|
"path": "@/components/category/ComponentName",
|
||||||
|
"description": "Brief one-line description of what the component is.",
|
||||||
|
"details": "Longer description of when to use it, behavior, and constraints.",
|
||||||
|
"constraints": {
|
||||||
|
"textRules": {
|
||||||
|
"text": {
|
||||||
|
"required": true,
|
||||||
|
"example": "Example text",
|
||||||
|
"minChars": 2,
|
||||||
|
"maxChars": 15
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"propsSchema": {
|
||||||
|
"text": "string",
|
||||||
|
"onClick?": "() => void",
|
||||||
|
"className?": "string",
|
||||||
|
"disabled?": "boolean (default: false)",
|
||||||
|
"ariaLabel?": "string",
|
||||||
|
"type?": "'button' | 'submit' | 'reset' (default: 'button')"
|
||||||
|
},
|
||||||
|
"usage": "<ComponentName text=\"Example\" onClick={() => console.log('clicked')} />"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Field Descriptions
|
||||||
|
|
||||||
|
### import
|
||||||
|
The exact import statement AI should use.
|
||||||
|
|
||||||
|
**Format:**
|
||||||
|
```json
|
||||||
|
"import": "import ComponentName from '@/components/category/ComponentName';"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Examples:**
|
||||||
|
```json
|
||||||
|
"import": "import HeroBillboard from '@/components/sections/hero/HeroBillboard';"
|
||||||
|
"import": "import ButtonTextStagger from '@/components/button/text-stagger/ButtonTextStagger';"
|
||||||
|
"import": "import CardStack from '@/components/cardStack/CardStack';"
|
||||||
|
```
|
||||||
|
|
||||||
|
### name
|
||||||
|
Component name exactly as exported.
|
||||||
|
|
||||||
|
**Format:**
|
||||||
|
```json
|
||||||
|
"name": "ComponentName"
|
||||||
|
```
|
||||||
|
|
||||||
|
### path
|
||||||
|
File path without extension.
|
||||||
|
|
||||||
|
**Format:**
|
||||||
|
```json
|
||||||
|
"path": "@/components/category/ComponentName"
|
||||||
|
```
|
||||||
|
|
||||||
|
### description
|
||||||
|
One-line summary of what the component is. Focus on visual/behavioral characteristics.
|
||||||
|
|
||||||
|
**Format:** 1 sentence, under 100 characters
|
||||||
|
|
||||||
|
**Good Examples:**
|
||||||
|
```json
|
||||||
|
"description": "CTA button with character stagger animation on hover."
|
||||||
|
"description": "Full-width hero section with centered text and billboard layout."
|
||||||
|
"description": "Feature section with grid or carousel layout for feature cards."
|
||||||
|
```
|
||||||
|
|
||||||
|
**Bad Examples:**
|
||||||
|
```json
|
||||||
|
"description": "A really cool button component with lots of features and animations that can be used anywhere." // Too verbose
|
||||||
|
"description": "Button" // Too vague
|
||||||
|
```
|
||||||
|
|
||||||
|
### details
|
||||||
|
Longer description covering:
|
||||||
|
- When to use it
|
||||||
|
- Key behavior notes
|
||||||
|
- Important constraints
|
||||||
|
|
||||||
|
**Format:** 2-4 sentences
|
||||||
|
|
||||||
|
**Good Example:**
|
||||||
|
```json
|
||||||
|
"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 and supports all standard button props."
|
||||||
|
```
|
||||||
|
|
||||||
|
**Bad Example:**
|
||||||
|
```json
|
||||||
|
"details": "This is a button that you can click and it will do something when you click it. It has animations." // Too obvious, not helpful
|
||||||
|
```
|
||||||
|
|
||||||
|
### constraints
|
||||||
|
|
||||||
|
Defines text length constraints for string props.
|
||||||
|
|
||||||
|
**Format:**
|
||||||
|
```json
|
||||||
|
"constraints": {
|
||||||
|
"textRules": {
|
||||||
|
"propName": {
|
||||||
|
"required": true,
|
||||||
|
"example": "Example value",
|
||||||
|
"minChars": 2,
|
||||||
|
"maxChars": 15
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Common Patterns:**
|
||||||
|
|
||||||
|
**Button text:**
|
||||||
|
```json
|
||||||
|
"constraints": {
|
||||||
|
"textRules": {
|
||||||
|
"text": {
|
||||||
|
"required": true,
|
||||||
|
"example": "Get Started",
|
||||||
|
"minChars": 2,
|
||||||
|
"maxChars": 15
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Section titles and descriptions:**
|
||||||
|
```json
|
||||||
|
"constraints": {
|
||||||
|
"textRules": {
|
||||||
|
"title": {
|
||||||
|
"required": true,
|
||||||
|
"example": "Welcome to Our Platform",
|
||||||
|
"minChars": 5,
|
||||||
|
"maxChars": 60
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"required": true,
|
||||||
|
"example": "Build amazing websites with our component library",
|
||||||
|
"minChars": 10,
|
||||||
|
"maxChars": 200
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### propsSchema
|
||||||
|
|
||||||
|
Documents all component props with types and defaults.
|
||||||
|
|
||||||
|
**Format Rules:**
|
||||||
|
|
||||||
|
**Required props:**
|
||||||
|
```json
|
||||||
|
"propName": "type"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Optional props:**
|
||||||
|
```json
|
||||||
|
"propName?": "type"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Optional props with defaults:**
|
||||||
|
```json
|
||||||
|
"propName?": "type (default: value)"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Examples:**
|
||||||
|
|
||||||
|
**Simple types:**
|
||||||
|
```json
|
||||||
|
"text": "string",
|
||||||
|
"count": "number",
|
||||||
|
"enabled": "boolean"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Functions:**
|
||||||
|
```json
|
||||||
|
"onClick?": "() => void",
|
||||||
|
"onChange?": "(value: string) => void",
|
||||||
|
"onSubmit?": "(data: FormData) => Promise<void>"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Union types:**
|
||||||
|
```json
|
||||||
|
"type?": "'button' | 'submit' | 'reset' (default: 'button')",
|
||||||
|
"variant?": "'primary' | 'secondary' | 'ghost'",
|
||||||
|
"size?": "'sm' | 'md' | 'lg' (default: 'md')"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Array types:**
|
||||||
|
```json
|
||||||
|
"items": "Array<{ title: string; description: string }>",
|
||||||
|
"buttons?": "ButtonConfig[]",
|
||||||
|
"features": "Feature[]"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Complex types:**
|
||||||
|
```json
|
||||||
|
"gridVariant": "'uniform-all-items-equal' | 'two-columns-alternating-heights' | 'asymmetric-60-wide-40-narrow' | ...",
|
||||||
|
"icon?": "LucideIcon",
|
||||||
|
"image?": "string (URL or path)"
|
||||||
|
```
|
||||||
|
|
||||||
|
**With defaults:**
|
||||||
|
```json
|
||||||
|
"className?": "string",
|
||||||
|
"disabled?": "boolean (default: false)",
|
||||||
|
"carouselMode?": "'auto' | 'buttons' (default: 'buttons')",
|
||||||
|
"uniformGridCustomHeightClasses?": "string (default: 'min-h-80 2xl:min-h-90')"
|
||||||
|
```
|
||||||
|
|
||||||
|
### usage
|
||||||
|
|
||||||
|
Single-line example showing typical implementation.
|
||||||
|
|
||||||
|
**Format:** One line, realistic props, valid JSX
|
||||||
|
|
||||||
|
**Good Examples:**
|
||||||
|
|
||||||
|
**Button:**
|
||||||
|
```json
|
||||||
|
"usage": "<ButtonTextStagger text=\"Get Started\" onClick={() => console.log('clicked')} />"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Section with minimal props:**
|
||||||
|
```json
|
||||||
|
"usage": "<HeroBillboard title=\"Welcome\" description=\"Start building today\" buttons={[{ text: 'Get Started', href: '/signup' }]} />"
|
||||||
|
```
|
||||||
|
|
||||||
|
**CardStack section:**
|
||||||
|
```json
|
||||||
|
"usage": "<FeatureCardOne features={featuresData} gridVariant=\"uniform-all-items-equal\" textboxLayout=\"default\" title=\"Features\" description=\"Our key features\" />"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Bad Examples:**
|
||||||
|
```json
|
||||||
|
"usage": "<Component />" // Missing required props
|
||||||
|
"usage": "<Component\n prop1=\"value\"\n prop2=\"value\"\n/>" // Multi-line, hard to read
|
||||||
|
"usage": "Component({ text: 'Hi' })" // Not JSX
|
||||||
|
```
|
||||||
|
|
||||||
|
## What to Include
|
||||||
|
|
||||||
|
### ✅ DO Include:
|
||||||
|
|
||||||
|
**Default values in propsSchema** - Critical for AI to generate correct code
|
||||||
|
```json
|
||||||
|
"disabled?": "boolean (default: false)",
|
||||||
|
"type?": "'button' | 'submit' | 'reset' (default: 'button')"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Usage examples** - Helps AI understand context
|
||||||
|
```json
|
||||||
|
"usage": "<ButtonTextStagger text=\"Click me\" onClick={() => alert('Hi')} />"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Text constraints** - Min/max character limits
|
||||||
|
```json
|
||||||
|
"constraints": {
|
||||||
|
"textRules": {
|
||||||
|
"text": {
|
||||||
|
"required": true,
|
||||||
|
"example": "Get Started",
|
||||||
|
"minChars": 2,
|
||||||
|
"maxChars": 15
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Accurate descriptions** - Ensure description matches actual behavior
|
||||||
|
```json
|
||||||
|
"description": "CTA button with character stagger animation on hover.",
|
||||||
|
"details": "Use for primary or secondary CTAs where subtle text motion adds emphasis."
|
||||||
|
```
|
||||||
|
|
||||||
|
**Use case guidance** - When to use this vs alternatives
|
||||||
|
```json
|
||||||
|
"details": "Use for hero sections with centered content and billboard layout. Best for landing pages and marketing sites."
|
||||||
|
```
|
||||||
|
|
||||||
|
## What NOT to Include
|
||||||
|
|
||||||
|
### ❌ DO NOT Include:
|
||||||
|
|
||||||
|
**Metadata field** - Unnecessary complexity
|
||||||
|
```json
|
||||||
|
// Don't do this:
|
||||||
|
"metadata": {
|
||||||
|
"category": "button",
|
||||||
|
"version": "1.0.0",
|
||||||
|
"author": "..."
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Verbose descriptions** - Keep concise and obvious
|
||||||
|
```json
|
||||||
|
// Don't do this:
|
||||||
|
"description": "This is an amazing button component that you can use to create buttons with stagger animations that look really cool and modern and will make your website stand out from the competition."
|
||||||
|
```
|
||||||
|
|
||||||
|
**Dependencies** - AI builders can infer from imports
|
||||||
|
```json
|
||||||
|
// Don't do this:
|
||||||
|
"dependencies": ["lucide-react", "framer-motion"]
|
||||||
|
```
|
||||||
|
|
||||||
|
**Over-documentation** - If it's obvious from the name, skip it
|
||||||
|
```json
|
||||||
|
// Don't do this:
|
||||||
|
"details": "This is a button. You can click it. It accepts text to display on the button."
|
||||||
|
```
|
||||||
|
|
||||||
|
**Implementation details** - Focus on usage, not internals
|
||||||
|
```json
|
||||||
|
// Don't do this:
|
||||||
|
"details": "Uses GSAP ScrollTrigger with stagger: 0.1 and uses React.memo for performance and has displayName set to ButtonTextStagger."
|
||||||
|
```
|
||||||
|
|
||||||
|
## Complete Examples
|
||||||
|
|
||||||
|
### Button Component
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"import": "import ButtonTextStagger from '@/components/button/text-stagger/ButtonTextStagger';",
|
||||||
|
"name": "ButtonTextStagger",
|
||||||
|
"path": "@/components/button/text-stagger/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": 15
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"propsSchema": {
|
||||||
|
"text": "string",
|
||||||
|
"onClick?": "() => void",
|
||||||
|
"href?": "string",
|
||||||
|
"className?": "string",
|
||||||
|
"textClassName?": "string",
|
||||||
|
"disabled?": "boolean (default: false)",
|
||||||
|
"ariaLabel?": "string",
|
||||||
|
"type?": "'button' | 'submit' | 'reset' (default: 'button')"
|
||||||
|
},
|
||||||
|
"usage": "<ButtonTextStagger text=\"Get Started\" onClick={() => console.log('clicked')} />"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Section Component (CardStack-based)
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"import": "import FeatureCardOne from '@/components/sections/feature/FeatureCardOne';",
|
||||||
|
"name": "FeatureCardOne",
|
||||||
|
"path": "@/components/sections/feature/FeatureCardOne",
|
||||||
|
"description": "Feature section with grid or carousel layout for feature cards.",
|
||||||
|
"details": "Displays feature cards in a responsive grid (1-4 items) or carousel (5+ items). Supports TextBox header with multiple layout options. Each card includes icon, title, and description.",
|
||||||
|
"constraints": {
|
||||||
|
"textRules": {
|
||||||
|
"title": {
|
||||||
|
"required": true,
|
||||||
|
"example": "Our Features",
|
||||||
|
"minChars": 5,
|
||||||
|
"maxChars": 60
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"required": true,
|
||||||
|
"example": "Discover what makes us unique",
|
||||||
|
"minChars": 10,
|
||||||
|
"maxChars": 200
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"propsSchema": {
|
||||||
|
"features": "Array<{ icon: LucideIcon; title: string; description: string }>",
|
||||||
|
"gridVariant": "'uniform-all-items-equal' | 'two-columns-alternating-heights' | 'asymmetric-60-wide-40-narrow' | ...",
|
||||||
|
"title": "string",
|
||||||
|
"description": "string",
|
||||||
|
"tag?": "string",
|
||||||
|
"tagIcon?": "LucideIcon",
|
||||||
|
"buttons?": "ButtonConfig[]",
|
||||||
|
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description'",
|
||||||
|
"carouselMode?": "'auto' | 'buttons' (default: 'buttons')",
|
||||||
|
"uniformGridCustomHeightClasses?": "string (default: 'min-h-80 2xl:min-h-90')",
|
||||||
|
"ariaLabel?": "string",
|
||||||
|
"className?": "string"
|
||||||
|
},
|
||||||
|
"usage": "<FeatureCardOne features={featuresData} gridVariant=\"uniform-all-items-equal\" textboxLayout=\"default\" title=\"Features\" description=\"Our key features\" />"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Registry Validation Checklist
|
||||||
|
|
||||||
|
When adding a new component to the registry:
|
||||||
|
|
||||||
|
### Required Fields
|
||||||
|
- [ ] `import` - Exact import statement
|
||||||
|
- [ ] `name` - Component name
|
||||||
|
- [ ] `path` - File path without extension
|
||||||
|
- [ ] `description` - One-line summary
|
||||||
|
- [ ] `details` - When to use, behavior, constraints
|
||||||
|
- [ ] `propsSchema` - All props documented
|
||||||
|
- [ ] `usage` - Single-line example
|
||||||
|
|
||||||
|
### Constraints (if applicable)
|
||||||
|
- [ ] Add `textRules` for text props
|
||||||
|
- [ ] Set `minChars` and `maxChars`
|
||||||
|
- [ ] Provide realistic `example` values
|
||||||
|
- [ ] Mark `required: true` for required props
|
||||||
|
|
||||||
|
### propsSchema Format
|
||||||
|
- [ ] Required props: `"prop": "type"`
|
||||||
|
- [ ] Optional props: `"prop?": "type"`
|
||||||
|
- [ ] Defaults: `"prop?": "type (default: value)"`
|
||||||
|
- [ ] All types match component implementation
|
||||||
|
- [ ] Union types use single quotes inside double quotes
|
||||||
|
|
||||||
|
### Quality Checks
|
||||||
|
- [ ] Description is concise (under 100 chars)
|
||||||
|
- [ ] Details provide use case guidance
|
||||||
|
- [ ] Usage example is valid JSX
|
||||||
|
- [ ] Usage example shows realistic props
|
||||||
|
- [ ] Default values documented in propsSchema
|
||||||
|
- [ ] No over-documentation or verbose descriptions
|
||||||
|
- [ ] No unnecessary metadata or dependencies
|
||||||
|
|
||||||
|
### Consistency Checks
|
||||||
|
- [ ] Component name matches file name
|
||||||
|
- [ ] Path matches actual file location
|
||||||
|
- [ ] Import statement is correct
|
||||||
|
- [ ] Props match actual component interface
|
||||||
|
- [ ] Defaults in registry match component defaults
|
||||||
|
- [ ] Naming follows conventions (title/description for sections, text for buttons)
|
||||||
521
docs/THEME_AND_STYLING.md
Normal file
@@ -0,0 +1,521 @@
|
|||||||
|
# Theme and Styling Standards
|
||||||
|
|
||||||
|
This document covers the centralized theme system, color theming, and styling patterns used throughout the component library.
|
||||||
|
|
||||||
|
## Theme Provider System
|
||||||
|
|
||||||
|
All sections and components use a centralized ThemeProvider to maintain consistent styling across the entire site.
|
||||||
|
|
||||||
|
### Location & Setup
|
||||||
|
|
||||||
|
**Import:**
|
||||||
|
```tsx
|
||||||
|
import { ThemeProvider } from "@/providers/themeProvider/ThemeProvider";
|
||||||
|
```
|
||||||
|
|
||||||
|
**Usage:** Wrap the entire app/page (not individual sections) in a **single** ThemeProvider:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
export default function Page() {
|
||||||
|
return (
|
||||||
|
<ThemeProvider
|
||||||
|
defaultButtonVariant="text-stagger"
|
||||||
|
defaultTextAnimation="entrance-slide"
|
||||||
|
borderRadius="rounded"
|
||||||
|
contentWidth="medium"
|
||||||
|
sizing="medium"
|
||||||
|
background="animatedGrid"
|
||||||
|
cardStyle="glass-flat"
|
||||||
|
primaryButtonStyle="gradient"
|
||||||
|
secondaryButtonStyle="glass"
|
||||||
|
headingFontWeight="medium"
|
||||||
|
>
|
||||||
|
<HeroBillboard {...props} />
|
||||||
|
<FeatureSection {...props} />
|
||||||
|
<Footer {...props} />
|
||||||
|
</ThemeProvider>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Theme Configuration Options
|
||||||
|
|
||||||
|
#### defaultButtonVariant
|
||||||
|
Controls the button style for ALL buttons in sections.
|
||||||
|
|
||||||
|
**Options:**
|
||||||
|
- `"text-stagger"` - Character stagger animation on hover (default)
|
||||||
|
- `"shift-hover"` - Text shifts on hover
|
||||||
|
- `"icon-arrow"` - Text + right arrow icon
|
||||||
|
- `"hover-magnetic"` - Cursor-tracking magnetic effect
|
||||||
|
- `"hover-bubble"` - Expanding circle on hover
|
||||||
|
- `"expand-hover"` - Width expansion on hover
|
||||||
|
|
||||||
|
#### defaultTextAnimation
|
||||||
|
Controls the text animation type for ALL text in sections.
|
||||||
|
|
||||||
|
**Options:**
|
||||||
|
- `"entrance-slide"` - Slide up from below (default)
|
||||||
|
- `"reveal-blur"` - Blur to clear reveal
|
||||||
|
- `"background-highlight"` - Background highlight effect
|
||||||
|
|
||||||
|
#### borderRadius
|
||||||
|
Controls border radius for buttons and cards.
|
||||||
|
|
||||||
|
**Options:**
|
||||||
|
- `"rounded"` - Standard rounded corners
|
||||||
|
- `"pill"` - Fully rounded (pill shape)
|
||||||
|
- `"sharp"` - No border radius
|
||||||
|
|
||||||
|
#### contentWidth
|
||||||
|
Controls the max width of section content.
|
||||||
|
|
||||||
|
**Options:**
|
||||||
|
- `"small"` - Narrow content width
|
||||||
|
- `"medium"` - Standard content width (default)
|
||||||
|
- `"large"` - Wide content width
|
||||||
|
|
||||||
|
Maps to `w-content-width` CSS class.
|
||||||
|
|
||||||
|
#### sizing
|
||||||
|
Controls spacing and size scale throughout components.
|
||||||
|
|
||||||
|
**Options:**
|
||||||
|
- `"small"` - Compact spacing
|
||||||
|
- `"medium"` - Standard spacing (default)
|
||||||
|
- `"large"` - Generous spacing
|
||||||
|
|
||||||
|
#### background
|
||||||
|
Default background pattern for the page.
|
||||||
|
|
||||||
|
**Options:**
|
||||||
|
- `"plain"` - Solid background color
|
||||||
|
- `"animatedGrid"` - Animated grid pattern
|
||||||
|
- `"aurora"` - Aurora gradient effect
|
||||||
|
- `"dotGrid"` - Dot grid pattern
|
||||||
|
- And more...
|
||||||
|
|
||||||
|
#### cardStyle
|
||||||
|
Visual style for all card components.
|
||||||
|
|
||||||
|
**Options:**
|
||||||
|
- `"glass-flat"` - Flat glass effect (default)
|
||||||
|
- `"glass-depth"` - Glass with depth/shadow
|
||||||
|
- `"glass-outline"` - Outlined glass
|
||||||
|
- `"solid-accent-light"` - Solid light accent
|
||||||
|
- `"outline"` - Simple outline
|
||||||
|
- `"elevated"` - Elevated shadow effect
|
||||||
|
- `"frosted"` - Frosted glass
|
||||||
|
- And more...
|
||||||
|
|
||||||
|
#### primaryButtonStyle
|
||||||
|
Style for primary buttons (first button in array).
|
||||||
|
|
||||||
|
**Options:**
|
||||||
|
- `"gradient"` - Gradient background
|
||||||
|
- `"solid"` - Solid color background
|
||||||
|
- `"glass"` - Glass effect
|
||||||
|
- `"outline"` - Outlined button
|
||||||
|
|
||||||
|
#### secondaryButtonStyle
|
||||||
|
Style for secondary buttons (second+ button in array).
|
||||||
|
|
||||||
|
**Options:**
|
||||||
|
- `"glass"` - Glass effect (default)
|
||||||
|
- `"outline"` - Outlined button
|
||||||
|
- `"solid"` - Solid color background
|
||||||
|
- `"gradient"` - Gradient background
|
||||||
|
|
||||||
|
#### headingFontWeight
|
||||||
|
Font weight for all headings.
|
||||||
|
|
||||||
|
**Options:**
|
||||||
|
- `"normal"` - Regular weight
|
||||||
|
- `"medium"` - Medium weight (default)
|
||||||
|
- `"semibold"` - Semi-bold weight
|
||||||
|
- `"bold"` - Bold weight
|
||||||
|
|
||||||
|
### Using Theme in Components
|
||||||
|
|
||||||
|
#### useTheme Hook
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
import { useTheme } from "@/providers/themeProvider/ThemeProvider";
|
||||||
|
|
||||||
|
const Component = () => {
|
||||||
|
const theme = useTheme();
|
||||||
|
|
||||||
|
// Access theme properties:
|
||||||
|
// - theme.defaultButtonVariant
|
||||||
|
// - theme.defaultTextAnimation
|
||||||
|
// - theme.borderRadius
|
||||||
|
// - theme.cardStyle
|
||||||
|
// - theme.contentWidth
|
||||||
|
// - theme.sizing
|
||||||
|
// - theme.background
|
||||||
|
// - theme.primaryButtonStyle
|
||||||
|
// - theme.secondaryButtonStyle
|
||||||
|
// - theme.headingFontWeight
|
||||||
|
|
||||||
|
return <div>{/* component */}</div>;
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
#### TextBox Component Example
|
||||||
|
|
||||||
|
TextBox automatically applies theme defaults:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
const TextBox = ({ type, buttons, ...props }: TextBoxProps) => {
|
||||||
|
const theme = useTheme();
|
||||||
|
|
||||||
|
// Use default text animation from theme if not specified
|
||||||
|
const animationType = type || theme.defaultTextAnimation;
|
||||||
|
|
||||||
|
// Button variant comes from theme
|
||||||
|
const variant = theme.defaultButtonVariant;
|
||||||
|
|
||||||
|
// ...
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
### Important Rules
|
||||||
|
|
||||||
|
❌ **DO NOT:**
|
||||||
|
- Specify button `variant` in section button configs (controlled by ThemeProvider)
|
||||||
|
- Wrap individual sections in ThemeProvider (use ONE provider per site/page)
|
||||||
|
- Override theme defaults unless explicitly required by component design
|
||||||
|
|
||||||
|
✅ **DO:**
|
||||||
|
- Wrap the entire app/page in a single ThemeProvider
|
||||||
|
- Let all sections inherit theme defaults automatically
|
||||||
|
- Use `useTheme()` hook to access theme configuration
|
||||||
|
- Document when components don't follow theme defaults (with clear reason)
|
||||||
|
|
||||||
|
## Color & Theming
|
||||||
|
|
||||||
|
### CSS Custom Properties
|
||||||
|
|
||||||
|
**Always use CSS custom properties for colors** to ensure theme consistency:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
// ✅ CORRECT - Uses theme variables
|
||||||
|
<div className="bg-background text-foreground">
|
||||||
|
<button className="bg-foreground text-background">Click me</button>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
// ❌ WRONG - Hardcoded colors break theming
|
||||||
|
<div className="bg-white text-black">
|
||||||
|
<button className="bg-black text-white">Click me</button>
|
||||||
|
</div>
|
||||||
|
```
|
||||||
|
|
||||||
|
### Standard Color Variables
|
||||||
|
|
||||||
|
**Background & Text:**
|
||||||
|
- `bg-background` - Main background color
|
||||||
|
- `text-foreground` - Main text color
|
||||||
|
- `bg-foreground` - Inverse background (for buttons, accents)
|
||||||
|
- `text-background` - Inverse text (for text on dark backgrounds)
|
||||||
|
|
||||||
|
**Cards & Surfaces:**
|
||||||
|
- `card` - Card/surface background with border (theme-aware)
|
||||||
|
- Maps to different styles based on `theme.cardStyle`
|
||||||
|
|
||||||
|
**Buttons:**
|
||||||
|
- `primary-button` - Primary button styling (index 0)
|
||||||
|
- `secondary-button` - Secondary button styling (index 1+)
|
||||||
|
|
||||||
|
**Opacity Modifiers:**
|
||||||
|
```tsx
|
||||||
|
text-foreground/75 // 75% opacity
|
||||||
|
text-background/50 // 50% opacity
|
||||||
|
bg-foreground/10 // 10% opacity
|
||||||
|
```
|
||||||
|
|
||||||
|
### When to Use Theme Colors
|
||||||
|
|
||||||
|
✅ **Always prefer theme variables:**
|
||||||
|
- Backgrounds, text, borders, shadows
|
||||||
|
- Ensures proper dark mode support
|
||||||
|
- Allows theme customization
|
||||||
|
- Maintains visual consistency
|
||||||
|
|
||||||
|
❌ **Only use hardcoded colors:**
|
||||||
|
- Very specific one-off cases with clear justification
|
||||||
|
- Decorative elements that shouldn't change with theme
|
||||||
|
- Must be documented in component comments
|
||||||
|
|
||||||
|
## Inverted Background Pattern
|
||||||
|
|
||||||
|
Section components support three modes for background styling, allowing flexible visual contrast and card-style layouts.
|
||||||
|
|
||||||
|
### Three Background Modes
|
||||||
|
|
||||||
|
**`"noInvert"`** - Standard background (default page background color)
|
||||||
|
- No background color applied to section
|
||||||
|
- Text uses standard `text-foreground` color
|
||||||
|
- Full-width section
|
||||||
|
|
||||||
|
**`"invertDefault"`** - Full-width inverted background
|
||||||
|
- Section gets `bg-foreground` background
|
||||||
|
- Text uses `text-background` color for contrast
|
||||||
|
- Full-width section with inverted colors
|
||||||
|
|
||||||
|
### Implementation Pattern
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
import { cls } from "@/lib/utils";
|
||||||
|
import { useTheme } from "@/providers/themeProvider/ThemeProvider";
|
||||||
|
|
||||||
|
interface SectionProps {
|
||||||
|
title: string;
|
||||||
|
description: string;
|
||||||
|
useInvertedBackground: "noInvert" | "invertDefault"; // Required
|
||||||
|
// ... other props
|
||||||
|
}
|
||||||
|
|
||||||
|
const Section = ({
|
||||||
|
title,
|
||||||
|
description,
|
||||||
|
useInvertedBackground,
|
||||||
|
className = "",
|
||||||
|
// ... other props
|
||||||
|
}: SectionProps) => {
|
||||||
|
const theme = useTheme();
|
||||||
|
|
||||||
|
return (
|
||||||
|
<section
|
||||||
|
className={cls(
|
||||||
|
"relative py-20 w-full",
|
||||||
|
useInvertedBackground === "invertDefault" && "bg-foreground",
|
||||||
|
className
|
||||||
|
)}
|
||||||
|
>
|
||||||
|
<div className="w-content-width mx-auto">
|
||||||
|
<h1 className={cls(
|
||||||
|
"text-6xl font-medium",
|
||||||
|
useInvertedBackground === "invertDefault" && "text-background",
|
||||||
|
titleClassName
|
||||||
|
)}>
|
||||||
|
{title}
|
||||||
|
</h1>
|
||||||
|
<p className={cls(
|
||||||
|
"text-lg",
|
||||||
|
useInvertedBackground === "invertDefault"
|
||||||
|
? "text-background/75"
|
||||||
|
: "text-foreground/75",
|
||||||
|
descriptionClassName
|
||||||
|
)}>
|
||||||
|
{description}
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
### Key Points
|
||||||
|
|
||||||
|
1. **Required Prop**: `useInvertedBackground` should be a required string union type (no `?`), forcing explicit choice
|
||||||
|
2. **Two Modes**: `"noInvert"`, `"invertDefault"`
|
||||||
|
3. **Section Width**: Always `w-full`
|
||||||
|
4. **Background Color**:
|
||||||
|
- `"invertDefault"` → `bg-foreground`
|
||||||
|
- `"noInvert"` → no background
|
||||||
|
5. **Text Colors**: Apply `text-background` or `text-background/75` for `"invertDefault"` mode
|
||||||
|
6. **Relative Positioning**: Section needs `relative` class for proper z-index stacking
|
||||||
|
7. **Conditional Logic**: Use explicit string equality checks (not truthy/falsy)
|
||||||
|
|
||||||
|
### Section className Pattern
|
||||||
|
|
||||||
|
**Standard pattern for all sections:**
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
<section
|
||||||
|
className={cls(
|
||||||
|
"relative py-20 w-full",
|
||||||
|
useInvertedBackground === "invertDefault" && "bg-foreground",
|
||||||
|
className
|
||||||
|
)}
|
||||||
|
>
|
||||||
|
```
|
||||||
|
|
||||||
|
### Text Color Pattern
|
||||||
|
|
||||||
|
**For text elements:**
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
// Single check for invert mode:
|
||||||
|
useInvertedBackground === "invertDefault" && "text-background"
|
||||||
|
|
||||||
|
// Ternary for opacity variants:
|
||||||
|
useInvertedBackground === "invertDefault"
|
||||||
|
? "text-background/75"
|
||||||
|
: "text-foreground/75"
|
||||||
|
```
|
||||||
|
|
||||||
|
### For Components with Cards (Advanced)
|
||||||
|
|
||||||
|
When a section contains cards with light backgrounds, use the `shouldUseInvertedText` utility:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
import { cls, shouldUseInvertedText } from "@/lib/utils";
|
||||||
|
import { useTheme } from "@/providers/themeProvider/ThemeProvider";
|
||||||
|
|
||||||
|
const SectionWithCards = ({
|
||||||
|
useInvertedBackground,
|
||||||
|
// ... other props
|
||||||
|
}: SectionProps) => {
|
||||||
|
const theme = useTheme();
|
||||||
|
const shouldUseLightText = shouldUseInvertedText(
|
||||||
|
useInvertedBackground,
|
||||||
|
theme.cardStyle
|
||||||
|
);
|
||||||
|
|
||||||
|
return (
|
||||||
|
<section
|
||||||
|
className={cls(
|
||||||
|
"relative py-20 w-full",
|
||||||
|
useInvertedBackground === "invertDefault" && "bg-foreground",
|
||||||
|
className
|
||||||
|
)}
|
||||||
|
>
|
||||||
|
{/* For elements inside cards or with card backgrounds */}
|
||||||
|
<h3 className={cls(
|
||||||
|
"text-xl",
|
||||||
|
shouldUseLightText && "text-background",
|
||||||
|
bulletTitleClassName
|
||||||
|
)}>
|
||||||
|
{point.title}
|
||||||
|
</h3>
|
||||||
|
</section>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
**What it does:**
|
||||||
|
The `shouldUseInvertedText` utility checks if:
|
||||||
|
- `useInvertedBackground` is `"invertDefault"` AND
|
||||||
|
- Current `cardStyle` is a "light" style (e.g., `glass-elevated`, `outline`, etc.)
|
||||||
|
|
||||||
|
This ensures text inside cards remains readable regardless of theme configuration.
|
||||||
|
|
||||||
|
### Width Classes Explained
|
||||||
|
|
||||||
|
**`w-content-width`** - Content container width
|
||||||
|
- Controlled by `theme.contentWidth` (small/medium/large)
|
||||||
|
- Used for inner content wrapper in all sections
|
||||||
|
|
||||||
|
## Content Width Pattern
|
||||||
|
|
||||||
|
All section content must use the `w-content-width` class:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
<section className="w-full py-20">
|
||||||
|
<div className="w-content-width mx-auto">
|
||||||
|
{/* content */}
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
```
|
||||||
|
|
||||||
|
**What it does:**
|
||||||
|
- Controlled by `theme.contentWidth` (small/medium/large)
|
||||||
|
- Automatically adjusts max-width based on theme setting
|
||||||
|
- Centers content with `mx-auto`
|
||||||
|
|
||||||
|
## Section Spacing
|
||||||
|
|
||||||
|
**Standard sections:**
|
||||||
|
```tsx
|
||||||
|
className="w-full py-20"
|
||||||
|
```
|
||||||
|
|
||||||
|
Vertical padding of `py-20` (5rem = 80px) on top and bottom.
|
||||||
|
|
||||||
|
**Exceptions (NO py-20):**
|
||||||
|
- Hero sections (custom spacing based on design)
|
||||||
|
- Footer sections (custom spacing)
|
||||||
|
- Full-bleed sections with background colors/images
|
||||||
|
|
||||||
|
## Card Styling Pattern
|
||||||
|
|
||||||
|
Use the `card` class for all card components:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
<div className={cls("card p-6 rounded-theme-capped h-full min-h-0", cardClassName)}>
|
||||||
|
{/* card content */}
|
||||||
|
</div>
|
||||||
|
```
|
||||||
|
|
||||||
|
**Classes explained:**
|
||||||
|
- `card` - Theme-aware background/border (maps to `theme.cardStyle`)
|
||||||
|
- `p-6` - Standard padding (1.5rem = 24px)
|
||||||
|
- `rounded-theme-capped` - Border radius from theme (respects `theme.borderRadius`)
|
||||||
|
- `h-full` - Fill parent height (for grid layouts)
|
||||||
|
- `min-h-0` - Prevent height conflicts (important for flex layouts)
|
||||||
|
|
||||||
|
## Border Radius Pattern
|
||||||
|
|
||||||
|
**For cards:**
|
||||||
|
```tsx
|
||||||
|
className="rounded-theme-capped"
|
||||||
|
```
|
||||||
|
|
||||||
|
**For buttons:**
|
||||||
|
```tsx
|
||||||
|
className="rounded-theme"
|
||||||
|
```
|
||||||
|
|
||||||
|
Both respect `theme.borderRadius` setting (rounded/pill/sharp).
|
||||||
|
|
||||||
|
## Button Styling Classes
|
||||||
|
|
||||||
|
**Primary button (first in array):**
|
||||||
|
```tsx
|
||||||
|
className="primary-button"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Secondary button (second+ in array):**
|
||||||
|
```tsx
|
||||||
|
className="secondary-button"
|
||||||
|
```
|
||||||
|
|
||||||
|
These classes are theme-aware and map to:
|
||||||
|
- `theme.primaryButtonStyle` (gradient/solid/glass/outline)
|
||||||
|
- `theme.secondaryButtonStyle` (glass/outline/solid/gradient)
|
||||||
|
|
||||||
|
## Styling Checklist
|
||||||
|
|
||||||
|
### Color Usage
|
||||||
|
- [ ] Use `bg-background` and `text-foreground` for main colors
|
||||||
|
- [ ] Use `bg-foreground` and `text-background` for inverted sections
|
||||||
|
- [ ] Use `card` class for card backgrounds
|
||||||
|
- [ ] Use `primary-button` and `secondary-button` for buttons
|
||||||
|
- [ ] Avoid hardcoded colors (white, black, gray-X) unless justified
|
||||||
|
|
||||||
|
### Theme Integration
|
||||||
|
- [ ] Wrap app/page in single ThemeProvider
|
||||||
|
- [ ] Use `useTheme()` hook when needed
|
||||||
|
- [ ] Don't specify button variants in ButtonConfig
|
||||||
|
- [ ] Let TextBox inherit default text animation
|
||||||
|
- [ ] Use `w-content-width mx-auto` for content
|
||||||
|
|
||||||
|
### Inverted Background (if applicable)
|
||||||
|
- [ ] Accept `useInvertedBackground` as required string union: `"noInvert" | "invertDefault"`
|
||||||
|
- [ ] Add `relative` class to section
|
||||||
|
- [ ] Implement two-mode section className pattern (invertDefault with bg-foreground, noInvert standard)
|
||||||
|
- [ ] Apply `text-background` to text for `"invertDefault"` mode (not `"noInvert"`)
|
||||||
|
- [ ] Use explicit string equality checks (not truthy/falsy)
|
||||||
|
- [ ] Use `shouldUseInvertedText` for card content if needed
|
||||||
|
|
||||||
|
### Card Styling
|
||||||
|
- [ ] Use `card` class for theme-aware background
|
||||||
|
- [ ] Use `rounded-theme-capped` for border radius
|
||||||
|
- [ ] Include `min-h-0` for flex compatibility
|
||||||
|
- [ ] Provide `cardClassName` override prop
|
||||||
|
|
||||||
|
### Spacing
|
||||||
|
- [ ] Use `py-20` on sections (except hero/footer)
|
||||||
|
- [ ] Use `w-content-width mx-auto` wrapper
|
||||||
|
- [ ] Follow theme spacing guidelines
|
||||||
55
eslint.config.mjs
Normal file
@@ -0,0 +1,55 @@
|
|||||||
|
import tseslint from "typescript-eslint";
|
||||||
|
import reactPlugin from "eslint-plugin-react";
|
||||||
|
import reactHooksPlugin from "eslint-plugin-react-hooks";
|
||||||
|
import nextPlugin from "@next/eslint-plugin-next";
|
||||||
|
|
||||||
|
export default tseslint.config(
|
||||||
|
...tseslint.configs.recommended,
|
||||||
|
{
|
||||||
|
files: ["**/*.{js,jsx,ts,tsx}"],
|
||||||
|
rules: {
|
||||||
|
"@typescript-eslint/no-unused-vars": "warn",
|
||||||
|
"@typescript-eslint/no-unused-expressions": "warn",
|
||||||
|
"@typescript-eslint/no-explicit-any": "off",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
{
|
||||||
|
files: ["src/app/*.{js,jsx,ts,tsx}"],
|
||||||
|
plugins: {
|
||||||
|
react: reactPlugin,
|
||||||
|
"react-hooks": reactHooksPlugin,
|
||||||
|
"@next/next": nextPlugin,
|
||||||
|
},
|
||||||
|
languageOptions: {
|
||||||
|
ecmaVersion: "latest",
|
||||||
|
sourceType: "module",
|
||||||
|
parserOptions: {
|
||||||
|
ecmaFeatures: {
|
||||||
|
jsx: true,
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
settings: {
|
||||||
|
react: {
|
||||||
|
version: "detect",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
rules: {
|
||||||
|
...reactPlugin.configs["jsx-runtime"].rules,
|
||||||
|
...reactHooksPlugin.configs.recommended.rules,
|
||||||
|
...nextPlugin.configs.recommended.rules,
|
||||||
|
...nextPlugin.configs["core-web-vitals"].rules,
|
||||||
|
"react/no-unescaped-entities": "off",
|
||||||
|
"@typescript-eslint/no-explicit-any": "off",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
{
|
||||||
|
ignores: [
|
||||||
|
"node_modules/**",
|
||||||
|
".next/**",
|
||||||
|
"out/**",
|
||||||
|
"build/**",
|
||||||
|
"next-env.d.ts",
|
||||||
|
],
|
||||||
|
}
|
||||||
|
);
|
||||||
301
fontThemes.json
Normal file
@@ -0,0 +1,301 @@
|
|||||||
|
{
|
||||||
|
"singleFonts": {
|
||||||
|
"interTight": {
|
||||||
|
"name": "Inter Tight",
|
||||||
|
"import": "import { Inter_Tight } from \"next/font/google\";",
|
||||||
|
"initialization": "const interTight = Inter_Tight({\n variable: \"--font-inter-tight\",\n subsets: [\"latin\"],\n weight: [\"100\", \"200\", \"300\", \"400\", \"500\", \"600\", \"700\", \"800\", \"900\"],\n});",
|
||||||
|
"className": "${interTight.variable}",
|
||||||
|
"cssVariable": "font-family: var(--font-inter-tight), sans-serif;"
|
||||||
|
},
|
||||||
|
"inter": {
|
||||||
|
"name": "Inter",
|
||||||
|
"import": "import { Inter } from \"next/font/google\";",
|
||||||
|
"initialization": "const inter = Inter({\n variable: \"--font-inter\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"className": "${inter.variable}",
|
||||||
|
"cssVariable": "font-family: var(--font-inter), sans-serif;"
|
||||||
|
},
|
||||||
|
"poppins": {
|
||||||
|
"name": "Poppins",
|
||||||
|
"import": "import { Poppins } from \"next/font/google\";",
|
||||||
|
"initialization": "const poppins = Poppins({\n variable: \"--font-poppins\",\n subsets: [\"latin\"],\n weight: [\"100\", \"200\", \"300\", \"400\", \"500\", \"600\", \"700\", \"800\", \"900\"],\n});",
|
||||||
|
"className": "${poppins.variable}",
|
||||||
|
"cssVariable": "font-family: var(--font-poppins), sans-serif;"
|
||||||
|
},
|
||||||
|
"montserrat": {
|
||||||
|
"name": "Montserrat",
|
||||||
|
"import": "import { Montserrat } from \"next/font/google\";",
|
||||||
|
"initialization": "const montserrat = Montserrat({\n variable: \"--font-montserrat\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"className": "${montserrat.variable}",
|
||||||
|
"cssVariable": "font-family: var(--font-montserrat), sans-serif;"
|
||||||
|
},
|
||||||
|
"roboto": {
|
||||||
|
"name": "Roboto",
|
||||||
|
"import": "import { Roboto } from \"next/font/google\";",
|
||||||
|
"initialization": "const roboto = Roboto({\n variable: \"--font-roboto\",\n subsets: [\"latin\"],\n weight: [\"100\", \"300\", \"400\", \"500\", \"700\", \"900\"],\n});",
|
||||||
|
"className": "${roboto.variable}",
|
||||||
|
"cssVariable": "font-family: var(--font-roboto), sans-serif;"
|
||||||
|
},
|
||||||
|
"openSans": {
|
||||||
|
"name": "Open Sans",
|
||||||
|
"import": "import { Open_Sans } from \"next/font/google\";",
|
||||||
|
"initialization": "const openSans = Open_Sans({\n variable: \"--font-open-sans\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"className": "${openSans.variable}",
|
||||||
|
"cssVariable": "font-family: var(--font-open-sans), sans-serif;"
|
||||||
|
},
|
||||||
|
"lato": {
|
||||||
|
"name": "Lato",
|
||||||
|
"import": "import { Lato } from \"next/font/google\";",
|
||||||
|
"initialization": "const lato = Lato({\n variable: \"--font-lato\",\n subsets: [\"latin\"],\n weight: [\"100\", \"300\", \"400\", \"700\", \"900\"],\n});",
|
||||||
|
"className": "${lato.variable}",
|
||||||
|
"cssVariable": "font-family: var(--font-lato), sans-serif;"
|
||||||
|
},
|
||||||
|
"workSans": {
|
||||||
|
"name": "Work Sans",
|
||||||
|
"import": "import { Work_Sans } from \"next/font/google\";",
|
||||||
|
"initialization": "const workSans = Work_Sans({\n variable: \"--font-work-sans\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"className": "${workSans.variable}",
|
||||||
|
"cssVariable": "font-family: var(--font-work-sans), sans-serif;"
|
||||||
|
},
|
||||||
|
"dmSans": {
|
||||||
|
"name": "DM Sans",
|
||||||
|
"import": "import { DM_Sans } from \"next/font/google\";",
|
||||||
|
"initialization": "const dmSans = DM_Sans({\n variable: \"--font-dm-sans\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"className": "${dmSans.variable}",
|
||||||
|
"cssVariable": "font-family: var(--font-dm-sans), sans-serif;"
|
||||||
|
},
|
||||||
|
"plusJakartaSans": {
|
||||||
|
"name": "Plus Jakarta Sans",
|
||||||
|
"import": "import { Plus_Jakarta_Sans } from \"next/font/google\";",
|
||||||
|
"initialization": "const plusJakartaSans = Plus_Jakarta_Sans({\n variable: \"--font-plus-jakarta-sans\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"className": "${plusJakartaSans.variable}",
|
||||||
|
"cssVariable": "font-family: var(--font-plus-jakarta-sans), sans-serif;"
|
||||||
|
},
|
||||||
|
"manrope": {
|
||||||
|
"name": "Manrope",
|
||||||
|
"import": "import { Manrope } from \"next/font/google\";",
|
||||||
|
"initialization": "const manrope = Manrope({\n variable: \"--font-manrope\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"className": "${manrope.variable}",
|
||||||
|
"cssVariable": "font-family: var(--font-manrope), sans-serif;"
|
||||||
|
},
|
||||||
|
"rubik": {
|
||||||
|
"name": "Rubik",
|
||||||
|
"import": "import { Rubik } from \"next/font/google\";",
|
||||||
|
"initialization": "const rubik = Rubik({\n variable: \"--font-rubik\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"className": "${rubik.variable}",
|
||||||
|
"cssVariable": "font-family: var(--font-rubik), sans-serif;"
|
||||||
|
},
|
||||||
|
"sourceSans3": {
|
||||||
|
"name": "Source Sans 3",
|
||||||
|
"import": "import { Source_Sans_3 } from \"next/font/google\";",
|
||||||
|
"initialization": "const sourceSans3 = Source_Sans_3({\n variable: \"--font-source-sans-3\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"className": "${sourceSans3.variable}",
|
||||||
|
"cssVariable": "font-family: var(--font-source-sans-3), sans-serif;"
|
||||||
|
},
|
||||||
|
"cormorantGaramond": {
|
||||||
|
"name": "Cormorant Garamond",
|
||||||
|
"import": "import { Cormorant_Garamond } from \"next/font/google\";",
|
||||||
|
"initialization": "const cormorantGaramond = Cormorant_Garamond({\n variable: \"--font-cormorant-garamond\",\n subsets: [\"latin\"],\n weight: [\"300\", \"400\", \"500\", \"600\", \"700\"],\n});",
|
||||||
|
"className": "${cormorantGaramond.variable}",
|
||||||
|
"cssVariable": "font-family: var(--font-cormorant-garamond), serif;",
|
||||||
|
"category": "serif"
|
||||||
|
},
|
||||||
|
"lora": {
|
||||||
|
"name": "Lora",
|
||||||
|
"import": "import { Lora } from \"next/font/google\";",
|
||||||
|
"initialization": "const lora = Lora({\n variable: \"--font-lora\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"className": "${lora.variable}",
|
||||||
|
"cssVariable": "font-family: var(--font-lora), serif;",
|
||||||
|
"category": "serif"
|
||||||
|
},
|
||||||
|
"publicSans": {
|
||||||
|
"name": "Public Sans",
|
||||||
|
"import": "import { Public_Sans } from \"next/font/google\";",
|
||||||
|
"initialization": "const publicSans = Public_Sans({\n variable: \"--font-public-sans\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"className": "${publicSans.variable}",
|
||||||
|
"cssVariable": "font-family: var(--font-public-sans), sans-serif;"
|
||||||
|
},
|
||||||
|
"notoSans": {
|
||||||
|
"name": "Noto Sans",
|
||||||
|
"import": "import { Noto_Sans } from \"next/font/google\";",
|
||||||
|
"initialization": "const notoSans = Noto_Sans({\n variable: \"--font-noto-sans\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"className": "${notoSans.variable}",
|
||||||
|
"cssVariable": "font-family: var(--font-noto-sans), sans-serif;"
|
||||||
|
},
|
||||||
|
"mulish": {
|
||||||
|
"name": "Mulish",
|
||||||
|
"import": "import { Mulish } from \"next/font/google\";",
|
||||||
|
"initialization": "const mulish = Mulish({\n variable: \"--font-mulish\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"className": "${mulish.variable}",
|
||||||
|
"cssVariable": "font-family: var(--font-mulish), sans-serif;"
|
||||||
|
},
|
||||||
|
"ibmPlexSans": {
|
||||||
|
"name": "IBM Plex Sans",
|
||||||
|
"import": "import { IBM_Plex_Sans } from \"next/font/google\";",
|
||||||
|
"initialization": "const ibmPlexSans = IBM_Plex_Sans({\n variable: \"--font-ibm-plex-sans\",\n subsets: [\"latin\"],\n weight: [\"100\", \"200\", \"300\", \"400\", \"500\", \"600\", \"700\"],\n});",
|
||||||
|
"className": "${ibmPlexSans.variable}",
|
||||||
|
"cssVariable": "font-family: var(--font-ibm-plex-sans), sans-serif;"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"fontPairings": {
|
||||||
|
"interOpenSans": {
|
||||||
|
"name": "Inter + Open Sans",
|
||||||
|
"description": "Neutral headings with friendly body. Clean and approachable.",
|
||||||
|
"headingFont": "inter",
|
||||||
|
"bodyFont": "openSans",
|
||||||
|
"imports": "import { Inter } from \"next/font/google\";\nimport { Open_Sans } from \"next/font/google\";",
|
||||||
|
"initializations": "const inter = Inter({\n variable: \"--font-inter\",\n subsets: [\"latin\"],\n});\n\nconst openSans = Open_Sans({\n variable: \"--font-open-sans\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"classNames": "${inter.variable} ${openSans.variable}",
|
||||||
|
"globalsCss": {
|
||||||
|
"instructions": "Update the font-family property within the existing CSS rules in globals.css (@layer base section)",
|
||||||
|
"bodyRule": "body {\n /* ... existing properties ... */\n font-family: var(--font-open-sans), sans-serif;\n}",
|
||||||
|
"headingsRule": "h1, h2, h3, h4, h5, h6 {\n font-family: var(--font-inter), sans-serif;\n}",
|
||||||
|
"bodyFontFamily": "var(--font-open-sans), sans-serif",
|
||||||
|
"headingsFontFamily": "var(--font-inter), sans-serif"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"dmSansInter": {
|
||||||
|
"name": "DM Sans + Inter",
|
||||||
|
"description": "Modern geometric headings with neutral body. Contemporary and clean.",
|
||||||
|
"headingFont": "dmSans",
|
||||||
|
"bodyFont": "inter",
|
||||||
|
"imports": "import { DM_Sans } from \"next/font/google\";\nimport { Inter } from \"next/font/google\";",
|
||||||
|
"initializations": "const dmSans = DM_Sans({\n variable: \"--font-dm-sans\",\n subsets: [\"latin\"],\n});\n\nconst inter = Inter({\n variable: \"--font-inter\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"classNames": "${dmSans.variable} ${inter.variable}",
|
||||||
|
"globalsCss": {
|
||||||
|
"instructions": "Update the font-family property within the existing CSS rules in globals.css (@layer base section)",
|
||||||
|
"bodyRule": "body {\n /* ... existing properties ... */\n font-family: var(--font-inter), sans-serif;\n}",
|
||||||
|
"headingsRule": "h1, h2, h3, h4, h5, h6 {\n font-family: var(--font-dm-sans), sans-serif;\n}",
|
||||||
|
"bodyFontFamily": "var(--font-inter), sans-serif",
|
||||||
|
"headingsFontFamily": "var(--font-dm-sans), sans-serif"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"workSansSourceSans3": {
|
||||||
|
"name": "Work Sans + Source Sans 3",
|
||||||
|
"description": "Versatile headings with modern body. Professional and balanced.",
|
||||||
|
"headingFont": "workSans",
|
||||||
|
"bodyFont": "sourceSans3",
|
||||||
|
"imports": "import { Work_Sans } from \"next/font/google\";\nimport { Source_Sans_3 } from \"next/font/google\";",
|
||||||
|
"initializations": "const workSans = Work_Sans({\n variable: \"--font-work-sans\",\n subsets: [\"latin\"],\n});\n\nconst sourceSans3 = Source_Sans_3({\n variable: \"--font-source-sans-3\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"classNames": "${workSans.variable} ${sourceSans3.variable}",
|
||||||
|
"globalsCss": {
|
||||||
|
"instructions": "Update the font-family property within the existing CSS rules in globals.css (@layer base section)",
|
||||||
|
"bodyRule": "body {\n /* ... existing properties ... */\n font-family: var(--font-source-sans-3), sans-serif;\n}",
|
||||||
|
"headingsRule": "h1, h2, h3, h4, h5, h6 {\n font-family: var(--font-work-sans), sans-serif;\n}",
|
||||||
|
"bodyFontFamily": "var(--font-source-sans-3), sans-serif",
|
||||||
|
"headingsFontFamily": "var(--font-work-sans), sans-serif"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"manropeDmSans": {
|
||||||
|
"name": "Manrope + DM Sans",
|
||||||
|
"description": "Geometric headings with clean body. Modern and professional.",
|
||||||
|
"headingFont": "manrope",
|
||||||
|
"bodyFont": "dmSans",
|
||||||
|
"imports": "import { Manrope } from \"next/font/google\";\nimport { DM_Sans } from \"next/font/google\";",
|
||||||
|
"initializations": "const manrope = Manrope({\n variable: \"--font-manrope\",\n subsets: [\"latin\"],\n});\n\nconst dmSans = DM_Sans({\n variable: \"--font-dm-sans\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"classNames": "${manrope.variable} ${dmSans.variable}",
|
||||||
|
"globalsCss": {
|
||||||
|
"instructions": "Update the font-family property within the existing CSS rules in globals.css (@layer base section)",
|
||||||
|
"bodyRule": "body {\n /* ... existing properties ... */\n font-family: var(--font-dm-sans), sans-serif;\n}",
|
||||||
|
"headingsRule": "h1, h2, h3, h4, h5, h6 {\n font-family: var(--font-manrope), sans-serif;\n}",
|
||||||
|
"bodyFontFamily": "var(--font-dm-sans), sans-serif",
|
||||||
|
"headingsFontFamily": "var(--font-manrope), sans-serif"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"publicSansInter": {
|
||||||
|
"name": "Public Sans + Inter",
|
||||||
|
"description": "Government-inspired headings with neutral body. Professional and trustworthy.",
|
||||||
|
"headingFont": "publicSans",
|
||||||
|
"bodyFont": "inter",
|
||||||
|
"imports": "import { Public_Sans } from \"next/font/google\";\nimport { Inter } from \"next/font/google\";",
|
||||||
|
"initializations": "const publicSans = Public_Sans({\n variable: \"--font-public-sans\",\n subsets: [\"latin\"],\n});\n\nconst inter = Inter({\n variable: \"--font-inter\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"classNames": "${publicSans.variable} ${inter.variable}",
|
||||||
|
"globalsCss": {
|
||||||
|
"instructions": "Update the font-family property within the existing CSS rules in globals.css (@layer base section)",
|
||||||
|
"bodyRule": "body {\n /* ... existing properties ... */\n font-family: var(--font-inter), sans-serif;\n}",
|
||||||
|
"headingsRule": "h1, h2, h3, h4, h5, h6 {\n font-family: var(--font-public-sans), sans-serif;\n}",
|
||||||
|
"bodyFontFamily": "var(--font-inter), sans-serif",
|
||||||
|
"headingsFontFamily": "var(--font-public-sans), sans-serif"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"notoSansInter": {
|
||||||
|
"name": "Noto Sans + Inter",
|
||||||
|
"description": "Universal headings with neutral body. Global and accessible.",
|
||||||
|
"headingFont": "notoSans",
|
||||||
|
"bodyFont": "inter",
|
||||||
|
"imports": "import { Noto_Sans } from \"next/font/google\";\nimport { Inter } from \"next/font/google\";",
|
||||||
|
"initializations": "const notoSans = Noto_Sans({\n variable: \"--font-noto-sans\",\n subsets: [\"latin\"],\n});\n\nconst inter = Inter({\n variable: \"--font-inter\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"classNames": "${notoSans.variable} ${inter.variable}",
|
||||||
|
"globalsCss": {
|
||||||
|
"instructions": "Update the font-family property within the existing CSS rules in globals.css (@layer base section)",
|
||||||
|
"bodyRule": "body {\n /* ... existing properties ... */\n font-family: var(--font-inter), sans-serif;\n}",
|
||||||
|
"headingsRule": "h1, h2, h3, h4, h5, h6 {\n font-family: var(--font-noto-sans), sans-serif;\n}",
|
||||||
|
"bodyFontFamily": "var(--font-inter), sans-serif",
|
||||||
|
"headingsFontFamily": "var(--font-noto-sans), sans-serif"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"openSansWorkSans": {
|
||||||
|
"name": "Open Sans + Work Sans",
|
||||||
|
"description": "Friendly headings with versatile body. Approachable and balanced.",
|
||||||
|
"headingFont": "openSans",
|
||||||
|
"bodyFont": "workSans",
|
||||||
|
"imports": "import { Open_Sans } from \"next/font/google\";\nimport { Work_Sans } from \"next/font/google\";",
|
||||||
|
"initializations": "const openSans = Open_Sans({\n variable: \"--font-open-sans\",\n subsets: [\"latin\"],\n});\n\nconst workSans = Work_Sans({\n variable: \"--font-work-sans\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"classNames": "${openSans.variable} ${workSans.variable}",
|
||||||
|
"globalsCss": {
|
||||||
|
"instructions": "Update the font-family property within the existing CSS rules in globals.css (@layer base section)",
|
||||||
|
"bodyRule": "body {\n /* ... existing properties ... */\n font-family: var(--font-work-sans), sans-serif;\n}",
|
||||||
|
"headingsRule": "h1, h2, h3, h4, h5, h6 {\n font-family: var(--font-open-sans), sans-serif;\n}",
|
||||||
|
"bodyFontFamily": "var(--font-work-sans), sans-serif",
|
||||||
|
"headingsFontFamily": "var(--font-open-sans), sans-serif"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"mulishInter": {
|
||||||
|
"name": "Mulish + Inter",
|
||||||
|
"description": "Minimal headings with neutral body. Clean and modern.",
|
||||||
|
"headingFont": "mulish",
|
||||||
|
"bodyFont": "inter",
|
||||||
|
"imports": "import { Mulish } from \"next/font/google\";\nimport { Inter } from \"next/font/google\";",
|
||||||
|
"initializations": "const mulish = Mulish({\n variable: \"--font-mulish\",\n subsets: [\"latin\"],\n});\n\nconst inter = Inter({\n variable: \"--font-inter\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"classNames": "${mulish.variable} ${inter.variable}",
|
||||||
|
"globalsCss": {
|
||||||
|
"instructions": "Update the font-family property within the existing CSS rules in globals.css (@layer base section)",
|
||||||
|
"bodyRule": "body {\n /* ... existing properties ... */\n font-family: var(--font-inter), sans-serif;\n}",
|
||||||
|
"headingsRule": "h1, h2, h3, h4, h5, h6 {\n font-family: var(--font-mulish), sans-serif;\n}",
|
||||||
|
"bodyFontFamily": "var(--font-inter), sans-serif",
|
||||||
|
"headingsFontFamily": "var(--font-mulish), sans-serif"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"plusJakartaSansInter": {
|
||||||
|
"name": "Plus Jakarta Sans + Inter",
|
||||||
|
"description": "Friendly rounded headings with neutral body. Approachable and modern.",
|
||||||
|
"headingFont": "plusJakartaSans",
|
||||||
|
"bodyFont": "inter",
|
||||||
|
"imports": "import { Plus_Jakarta_Sans } from \"next/font/google\";\nimport { Inter } from \"next/font/google\";",
|
||||||
|
"initializations": "const plusJakartaSans = Plus_Jakarta_Sans({\n variable: \"--font-plus-jakarta-sans\",\n subsets: [\"latin\"],\n});\n\nconst inter = Inter({\n variable: \"--font-inter\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"classNames": "${plusJakartaSans.variable} ${inter.variable}",
|
||||||
|
"globalsCss": {
|
||||||
|
"instructions": "Update the font-family property within the existing CSS rules in globals.css (@layer base section)",
|
||||||
|
"bodyRule": "body {\n /* ... existing properties ... */\n font-family: var(--font-inter), sans-serif;\n}",
|
||||||
|
"headingsRule": "h1, h2, h3, h4, h5, h6 {\n font-family: var(--font-plus-jakarta-sans), sans-serif;\n}",
|
||||||
|
"bodyFontFamily": "var(--font-inter), sans-serif",
|
||||||
|
"headingsFontFamily": "var(--font-plus-jakarta-sans), sans-serif"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"montserratInter": {
|
||||||
|
"name": "Montserrat + Inter",
|
||||||
|
"description": "Geometric sans-serif headings with neutral body. Popular and reliable.",
|
||||||
|
"headingFont": "montserrat",
|
||||||
|
"bodyFont": "inter",
|
||||||
|
"imports": "import { Montserrat } from \"next/font/google\";\nimport { Inter } from \"next/font/google\";",
|
||||||
|
"initializations": "const montserrat = Montserrat({\n variable: \"--font-montserrat\",\n subsets: [\"latin\"],\n});\n\nconst inter = Inter({\n variable: \"--font-inter\",\n subsets: [\"latin\"],\n});",
|
||||||
|
"classNames": "${montserrat.variable} ${inter.variable}",
|
||||||
|
"globalsCss": {
|
||||||
|
"instructions": "Update the font-family property within the existing CSS rules in globals.css (@layer base section)",
|
||||||
|
"bodyRule": "body {\n /* ... existing properties ... */\n font-family: var(--font-inter), sans-serif;\n}",
|
||||||
|
"headingsRule": "h1, h2, h3, h4, h5, h6 {\n font-family: var(--font-montserrat), sans-serif;\n}",
|
||||||
|
"bodyFontFamily": "var(--font-inter), sans-serif",
|
||||||
|
"headingsFontFamily": "var(--font-montserrat), sans-serif"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
26
next.config.ts
Normal file
@@ -0,0 +1,26 @@
|
|||||||
|
import type { NextConfig } from "next";
|
||||||
|
|
||||||
|
const nextConfig: NextConfig = {
|
||||||
|
devIndicators: false,
|
||||||
|
experimental: {
|
||||||
|
serverComponentsHmrCache: false,
|
||||||
|
},
|
||||||
|
images: {
|
||||||
|
remotePatterns: [
|
||||||
|
{
|
||||||
|
protocol: 'https',
|
||||||
|
hostname: 'webuild-dev.s3.eu-north-1.amazonaws.com',
|
||||||
|
},
|
||||||
|
{
|
||||||
|
protocol: 'https',
|
||||||
|
hostname: 'img.b2bpic.net',
|
||||||
|
},
|
||||||
|
{
|
||||||
|
protocol: 'https',
|
||||||
|
hostname: 'freepik.com',
|
||||||
|
},
|
||||||
|
],
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
export default nextConfig;
|
||||||
8299
package-lock.json
generated
Normal file
46
package.json
Normal file
@@ -0,0 +1,46 @@
|
|||||||
|
{
|
||||||
|
"name": "webild-components-2",
|
||||||
|
"version": "0.1.0",
|
||||||
|
"private": true,
|
||||||
|
"scripts": {
|
||||||
|
"dev": "next dev --turbopack",
|
||||||
|
"build": "next build --turbopack",
|
||||||
|
"typecheck": "tsc --noEmit",
|
||||||
|
"lint": "eslint . --ext .ts,.tsx",
|
||||||
|
"start": "next start"
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"@gsap/react": "^2.1.2",
|
||||||
|
"@react-three/drei": "^10.7.7",
|
||||||
|
"@react-three/fiber": "^9.4.0",
|
||||||
|
"@tsparticles/engine": "^3.9.1",
|
||||||
|
"@tsparticles/react": "^3.0.0",
|
||||||
|
"@tsparticles/slim": "^3.9.1",
|
||||||
|
"clsx": "^2.1.1",
|
||||||
|
"cobe": "^0.6.5",
|
||||||
|
"embla-carousel-auto-scroll": "^8.6.0",
|
||||||
|
"embla-carousel-react": "^8.6.0",
|
||||||
|
"gsap": "^3.13.0",
|
||||||
|
"lenis": "^1.3.15",
|
||||||
|
"lucide-react": "^0.555.0",
|
||||||
|
"motion-number": "^1.0.0",
|
||||||
|
"next": "16.0.7",
|
||||||
|
"react": "19.2.1",
|
||||||
|
"react-dom": "19.2.1",
|
||||||
|
"react-fast-marquee": "^1.6.5",
|
||||||
|
"recharts": "^3.6.0",
|
||||||
|
"tailwind-merge": "^3.4.0",
|
||||||
|
"three": "^0.181.2"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"@eslint/eslintrc": "^3",
|
||||||
|
"@tailwindcss/postcss": "^4",
|
||||||
|
"@types/node": "^20",
|
||||||
|
"@types/react": "^19",
|
||||||
|
"@types/react-dom": "^19",
|
||||||
|
"eslint": "^9",
|
||||||
|
"eslint-config-next": "16.0.7",
|
||||||
|
"tailwindcss": "^4",
|
||||||
|
"typescript": "^5"
|
||||||
|
}
|
||||||
|
}
|
||||||
5
postcss.config.mjs
Normal file
@@ -0,0 +1,5 @@
|
|||||||
|
const config = {
|
||||||
|
plugins: ["@tailwindcss/postcss"],
|
||||||
|
};
|
||||||
|
|
||||||
|
export default config;
|
||||||
BIN
public/audio/click.mp3
Normal file
BIN
public/base/bg-texture.avif
Normal file
|
After Width: | Height: | Size: 15 KiB |
52
public/brand/logo-dot.svg
Normal file
@@ -0,0 +1,52 @@
|
|||||||
|
<svg width="7" height="7" viewBox="0 0 7 7" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||||
|
<g filter="url(#filter0_f_1295_3221)">
|
||||||
|
<ellipse cx="3.59341" cy="3.53052" rx="1.8861" ry="1.90568" transform="rotate(25.4025 3.59341 3.53052)" fill="url(#paint0_linear_1295_3221)"/>
|
||||||
|
</g>
|
||||||
|
<g filter="url(#filter1_f_1295_3221)">
|
||||||
|
<circle cx="3.69632" cy="3.86088" r="1.65146" transform="rotate(25.4025 3.69632 3.86088)" fill="url(#paint1_linear_1295_3221)"/>
|
||||||
|
</g>
|
||||||
|
<g filter="url(#filter2_f_1295_3221)">
|
||||||
|
<circle cx="3.69633" cy="3.86069" r="1.65146" transform="rotate(-169.598 3.69633 3.86069)" fill="url(#paint2_linear_1295_3221)"/>
|
||||||
|
</g>
|
||||||
|
<g filter="url(#filter3_f_1295_3221)">
|
||||||
|
<circle cx="3.74882" cy="3.91343" r="1.65146" transform="rotate(-169.598 3.74882 3.91343)" fill="url(#paint3_linear_1295_3221)"/>
|
||||||
|
</g>
|
||||||
|
<defs>
|
||||||
|
<filter id="filter0_f_1295_3221" x="1.25185" y="1.17653" width="4.68307" height="4.70798" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
|
||||||
|
<feFlood flood-opacity="0" result="BackgroundImageFix"/>
|
||||||
|
<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
|
||||||
|
<feGaussianBlur stdDeviation="0" result="effect1_foregroundBlur_1295_3221"/>
|
||||||
|
</filter>
|
||||||
|
<filter id="filter1_f_1295_3221" x="0.569126" y="0.733676" width="6.25433" height="6.25433" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
|
||||||
|
<feFlood flood-opacity="0" result="BackgroundImageFix"/>
|
||||||
|
<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
|
||||||
|
<feGaussianBlur stdDeviation="0" result="effect1_foregroundBlur_1295_3221"/>
|
||||||
|
</filter>
|
||||||
|
<filter id="filter2_f_1295_3221" x="1.16377" y="1.3282" width="5.06515" height="5.06478" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
|
||||||
|
<feFlood flood-opacity="0" result="BackgroundImageFix"/>
|
||||||
|
<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
|
||||||
|
<feGaussianBlur stdDeviation="0.0330293" result="effect1_foregroundBlur_1295_3221"/>
|
||||||
|
</filter>
|
||||||
|
<filter id="filter3_f_1295_3221" x="0.687796" y="0.852469" width="6.12209" height="6.12172" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
|
||||||
|
<feFlood flood-opacity="0" result="BackgroundImageFix"/>
|
||||||
|
<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
|
||||||
|
<feGaussianBlur stdDeviation="0.704625" result="effect1_foregroundBlur_1295_3221"/>
|
||||||
|
</filter>
|
||||||
|
<linearGradient id="paint0_linear_1295_3221" x1="3.68116" y1="3.8564" x2="5.08951" y2="5.37639" gradientUnits="userSpaceOnUse">
|
||||||
|
<stop stop-color="#0F3DA6"/>
|
||||||
|
<stop offset="0.951923" stop-color="#3A9AFF" stop-opacity="0"/>
|
||||||
|
</linearGradient>
|
||||||
|
<linearGradient id="paint1_linear_1295_3221" x1="2.5674" y1="3.78948" x2="3.91229" y2="5.46656" gradientUnits="userSpaceOnUse">
|
||||||
|
<stop offset="0.00961538" stop-color="#0D50E8"/>
|
||||||
|
<stop offset="0.951923" stop-color="#3A9AFF" stop-opacity="0"/>
|
||||||
|
</linearGradient>
|
||||||
|
<linearGradient id="paint2_linear_1295_3221" x1="5.38038" y1="5.11694" x2="2.76523" y2="1.84712" gradientUnits="userSpaceOnUse">
|
||||||
|
<stop stop-color="#0F3DA6" stop-opacity="0"/>
|
||||||
|
<stop offset="1" stop-color="#59ABFF"/>
|
||||||
|
</linearGradient>
|
||||||
|
<linearGradient id="paint3_linear_1295_3221" x1="5.43287" y1="5.16968" x2="4.3403" y2="2.57182" gradientUnits="userSpaceOnUse">
|
||||||
|
<stop stop-color="#0F3DA6" stop-opacity="0"/>
|
||||||
|
<stop offset="1" stop-color="#59ABFF"/>
|
||||||
|
</linearGradient>
|
||||||
|
</defs>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 3.3 KiB |
74
public/brand/logo.svg
Normal file
@@ -0,0 +1,74 @@
|
|||||||
|
<svg width="67" height="21" viewBox="0 0 67 21" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||||
|
<path d="M26.4375 7.16162C28.1869 7.16171 29.6159 7.78044 30.6064 8.88428C31.5956 9.98684 32.1387 11.5637 32.1387 13.4653V14.4478H23.374V14.4917C23.3742 15.5488 23.6921 16.4168 24.249 17.019C24.8052 17.6203 25.6093 17.9673 26.6025 17.9673C28.0159 17.9672 29.0384 17.2571 29.3633 16.228L29.3877 16.1509H32.0156L31.9961 16.2778C31.6314 18.6096 29.4248 20.2515 26.543 20.2515C24.6949 20.2514 23.2009 19.6255 22.1699 18.4937C21.1401 17.3628 20.5822 15.7381 20.582 13.7603C20.582 11.7937 21.1488 10.1435 22.168 8.98389C23.1888 7.82281 24.6569 7.16165 26.4375 7.16162ZM36.1025 9.28955C36.8971 7.97245 38.2815 7.18506 39.9678 7.18506C41.5623 7.18515 42.8859 7.81845 43.8086 8.95557C44.7294 10.0905 45.2441 11.7187 45.2441 13.7007C45.2441 15.6882 44.7324 17.3191 43.8115 18.4556C42.8887 19.5944 41.5621 20.2279 39.9561 20.228C38.2187 20.228 36.8448 19.4336 36.0312 18.1226V20.0151H33.334V2.77295H36.1025V9.28955ZM67 20.0151H64.3027V18.1284C63.5158 19.417 62.1356 20.228 60.4141 20.228C58.8134 20.228 57.4778 19.588 56.5449 18.4468C55.614 17.3077 55.0899 15.677 55.0898 13.7007C55.0898 11.7241 55.6138 10.0956 56.542 8.95947C57.4719 7.82125 58.8017 7.18506 60.3906 7.18506C62.0846 7.18514 63.4609 7.98063 64.2207 9.2251V2.77295H67V20.0151ZM2.99902 2.85791L6.0918 15.9497L9.62793 2.85498L9.64941 2.77295H12.2715L12.2939 2.85498L15.8398 15.9507L18.9336 2.85791L18.9541 2.77295H21.9336L21.8955 2.91162L17.2949 19.9341L17.2734 20.0151H14.6172L14.5938 19.9351L10.9609 7.26416L7.33887 19.9351L7.31641 20.0151H4.64746L4.62598 19.9341L0.0371094 2.91162L0 2.77295H2.97949L2.99902 2.85791ZM53.9062 20.0151H51.1377V2.77295H53.9062V20.0151ZM49.0352 19.9839H46.2666V7.354H49.0352V19.9839ZM60.9092 17.9536C60.9674 17.9566 61.0263 17.9585 61.0859 17.9585V17.9575L60.9092 17.9536ZM60.6924 17.9351C60.7503 17.9417 60.8088 17.947 60.8682 17.9507C60.8088 17.947 60.7503 17.9417 60.6924 17.9351ZM60.4434 17.8979C60.5109 17.911 60.5797 17.9212 60.6494 17.9302C60.5797 17.9212 60.5109 17.911 60.4434 17.8979ZM39.2715 9.55225C38.3397 9.55229 37.5483 9.96027 36.9873 10.6792C36.4249 11.4002 36.0908 12.4394 36.0908 13.7007C36.0909 14.9739 36.425 16.0131 36.9873 16.731C37.548 17.4465 38.3393 17.8491 39.2715 17.8491C40.2407 17.8491 41.0189 17.4568 41.5576 16.7495C42.0989 16.0387 42.4052 15 42.4053 13.7007C42.4053 12.4132 42.0991 11.3737 41.5576 10.6597C41.0186 9.94925 40.2402 9.5523 39.2715 9.55225ZM61.0869 9.55225C60.1117 9.55225 59.3237 9.94972 58.7773 10.6606C58.2287 11.3747 57.917 12.4136 57.917 13.7007C57.917 14.9937 58.2288 16.0322 58.7773 16.7446C59.3236 17.454 60.1115 17.8491 61.0869 17.8491C62.0312 17.849 62.8158 17.449 63.3672 16.7358C63.9205 16.0199 64.2441 14.9807 64.2441 13.7007C64.2441 12.4325 63.9207 11.3935 63.3672 10.6743C62.8155 9.95775 62.0308 9.55241 61.0869 9.55225ZM41.2676 17.2271C41.3209 17.1788 41.3736 17.1293 41.4238 17.0767L41.4307 17.0688C41.3782 17.1242 41.3235 17.1766 41.2676 17.2271ZM57.8643 14.6216C57.8776 14.7252 57.8932 14.8268 57.9111 14.9263C57.8933 14.8268 57.8775 14.7252 57.8643 14.6216ZM57.8066 13.7007C57.8067 14.0028 57.8244 14.2919 57.8574 14.5669C57.8424 14.4409 57.8305 14.312 57.8223 14.1802L57.8076 13.7007C57.8076 13.6621 57.809 13.6237 57.8096 13.5854C57.809 13.6237 57.8066 13.6621 57.8066 13.7007ZM45.1035 14.5063C45.1121 14.3932 45.1182 14.2786 45.123 14.1626C45.1182 14.2786 45.112 14.3932 45.1035 14.5063ZM45.1338 13.7007C45.1338 13.8433 45.1302 13.9839 45.125 14.1226C45.1257 14.1037 45.1283 14.0849 45.1289 14.0659L45.1348 13.7007C45.1348 13.5487 45.1312 13.399 45.125 13.2515L45.1338 13.7007ZM57.8242 13.2104C57.8213 13.2551 57.8185 13.3 57.8164 13.3452C57.8185 13.3 57.8213 13.2551 57.8242 13.2104ZM57.8555 12.8501C57.8514 12.8844 57.8483 12.9189 57.8447 12.9536C57.8483 12.9189 57.8514 12.8844 57.8555 12.8501ZM57.9346 12.3618C57.9223 12.423 57.909 12.4846 57.8984 12.5474C57.909 12.4846 57.9223 12.423 57.9346 12.3618ZM26.4375 9.43506C24.7618 9.43512 23.5679 10.68 23.3984 12.4468H29.3623C29.3129 11.5693 29.0132 10.8288 28.5244 10.3032C28.0155 9.75613 27.2989 9.43515 26.4375 9.43506ZM57.999 12.0737C57.9868 12.1214 57.975 12.1695 57.9639 12.2183C57.975 12.1695 57.9868 12.1214 57.999 12.0737ZM58.1367 11.6313C58.1073 11.7129 58.0784 11.7959 58.0527 11.8813C58.0784 11.7959 58.1073 11.7129 58.1367 11.6313ZM58.2197 11.4146C58.204 11.4519 58.1887 11.4896 58.1738 11.5278C58.1887 11.4896 58.204 11.4519 58.2197 11.4146ZM58.3633 11.1089C58.3476 11.1388 58.3324 11.1691 58.3174 11.1997C58.3324 11.1691 58.3476 11.1388 58.3633 11.1089ZM58.9629 10.2827C58.8665 10.3786 58.7757 10.4823 58.6904 10.5933L58.7998 10.4595C58.8524 10.3981 58.9065 10.3388 58.9629 10.2827ZM59.5752 9.81885C59.3611 9.93932 59.164 10.0873 58.9854 10.2612C59.0426 10.2054 59.1021 10.1525 59.1631 10.1021C59.2493 10.0308 59.3391 9.96501 59.4326 9.90479C59.4793 9.87472 59.5268 9.84615 59.5752 9.81885ZM26.2725 9.32861C26.327 9.326 26.382 9.32471 26.4375 9.32471L26.5312 9.32666C26.5002 9.32581 26.4689 9.32373 26.4375 9.32373C26.382 9.32373 26.3269 9.32601 26.2725 9.32861Z" fill="black"/>
|
||||||
|
<mask id="mask0_1119_6721" style="mask-type:alpha" maskUnits="userSpaceOnUse" x="0" y="2" width="67" height="19">
|
||||||
|
<path d="M26.4375 7.16162C28.1869 7.16171 29.6159 7.78044 30.6064 8.88428C31.5956 9.98684 32.1387 11.5637 32.1387 13.4653V14.4478H23.374V14.4917C23.3742 15.5488 23.6921 16.4168 24.249 17.019C24.8052 17.6203 25.6093 17.9673 26.6025 17.9673C28.0159 17.9672 29.0384 17.2571 29.3633 16.228L29.3877 16.1509H32.0156L31.9961 16.2778C31.6314 18.6096 29.4248 20.2515 26.543 20.2515C24.6949 20.2514 23.2009 19.6255 22.1699 18.4937C21.1401 17.3628 20.5822 15.7381 20.582 13.7603C20.582 11.7937 21.1488 10.1435 22.168 8.98389C23.1888 7.82281 24.6569 7.16165 26.4375 7.16162ZM36.1025 9.28955C36.8971 7.97245 38.2815 7.18506 39.9678 7.18506C41.5623 7.18515 42.8859 7.81845 43.8086 8.95557C44.7294 10.0905 45.2441 11.7187 45.2441 13.7007C45.2441 15.6882 44.7324 17.3191 43.8115 18.4556C42.8887 19.5944 41.5621 20.2279 39.9561 20.228C38.2187 20.228 36.8448 19.4336 36.0312 18.1226V20.0151H33.334V2.77295H36.1025V9.28955ZM67 20.0151H64.3027V18.1284C63.5158 19.417 62.1356 20.228 60.4141 20.228C58.8134 20.228 57.4778 19.588 56.5449 18.4468C55.614 17.3077 55.0899 15.677 55.0898 13.7007C55.0898 11.7241 55.6138 10.0956 56.542 8.95947C57.4719 7.82125 58.8017 7.18506 60.3906 7.18506C62.0846 7.18514 63.4609 7.98063 64.2207 9.2251V2.77295H67V20.0151ZM2.99902 2.85791L6.0918 15.9497L9.62793 2.85498L9.64941 2.77295H12.2715L12.2939 2.85498L15.8398 15.9507L18.9336 2.85791L18.9541 2.77295H21.9336L21.8955 2.91162L17.2949 19.9341L17.2734 20.0151H14.6172L14.5938 19.9351L10.9609 7.26416L7.33887 19.9351L7.31641 20.0151H4.64746L4.62598 19.9341L0.0371094 2.91162L0 2.77295H2.97949L2.99902 2.85791ZM53.9062 20.0151H51.1377V2.77295H53.9062V20.0151ZM49.0352 19.9839H46.2666V7.354H49.0352V19.9839ZM60.9092 17.9536C60.9674 17.9566 61.0263 17.9585 61.0859 17.9585V17.9575L60.9092 17.9536ZM60.6924 17.9351C60.7503 17.9417 60.8088 17.947 60.8682 17.9507C60.8088 17.947 60.7503 17.9417 60.6924 17.9351ZM60.4434 17.8979C60.5109 17.911 60.5797 17.9212 60.6494 17.9302C60.5797 17.9212 60.5109 17.911 60.4434 17.8979ZM39.2715 9.55225C38.3397 9.55229 37.5483 9.96027 36.9873 10.6792C36.4249 11.4002 36.0908 12.4394 36.0908 13.7007C36.0909 14.9739 36.425 16.0131 36.9873 16.731C37.548 17.4465 38.3393 17.8491 39.2715 17.8491C40.2407 17.8491 41.0189 17.4568 41.5576 16.7495C42.0989 16.0387 42.4052 15 42.4053 13.7007C42.4053 12.4132 42.0991 11.3737 41.5576 10.6597C41.0186 9.94925 40.2402 9.5523 39.2715 9.55225ZM61.0869 9.55225C60.1117 9.55225 59.3237 9.94972 58.7773 10.6606C58.2287 11.3747 57.917 12.4136 57.917 13.7007C57.917 14.9937 58.2288 16.0322 58.7773 16.7446C59.3236 17.454 60.1115 17.8491 61.0869 17.8491C62.0312 17.849 62.8158 17.449 63.3672 16.7358C63.9205 16.0199 64.2441 14.9807 64.2441 13.7007C64.2441 12.4325 63.9207 11.3935 63.3672 10.6743C62.8155 9.95775 62.0308 9.55241 61.0869 9.55225ZM41.2676 17.2271C41.3209 17.1788 41.3736 17.1293 41.4238 17.0767L41.4307 17.0688C41.3782 17.1242 41.3235 17.1766 41.2676 17.2271ZM57.8643 14.6216C57.8776 14.7252 57.8932 14.8268 57.9111 14.9263C57.8933 14.8268 57.8775 14.7252 57.8643 14.6216ZM57.8066 13.7007C57.8067 14.0028 57.8244 14.2919 57.8574 14.5669C57.8424 14.4409 57.8305 14.312 57.8223 14.1802L57.8076 13.7007C57.8076 13.6621 57.809 13.6237 57.8096 13.5854C57.809 13.6237 57.8066 13.6621 57.8066 13.7007ZM45.1035 14.5063C45.1121 14.3932 45.1182 14.2786 45.123 14.1626C45.1182 14.2786 45.112 14.3932 45.1035 14.5063ZM45.1338 13.7007C45.1338 13.8433 45.1302 13.9839 45.125 14.1226C45.1257 14.1037 45.1283 14.0849 45.1289 14.0659L45.1348 13.7007C45.1348 13.5487 45.1312 13.399 45.125 13.2515L45.1338 13.7007ZM57.8242 13.2104C57.8213 13.2551 57.8185 13.3 57.8164 13.3452C57.8185 13.3 57.8213 13.2551 57.8242 13.2104ZM57.8555 12.8501C57.8514 12.8844 57.8483 12.9189 57.8447 12.9536C57.8483 12.9189 57.8514 12.8844 57.8555 12.8501ZM57.9346 12.3618C57.9223 12.423 57.909 12.4846 57.8984 12.5474C57.909 12.4846 57.9223 12.423 57.9346 12.3618ZM26.4375 9.43506C24.7618 9.43512 23.5679 10.68 23.3984 12.4468H29.3623C29.3129 11.5693 29.0132 10.8288 28.5244 10.3032C28.0155 9.75613 27.2989 9.43515 26.4375 9.43506ZM57.999 12.0737C57.9868 12.1214 57.975 12.1695 57.9639 12.2183C57.975 12.1695 57.9868 12.1214 57.999 12.0737ZM58.1367 11.6313C58.1073 11.7129 58.0784 11.7959 58.0527 11.8813C58.0784 11.7959 58.1073 11.7129 58.1367 11.6313ZM58.2197 11.4146C58.204 11.4519 58.1887 11.4896 58.1738 11.5278C58.1887 11.4896 58.204 11.4519 58.2197 11.4146ZM58.3633 11.1089C58.3476 11.1388 58.3324 11.1691 58.3174 11.1997C58.3324 11.1691 58.3476 11.1388 58.3633 11.1089ZM58.9629 10.2827C58.8665 10.3786 58.7757 10.4823 58.6904 10.5933L58.7998 10.4595C58.8524 10.3981 58.9065 10.3388 58.9629 10.2827ZM59.5752 9.81885C59.3611 9.93932 59.164 10.0873 58.9854 10.2612C59.0426 10.2054 59.1021 10.1525 59.1631 10.1021C59.2493 10.0308 59.3391 9.96501 59.4326 9.90479C59.4793 9.87472 59.5268 9.84615 59.5752 9.81885ZM26.2725 9.32861C26.327 9.326 26.382 9.32471 26.4375 9.32471L26.5312 9.32666C26.5002 9.32581 26.4689 9.32373 26.4375 9.32373C26.382 9.32373 26.3269 9.32601 26.2725 9.32861Z" fill="black"/>
|
||||||
|
</mask>
|
||||||
|
<g mask="url(#mask0_1119_6721)">
|
||||||
|
<g opacity="0.17" filter="url(#filter0_f_1119_6721)">
|
||||||
|
<path d="M36.1377 2.6198H32.5596L42.4684 -6.4082L54.7993 -5.08703L62.8915 -1.34371L55.57 3.39048C54.469 3.18864 52.1459 2.90606 51.6615 3.39048C51.056 3.99602 51.056 5.64749 50.8908 6.91361C50.7587 7.92651 49.8082 7.84944 49.3495 7.68429L46.4319 8.12468L45.5511 12.4185C45.3125 12.2533 44.6813 11.5707 44.0648 10.1615C43.2941 8.39993 42.3032 7.84944 40.7068 7.68429C39.4297 7.55217 36.78 8.47332 36.1377 8.78527V2.6198Z" fill="#0597FF"/>
|
||||||
|
</g>
|
||||||
|
<g filter="url(#filter1_f_1119_6721)">
|
||||||
|
<path d="M36.1377 2.6198H32.5596L42.4684 -6.4082L54.7993 -5.08703L62.8915 -1.34371L55.57 3.39048C54.469 3.18864 52.1459 2.90606 51.6615 3.39048C51.056 3.99602 51.056 5.64749 50.8908 6.91361C50.7587 7.92651 49.8082 7.84944 49.3495 7.68429L46.4319 8.12468L45.5511 12.4185C45.3125 12.2533 44.6813 11.5707 44.0648 10.1615C43.2941 8.39993 42.3032 7.84944 40.7068 7.68429C39.4297 7.55217 36.78 8.47332 36.1377 8.78527V2.6198Z" fill="#0597FF"/>
|
||||||
|
</g>
|
||||||
|
</g>
|
||||||
|
<g filter="url(#filter2_f_1119_6721)">
|
||||||
|
<ellipse cx="47.5933" cy="3.27857" rx="1.8861" ry="1.90568" transform="rotate(25.4025 47.5933 3.27857)" fill="url(#paint0_linear_1119_6721)"/>
|
||||||
|
</g>
|
||||||
|
<g filter="url(#filter3_f_1119_6721)">
|
||||||
|
<circle cx="47.6964" cy="3.60892" r="1.65146" transform="rotate(25.4025 47.6964 3.60892)" fill="url(#paint1_linear_1119_6721)"/>
|
||||||
|
</g>
|
||||||
|
<g filter="url(#filter4_f_1119_6721)">
|
||||||
|
<circle cx="47.6963" cy="3.60874" r="1.65146" transform="rotate(-169.598 47.6963 3.60874)" fill="url(#paint2_linear_1119_6721)"/>
|
||||||
|
</g>
|
||||||
|
<g filter="url(#filter5_f_1119_6721)">
|
||||||
|
<circle cx="47.7491" cy="3.66147" r="1.65146" transform="rotate(-169.598 47.7491 3.66147)" fill="url(#paint3_linear_1119_6721)"/>
|
||||||
|
</g>
|
||||||
|
<defs>
|
||||||
|
<filter id="filter0_f_1119_6721" x="31.2494" y="-7.71836" width="32.9524" height="21.447" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
|
||||||
|
<feFlood flood-opacity="0" result="BackgroundImageFix"/>
|
||||||
|
<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
|
||||||
|
<feGaussianBlur stdDeviation="0.655081" result="effect1_foregroundBlur_1119_6721"/>
|
||||||
|
</filter>
|
||||||
|
<filter id="filter1_f_1119_6721" x="27.1648" y="-11.803" width="41.1216" height="29.6162" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
|
||||||
|
<feFlood flood-opacity="0" result="BackgroundImageFix"/>
|
||||||
|
<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
|
||||||
|
<feGaussianBlur stdDeviation="2.69739" result="effect1_foregroundBlur_1119_6721"/>
|
||||||
|
</filter>
|
||||||
|
<filter id="filter2_f_1119_6721" x="45.2517" y="0.924576" width="4.68307" height="4.70798" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
|
||||||
|
<feFlood flood-opacity="0" result="BackgroundImageFix"/>
|
||||||
|
<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
|
||||||
|
<feGaussianBlur stdDeviation="0" result="effect1_foregroundBlur_1119_6721"/>
|
||||||
|
</filter>
|
||||||
|
<filter id="filter3_f_1119_6721" x="44.5691" y="0.481723" width="6.25433" height="6.25433" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
|
||||||
|
<feFlood flood-opacity="0" result="BackgroundImageFix"/>
|
||||||
|
<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
|
||||||
|
<feGaussianBlur stdDeviation="0" result="effect1_foregroundBlur_1119_6721"/>
|
||||||
|
</filter>
|
||||||
|
<filter id="filter4_f_1119_6721" x="45.1637" y="1.07625" width="5.06527" height="5.06478" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
|
||||||
|
<feFlood flood-opacity="0" result="BackgroundImageFix"/>
|
||||||
|
<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
|
||||||
|
<feGaussianBlur stdDeviation="0.0330293" result="effect1_foregroundBlur_1119_6721"/>
|
||||||
|
</filter>
|
||||||
|
<filter id="filter5_f_1119_6721" x="44.6879" y="0.600516" width="6.12221" height="6.12172" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
|
||||||
|
<feFlood flood-opacity="0" result="BackgroundImageFix"/>
|
||||||
|
<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
|
||||||
|
<feGaussianBlur stdDeviation="0.704625" result="effect1_foregroundBlur_1119_6721"/>
|
||||||
|
</filter>
|
||||||
|
<linearGradient id="paint0_linear_1119_6721" x1="47.681" y1="3.60445" x2="49.0894" y2="5.12444" gradientUnits="userSpaceOnUse">
|
||||||
|
<stop stop-color="#0F3DA6"/>
|
||||||
|
<stop offset="0.951923" stop-color="#3A9AFF" stop-opacity="0"/>
|
||||||
|
</linearGradient>
|
||||||
|
<linearGradient id="paint1_linear_1119_6721" x1="46.5675" y1="3.53753" x2="47.9124" y2="5.21461" gradientUnits="userSpaceOnUse">
|
||||||
|
<stop offset="0.00961538" stop-color="#0D50E8"/>
|
||||||
|
<stop offset="0.951923" stop-color="#3A9AFF" stop-opacity="0"/>
|
||||||
|
</linearGradient>
|
||||||
|
<linearGradient id="paint2_linear_1119_6721" x1="49.3804" y1="4.86499" x2="46.7652" y2="1.59517" gradientUnits="userSpaceOnUse">
|
||||||
|
<stop stop-color="#0F3DA6" stop-opacity="0"/>
|
||||||
|
<stop offset="1" stop-color="#59ABFF"/>
|
||||||
|
</linearGradient>
|
||||||
|
<linearGradient id="paint3_linear_1119_6721" x1="49.4331" y1="4.91773" x2="48.3405" y2="2.31986" gradientUnits="userSpaceOnUse">
|
||||||
|
<stop stop-color="#0F3DA6" stop-opacity="0"/>
|
||||||
|
<stop offset="1" stop-color="#59ABFF"/>
|
||||||
|
</linearGradient>
|
||||||
|
</defs>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 15 KiB |
58
public/brand/logowhite.svg
Normal file
@@ -0,0 +1,58 @@
|
|||||||
|
<svg version="1.2" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 67 21" width="67" height="21">
|
||||||
|
<defs>
|
||||||
|
<clipPath clipPathUnits="userSpaceOnUse" id="cp1">
|
||||||
|
<path d="m26.44 7.16c1.75 0 3.18 0.62 4.17 1.72 0.99 1.11 1.53 2.68 1.53 4.59v0.98h-8.77v0.04c0 1.06 0.32 1.93 0.88 2.53 0.56 0.6 1.36 0.95 2.35 0.95 1.42 0 2.44-0.71 2.76-1.74l0.03-0.08h2.63l-0.02 0.13c-0.37 2.33-2.58 3.97-5.46 3.97-1.85 0-3.34-0.62-4.37-1.76-1.03-1.13-1.59-2.75-1.59-4.73 0-1.97 0.57-3.62 1.59-4.78 1.02-1.16 2.49-1.82 4.27-1.82zm9.66 2.13c0.8-1.32 2.18-2.1 3.87-2.1 1.59 0 2.92 0.63 3.84 1.77 0.92 1.13 1.43 2.76 1.43 4.74 0 1.99-0.51 3.62-1.43 4.76-0.92 1.13-2.25 1.77-3.85 1.77-1.74 0-3.12-0.8-3.93-2.11v1.9h-2.7v-17.25h2.77zm30.9 10.73h-2.7v-1.89c-0.78 1.29-2.16 2.1-3.89 2.1-1.6 0-2.93-0.64-3.87-1.78-0.93-1.14-1.45-2.77-1.45-4.75 0-1.97 0.52-3.6 1.45-4.74 0.93-1.14 2.26-1.77 3.85-1.77 1.69 0 3.07 0.79 3.83 2.04v-6.45h2.78zm-64-17.16l3.09 13.09 3.54-13.09 0.02-0.09h2.62l0.02 0.09 3.55 13.09 3.09-13.09 0.02-0.09h2.98l-0.03 0.14-4.61 17.03-0.02 0.08h-2.65l-0.03-0.08-3.63-12.67-3.62 12.67-0.02 0.08h-2.67l-0.02-0.08-4.59-17.03-0.04-0.14h2.98zm50.91 17.16h-2.77v-17.24h2.77zm-4.87-0.03h-2.77v-12.63h2.77zm11.87-2.03q0.09 0 0.18 0zm-21.64-8.4c-0.93 0-1.72 0.41-2.29 1.13-0.56 0.72-0.89 1.76-0.89 3.02 0 1.27 0.33 2.31 0.89 3.03 0.57 0.71 1.36 1.12 2.29 1.12 0.97 0 1.75-0.4 2.28-1.1 0.55-0.71 0.85-1.75 0.85-3.05 0-1.29-0.3-2.33-0.85-3.04-0.53-0.71-1.31-1.11-2.28-1.11zm21.81 0c-0.97 0-1.76 0.4-2.31 1.11-0.54 0.71-0.86 1.75-0.86 3.04 0 1.29 0.32 2.33 0.86 3.04 0.55 0.71 1.34 1.11 2.31 1.11 0.95 0 1.73-0.4 2.28-1.12 0.56-0.71 0.88-1.75 0.88-3.03 0-1.27-0.32-2.31-0.88-3.03-0.55-0.71-1.33-1.12-2.28-1.12zm-19.79 7.65q-0.01 0.01-0.03 0.03 0.02-0.02 0.03-0.03zm0.13-0.13h0.01q-0.07 0.07-0.14 0.13 0.07-0.06 0.13-0.13zm16.38-3.37q0 0.45 0.05 0.87-0.02-0.19-0.03-0.39l-0.02-0.48q0.01-0.06 0.01-0.12-0.01 0.06-0.01 0.12zm-12.67 0q0 0.04 0 0.09v-0.09q0-0.23-0.01-0.45zm0 0.36v-0.15q0 0.11-0.01 0.21 0.01-0.03 0.01-0.06zm0-0.15q0-0.06 0-0.12zm-18.69-4.47c-1.68 0-2.87 1.24-3.04 3.01h5.96c-0.05-0.88-0.35-1.62-0.84-2.15-0.5-0.54-1.22-0.86-2.08-0.86zm32.25 1.15l0.11-0.13q0.08-0.09 0.16-0.17-0.14 0.14-0.27 0.3zm0.89-0.77q-0.31 0.17-0.56 0.41 0.07-0.07 0.14-0.13 0.13-0.1 0.27-0.19 0.07-0.05 0.15-0.09zm-0.56 0.41q-0.02 0.02-0.03 0.03 0.01-0.01 0.03-0.03zm-32.75-0.9q0 0 0 0 0 0 0 0zm0.17 0h0.09q-0.05 0-0.09-0.01-0.09 0.01-0.17 0.01 0.08 0 0.17 0zm34.25 8.61q0.09 0.01 0.18 0.01-0.09 0-0.18-0.01zm-0.25-0.04q0.11 0.02 0.21 0.03-0.1-0.01-0.21-0.03zm-2.58-3.28q0.02 0.16 0.05 0.31-0.03-0.15-0.05-0.31zm-12.76-0.11q0.02-0.17 0.02-0.35 0 0.18-0.02 0.35zm12.72-1.3q0 0.07 0 0.14 0-0.07 0-0.14zm0.04-0.36q-0.01 0.05-0.02 0.1 0.01-0.05 0.02-0.1zm0.07-0.49q-0.01 0.09-0.03 0.19 0.02-0.1 0.03-0.19zm0.07-0.29q-0.02 0.08-0.04 0.15 0.02-0.07 0.04-0.15zm0.14-0.44q-0.05 0.12-0.09 0.25 0.04-0.13 0.09-0.25zm0.08-0.21q-0.02 0.05-0.05 0.11 0.03-0.06 0.05-0.11zm0.14-0.31q-0.02 0.04-0.04 0.09 0.02-0.05 0.04-0.09z"/>
|
||||||
|
</clipPath>
|
||||||
|
<filter x="-50%" y="-50%" width="200%" height="200%" id="f1"> <feGaussianBlur stdDeviation=".7"/> </filter>
|
||||||
|
<filter x="-50%" y="-50%" width="200%" height="200%" id="f2"> <feGaussianBlur stdDeviation="2.7"/> </filter>
|
||||||
|
<linearGradient id="g1" x2="1" gradientUnits="userSpaceOnUse" gradientTransform="matrix(.62,1.977,-1.976,.62,47.533,3.611)">
|
||||||
|
<stop offset="0" stop-color="#0f3da6" stop-opacity="1"/>
|
||||||
|
<stop offset=".952" stop-color="#3a9aff" stop-opacity="0"/>
|
||||||
|
</linearGradient>
|
||||||
|
<linearGradient id="g2" x2="1" gradientUnits="userSpaceOnUse" gradientTransform="matrix(.495,2.092,-2.092,.495,46.707,3.06)">
|
||||||
|
<stop offset=".01" stop-color="#0d50e8" stop-opacity="1"/>
|
||||||
|
<stop offset=".952" stop-color="#3a9aff" stop-opacity="0"/>
|
||||||
|
</linearGradient>
|
||||||
|
<filter x="-50%" y="-50%" width="200%" height="200%" id="f3"> <feGaussianBlur stdDeviation="0"/> </filter>
|
||||||
|
<linearGradient id="g3" x2="1" gradientUnits="userSpaceOnUse" gradientTransform="matrix(1.982,3.688,-3.688,1.982,46.267,2.069)">
|
||||||
|
<stop offset="0" stop-color="#0f3da6" stop-opacity="0"/>
|
||||||
|
<stop offset="1" stop-color="#59abff" stop-opacity="1"/>
|
||||||
|
</linearGradient>
|
||||||
|
<linearGradient id="g4" x2="1" gradientUnits="userSpaceOnUse" gradientTransform="matrix(.606,2.752,-2.752,.606,46.32,2.122)">
|
||||||
|
<stop offset="0" stop-color="#0f3da6" stop-opacity="0"/>
|
||||||
|
<stop offset="1" stop-color="#59abff" stop-opacity="1"/>
|
||||||
|
</linearGradient>
|
||||||
|
</defs>
|
||||||
|
<style>
|
||||||
|
.s0 { fill: #ffffff }
|
||||||
|
.s1 { filter: url(#f1);fill: #0597ff }
|
||||||
|
.s2 { filter: url(#f2);fill: #0597ff }
|
||||||
|
.s3 { fill: url(#g1) }
|
||||||
|
.s4 { fill: url(#g2) }
|
||||||
|
.s5 { filter: url(#f3);fill: url(#g3) }
|
||||||
|
.s6 { filter: url(#f1);fill: url(#g4) }
|
||||||
|
</style>
|
||||||
|
<path class="s0" d="m26.44 7.16c1.75 0 3.18 0.62 4.17 1.72 0.99 1.11 1.53 2.68 1.53 4.59v0.98h-8.77v0.04c0 1.06 0.32 1.93 0.88 2.53 0.56 0.6 1.36 0.95 2.35 0.95 1.42 0 2.44-0.71 2.76-1.74l0.03-0.08h2.63l-0.02 0.13c-0.37 2.33-2.58 3.97-5.46 3.97-1.85 0-3.34-0.62-4.37-1.76-1.03-1.13-1.59-2.75-1.59-4.73 0-1.97 0.57-3.62 1.59-4.78 1.02-1.16 2.49-1.82 4.27-1.82zm9.66 2.13c0.8-1.32 2.18-2.1 3.87-2.1 1.59 0 2.92 0.63 3.84 1.77 0.92 1.13 1.43 2.76 1.43 4.74 0 1.99-0.51 3.62-1.43 4.76-0.92 1.13-2.25 1.77-3.85 1.77-1.74 0-3.12-0.8-3.93-2.11v1.9h-2.7v-17.25h2.77zm30.9 10.73h-2.7v-1.89c-0.78 1.29-2.16 2.1-3.89 2.1-1.6 0-2.93-0.64-3.87-1.78-0.93-1.14-1.45-2.77-1.45-4.75 0-1.97 0.52-3.6 1.45-4.74 0.93-1.14 2.26-1.77 3.85-1.77 1.69 0 3.07 0.79 3.83 2.04v-6.45h2.78zm-64-17.16l3.09 13.09 3.54-13.09 0.02-0.09h2.62l0.02 0.09 3.55 13.09 3.09-13.09 0.02-0.09h2.98l-0.03 0.14-4.61 17.03-0.02 0.08h-2.65l-0.03-0.08-3.63-12.67-3.62 12.67-0.02 0.08h-2.67l-0.02-0.08-4.59-17.03-0.04-0.14h2.98zm50.91 17.16h-2.77v-17.24h2.77zm-4.87-0.03h-2.77v-12.63h2.77zm11.87-2.03q0.09 0 0.18 0zm-0.22-0.02q0.09 0.01 0.18 0.02-0.09-0.01-0.18-0.02zm-0.25-0.03q0.1 0.02 0.21 0.03-0.11-0.01-0.21-0.03zm-21.17-8.35c-0.93 0-1.72 0.41-2.29 1.13-0.56 0.72-0.89 1.76-0.89 3.02 0 1.27 0.33 2.31 0.89 3.03 0.57 0.71 1.36 1.12 2.29 1.12 0.97 0 1.75-0.4 2.28-1.1 0.55-0.71 0.85-1.75 0.85-3.05 0-1.29-0.3-2.33-0.85-3.04-0.53-0.71-1.31-1.11-2.28-1.11zm21.81 0c-0.97 0-1.76 0.4-2.31 1.11-0.54 0.71-0.86 1.75-0.86 3.04 0 1.29 0.32 2.33 0.86 3.04 0.55 0.71 1.34 1.11 2.31 1.11 0.95 0 1.73-0.4 2.28-1.12 0.56-0.71 0.88-1.75 0.88-3.03 0-1.27-0.32-2.31-0.88-3.03-0.55-0.71-1.33-1.12-2.28-1.12zm-19.82 7.68q0.09-0.08 0.16-0.16h0.01q-0.08 0.08-0.17 0.16zm16.6-2.61q0.02 0.16 0.05 0.3-0.03-0.14-0.05-0.3zm-0.06-0.92q0 0.45 0.05 0.87-0.02-0.19-0.03-0.39l-0.02-0.48q0.01-0.06 0.01-0.12-0.01 0.06-0.01 0.12zm-12.7 0.8q0.01-0.17 0.02-0.34-0.01 0.17-0.02 0.34zm0.03-0.8q0 0.21-0.01 0.42 0-0.03 0.01-0.06v-0.36q0-0.23-0.01-0.45zm12.69-0.49q0 0.07-0.01 0.13 0.01-0.06 0.01-0.13zm0.03-0.36q0 0.05-0.01 0.1 0.01-0.05 0.01-0.1zm0.08-0.49q-0.02 0.09-0.03 0.19 0.01-0.1 0.03-0.19zm-31.49-2.93c-1.68 0-2.87 1.25-3.04 3.02h5.96c-0.05-0.88-0.35-1.62-0.84-2.15-0.51-0.54-1.22-0.87-2.08-0.87zm31.56 2.64q-0.02 0.07-0.04 0.15 0.02-0.08 0.04-0.15zm0.14-0.44q-0.05 0.12-0.09 0.25 0.04-0.13 0.09-0.25zm0.08-0.22q-0.03 0.06-0.05 0.12 0.02-0.06 0.05-0.12zm0.14-0.3q-0.02 0.04-0.04 0.09 0.02-0.05 0.04-0.09zm0.6-0.83q-0.14 0.15-0.27 0.31l0.11-0.13q0.08-0.09 0.16-0.18zm0.61-0.46q-0.32 0.18-0.59 0.44 0.09-0.08 0.18-0.16 0.13-0.11 0.27-0.2 0.07-0.04 0.14-0.08zm-33.3-0.49q0.08-0.01 0.17-0.01l0.09 0.01q-0.05-0.01-0.09-0.01-0.09 0-0.17 0.01z"/>
|
||||||
|
<g id="Clip-Path" clip-path="url(#cp1)">
|
||||||
|
<g>
|
||||||
|
<g style="opacity: .17">
|
||||||
|
<path class="s1" d="m36.14 2.62h-3.58l9.91-9.03 12.33 1.32 8.09 3.75-7.32 4.73c-1.1-0.2-3.42-0.48-3.91 0-0.6 0.61-0.6 2.26-0.77 3.52-0.13 1.02-1.08 0.94-1.54 0.77l-2.92 0.44-0.88 4.3c-0.24-0.17-0.87-0.85-1.49-2.26-0.77-1.76-1.76-2.31-3.35-2.48-1.28-0.13-3.93 0.79-4.57 1.11z"/>
|
||||||
|
</g>
|
||||||
|
<g>
|
||||||
|
<path class="s2" d="m36.14 2.62h-3.58l9.91-9.03 12.33 1.32 8.09 3.75-7.32 4.73c-1.1-0.2-3.42-0.48-3.91 0-0.6 0.61-0.6 2.26-0.77 3.52-0.13 1.02-1.08 0.94-1.54 0.77l-2.92 0.44-0.88 4.3c-0.24-0.17-0.87-0.85-1.49-2.26-0.77-1.76-1.76-2.31-3.35-2.48-1.28-0.13-3.93 0.79-4.57 1.11z"/>
|
||||||
|
</g>
|
||||||
|
</g>
|
||||||
|
</g>
|
||||||
|
<g>
|
||||||
|
<path fill-rule="evenodd" class="s3" d="m46.78 5c-0.95-0.45-1.34-1.58-0.89-2.53 0.45-0.95 1.58-1.36 2.52-0.91 0.94 0.44 1.34 1.58 0.89 2.53-0.46 0.95-1.58 1.36-2.52 0.91z"/>
|
||||||
|
</g>
|
||||||
|
<g>
|
||||||
|
<path fill-rule="evenodd" class="s4" d="m46.99 5.1c-0.83-0.39-1.18-1.37-0.79-2.2 0.4-0.82 1.38-1.17 2.2-0.78 0.83 0.39 1.18 1.37 0.79 2.2-0.39 0.82-1.38 1.17-2.2 0.78z"/>
|
||||||
|
</g>
|
||||||
|
<g>
|
||||||
|
<path fill-rule="evenodd" class="s5" d="m47.99 1.98c0.9 0.17 1.5 1.03 1.33 1.93-0.16 0.9-1.02 1.49-1.92 1.32-0.9-0.16-1.49-1.02-1.33-1.92 0.17-0.9 1.03-1.49 1.92-1.33z"/>
|
||||||
|
</g>
|
||||||
|
<g>
|
||||||
|
<path fill-rule="evenodd" class="s6" d="m48.05 2.04c0.9 0.16 1.49 1.02 1.32 1.92-0.16 0.9-1.02 1.49-1.92 1.33-0.9-0.17-1.49-1.03-1.33-1.93 0.17-0.89 1.03-1.49 1.93-1.32z"/>
|
||||||
|
</g>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 8.6 KiB |
BIN
public/images/noise.webp
Normal file
|
After Width: | Height: | Size: 245 KiB |
BIN
public/placeholders/iphone.jpg
Normal file
|
After Width: | Height: | Size: 61 KiB |
19
public/placeholders/placeholder-logo.svg
Normal file
@@ -0,0 +1,19 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 54.424461 14.339843" fill="#fa0c00">
|
||||||
|
<g>
|
||||||
|
<path d="M 5.996094,0 H 0 v 14.339843 z m 0,0" />
|
||||||
|
<path d="m 10.214844,0 h 5.988281 v 14.339843 z m 0,0" />
|
||||||
|
<path d="m 8.105469,5.285156 3.816406,9.054687 H 9.417969 L 8.277344,11.457031 H 5.484375 Z m 0,0" />
|
||||||
|
</g>
|
||||||
|
<g>
|
||||||
|
<path
|
||||||
|
d="m 25.985303,9.11922 0.707031,2.027344 c 0.02344,0.05078 0.05859,0.07422 0.121094,0.07422 h 1.359375 c 0.07422,0 0.08594,-0.03516 0.07422,-0.109375 L 25.438428,3.310627 c -0.01172,-0.0625 -0.02344,-0.074219 -0.08594,-0.074219 h -1.6875 c -0.04687,0 -0.07422,0.035156 -0.07422,0.085937 -0.02344,0.410157 -0.05859,0.535157 -0.109375,0.65625 l -2.503906,7.121094 c -0.01172,0.08594 0.01563,0.121094 0.08594,0.121094 h 1.214843 c 0.07422,0 0.109375,-0.02344 0.136719,-0.09766 L 23.082959,9.11922 Z M 23.469678,7.795002 c 0.367187,-1.109375 0.851562,-2.53125 1.046875,-3.34375 h 0.01172 c 0.242188,0.851562 0.8125,2.539062 1.070313,3.34375 z m 0,0" />
|
||||||
|
<path
|
||||||
|
d="m 31.857666,11.341877 c 0.730469,0 1.507813,-0.132813 2.296875,-0.472657 0.0625,-0.02344 0.07422,-0.05078 0.07422,-0.109375 -0.02344,-0.21875 -0.05078,-0.535156 -0.05078,-0.777343 v -7.34375 c 0,-0.046875 0,-0.070313 -0.05859,-0.070313 h -1.324219 c -0.05078,0 -0.07422,0.023438 -0.07422,0.085938 V 5.142658 C 32.513916,5.11922 32.369385,5.107502 32.19751,5.107502 c -2.136719,0 -3.449219,1.410156 -3.449219,3.171875 0,2.042968 1.347656,3.0625 3.109375,3.0625 z m 0.863281,-1.359375 c -0.21875,0.070312 -0.460937,0.097656 -0.707031,0.097656 -0.96875,0 -1.761719,-0.546875 -1.761719,-1.875 0,-1.175781 0.816407,-1.871094 1.898438,-1.871094 0.21875,0 0.410156,0.023438 0.570312,0.085938 z m 0,0" />
|
||||||
|
<path
|
||||||
|
d="m 38.453285,5.107502 c -1.824219,0 -2.953125,1.398437 -2.953125,3.125 0,1.542968 0.898438,3.109375 2.925781,3.109375 1.714844,0 2.917969,-1.261719 2.917969,-3.148438 0,-1.664062 -1.019531,-3.085937 -2.890625,-3.085937 z m -0.07422,1.226562 c 1.03125,0 1.46875,0.886719 1.46875,1.898438 0,1.25 -0.644531,1.871093 -1.394531,1.871093 -0.925781,0 -1.472656,-0.777343 -1.472656,-1.898437 0,-1.152344 0.582031,-1.871094 1.398437,-1.871094 z m 0,0" />
|
||||||
|
<path
|
||||||
|
d="m 42.712968,2.568439 c -0.05078,0 -0.08594,0.023438 -0.08594,0.085938 v 8.3125 c 0,0.03516 0.03516,0.09766 0.08594,0.109375 0.582031,0.179687 1.191406,0.265625 1.820312,0.265625 1.800781,0 3.550781,-1.117188 3.550781,-3.367188 0,-1.628906 -1.117187,-2.867187 -2.867187,-2.867187 -0.402344,0 -0.777344,0.0625 -1.105469,0.171875 L 44.09578,2.666095 c 0,-0.085937 -0.02344,-0.097656 -0.109375,-0.097656 z m 3.875,5.554688 c 0,1.347656 -0.921875,1.980468 -1.917969,1.980468 -0.207031,0 -0.390625,-0.01172 -0.558594,-0.0625 V 6.49422 c 0.191406,-0.074218 0.421875,-0.136718 0.847656,-0.136718 0.960938,0 1.628907,0.609375 1.628907,1.765625 z m 0,0" />
|
||||||
|
<path
|
||||||
|
d="m 53.026024,8.560627 c 0.59375,0 1.082031,-0.011719 1.25,-0.050782 0.0625,-0.011718 0.08594,-0.035156 0.09766,-0.085937 0.03516,-0.132813 0.05078,-0.410156 0.05078,-0.75 0,-1.15625 -0.695312,-2.566406 -2.492187,-2.566406 -1.835938,0 -2.855469,1.496093 -2.855469,3.183593 0,1.496094 0.789063,3.050782 3,3.050782 0.828125,0 1.363281,-0.132813 1.824219,-0.351563 0.04687,-0.02344 0.07031,-0.0625 0.07031,-0.132812 V 9.845783 c 0,-0.058594 -0.03516,-0.070313 -0.07031,-0.046875 -0.460938,0.195312 -0.960938,0.292969 -1.507813,0.292969 -1.238281,0 -1.800781,-0.683594 -1.835937,-1.53125 z m -2.46875,-1.046875 c 0.09766,-0.59375 0.472656,-1.238282 1.3125,-1.238282 0.925781,0 1.167969,0.777344 1.167969,1.128907 0,0.011718 0,0.0625 0,0.097656 -0.05078,0.011719 -0.207032,0.011719 -0.667969,0.011719 z m 0,0" />
|
||||||
|
</g>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 3.6 KiB |
BIN
public/placeholders/placeholder1.webp
Normal file
|
After Width: | Height: | Size: 1.1 MiB |
BIN
public/placeholders/placeholder2.jpg
Normal file
|
After Width: | Height: | Size: 60 KiB |
BIN
public/placeholders/placeholder3.avif
Normal file
|
After Width: | Height: | Size: 20 KiB |
BIN
public/placeholders/placeholder4.webp
Normal file
|
After Width: | Height: | Size: 417 KiB |
BIN
public/placeholders/placeholder5.jpg
Normal file
|
After Width: | Height: | Size: 4.8 MiB |
BIN
public/templates/ai-agents/image1.webp
Normal file
|
After Width: | Height: | Size: 522 KiB |
BIN
public/templates/business-coach/hero/hero1.webp
Normal file
|
After Width: | Height: | Size: 269 KiB |
BIN
public/templates/business-coach/hero/hero2.webp
Normal file
|
After Width: | Height: | Size: 170 KiB |
BIN
public/templates/dentist/about/about1.avif
Normal file
|
After Width: | Height: | Size: 22 KiB |
BIN
public/templates/dentist/about/about2.avif
Normal file
|
After Width: | Height: | Size: 24 KiB |
BIN
public/templates/dentist/contact/contact.avif
Normal file
|
After Width: | Height: | Size: 25 KiB |
BIN
public/templates/dentist/hero/hero1.avif
Normal file
|
After Width: | Height: | Size: 20 KiB |
BIN
public/templates/dentist/services/service1.avif
Normal file
|
After Width: | Height: | Size: 19 KiB |
BIN
public/templates/dentist/services/service2.avif
Normal file
|
After Width: | Height: | Size: 23 KiB |
BIN
public/templates/dentist/services/service3.avif
Normal file
|
After Width: | Height: | Size: 20 KiB |
BIN
public/templates/luxury-travel-agency/contact/contact1.webp
Normal file
|
After Width: | Height: | Size: 421 KiB |
|
After Width: | Height: | Size: 471 KiB |
|
After Width: | Height: | Size: 320 KiB |
|
After Width: | Height: | Size: 632 KiB |
|
After Width: | Height: | Size: 660 KiB |
|
After Width: | Height: | Size: 520 KiB |
|
After Width: | Height: | Size: 355 KiB |
BIN
public/templates/luxury-travel-agency/hero/hero1.webp
Normal file
|
After Width: | Height: | Size: 338 KiB |
BIN
public/templates/luxury-travel-agency/hero/hero2.webp
Normal file
|
After Width: | Height: | Size: 754 KiB |
BIN
public/templates/luxury-travel-agency/hero/hero3.jpg
Normal file
|
After Width: | Height: | Size: 358 KiB |
BIN
public/templates/luxury-travel-agency/hero/hero4.jpg
Normal file
|
After Width: | Height: | Size: 240 KiB |
BIN
public/templates/luxury-travel-agency/phone/phone1.webp
Normal file
|
After Width: | Height: | Size: 752 KiB |
BIN
public/templates/luxury-travel-agency/phone/phone2.webp
Normal file
|
After Width: | Height: | Size: 463 KiB |
BIN
public/templates/luxury-travel-agency/phone/phone3.webp
Normal file
|
After Width: | Height: | Size: 713 KiB |
BIN
public/templates/luxury-travel-agency/phone/phone4.webp
Normal file
|
After Width: | Height: | Size: 533 KiB |
BIN
public/templates/luxury-travel-agency/phone/phone5.webp
Normal file
|
After Width: | Height: | Size: 331 KiB |
BIN
public/templates/luxury-travel-agency/phone/phone6.webp
Normal file
|
After Width: | Height: | Size: 559 KiB |
BIN
public/templates/luxury-travel-agency/services/service1.webp
Normal file
|
After Width: | Height: | Size: 383 KiB |
BIN
public/templates/luxury-travel-agency/services/service2.webp
Normal file
|
After Width: | Height: | Size: 186 KiB |
BIN
public/templates/luxury-travel-agency/services/service3.webp
Normal file
|
After Width: | Height: | Size: 663 KiB |
BIN
public/templates/luxury-travel-agency/services/service4.webp
Normal file
|
After Width: | Height: | Size: 974 KiB |
BIN
public/templates/luxury-travel-agency/services/service5.webp
Normal file
|
After Width: | Height: | Size: 258 KiB |
|
After Width: | Height: | Size: 395 KiB |
|
After Width: | Height: | Size: 321 KiB |
|
After Width: | Height: | Size: 474 KiB |
BIN
public/templates/personal-grid/grid1.webp
Normal file
|
After Width: | Height: | Size: 195 KiB |
BIN
public/templates/personal-grid/grid2.webp
Normal file
|
After Width: | Height: | Size: 141 KiB |
BIN
public/templates/skincare/hero.webp
Normal file
|
After Width: | Height: | Size: 147 KiB |
BIN
public/templates/skincare/image1.webp
Normal file
|
After Width: | Height: | Size: 88 KiB |
BIN
public/templates/skincare/image2.webp
Normal file
|
After Width: | Height: | Size: 264 KiB |
BIN
public/templates/skincare/image3.webp
Normal file
|
After Width: | Height: | Size: 112 KiB |
BIN
public/templates/skincare/image4.webp
Normal file
|
After Width: | Height: | Size: 264 KiB |
BIN
public/templates/skincare/image5.avif
Normal file
|
After Width: | Height: | Size: 19 KiB |
BIN
public/templates/skincare/image6.avif
Normal file
|
After Width: | Height: | Size: 15 KiB |
BIN
public/templates/skincare/image7.avif
Normal file
|
After Width: | Height: | Size: 42 KiB |
BIN
public/templates/skincare/image8.avif
Normal file
|
After Width: | Height: | Size: 17 KiB |
BIN
public/templates/web-agency/hero/hero1.webp
Normal file
|
After Width: | Height: | Size: 523 KiB |
BIN
public/templates/web-agency/hero/hero2.webp
Normal file
|
After Width: | Height: | Size: 168 KiB |
BIN
public/templates/web-agency/hero/hero3.webp
Normal file
|
After Width: | Height: | Size: 210 KiB |
BIN
public/templates/web-agency/hero/hero4.webp
Normal file
|
After Width: | Height: | Size: 194 KiB |
BIN
public/templates/web-agency/hero/hero5.webp
Normal file
|
After Width: | Height: | Size: 184 KiB |
BIN
public/templates/web-agency/process/process1.webp
Normal file
|
After Width: | Height: | Size: 399 KiB |
BIN
public/templates/web-agency/process/process2.webp
Normal file
|
After Width: | Height: | Size: 233 KiB |
BIN
public/templates/web-agency/process/process3.webp
Normal file
|
After Width: | Height: | Size: 190 KiB |
BIN
public/templates/web-agency/process/process4.webp
Normal file
|
After Width: | Height: | Size: 157 KiB |
BIN
public/templates/web-agency/services/how1.webp
Normal file
|
After Width: | Height: | Size: 273 KiB |
BIN
public/templates/web-agency/services/how2.webp
Normal file
|
After Width: | Height: | Size: 252 KiB |
BIN
public/templates/web-agency/services/how3.webp
Normal file
|
After Width: | Height: | Size: 425 KiB |
10676
registry.json
Normal file
49
registry/components/AboutMetric.json
Normal file
@@ -0,0 +1,49 @@
|
|||||||
|
{
|
||||||
|
"name": "AboutMetric",
|
||||||
|
"description": "About section with centered animated title and metric cards in a responsive grid.",
|
||||||
|
"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 }>",
|
||||||
|
"useInvertedBackground": "'noInvert' | 'invertDefault'",
|
||||||
|
"ariaLabel?": "string (default: 'About metrics section')",
|
||||||
|
"className?": "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={\"noInvert\"}\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
|
||||||
|
}
|
||||||
|
}
|
||||||
21
registry/components/AnimatedAuroraBackground.json
Normal file
@@ -0,0 +1,21 @@
|
|||||||
|
{
|
||||||
|
"name": "AnimatedAuroraBackground",
|
||||||
|
"description": "Aurora borealis effect with animated repeating gradients and mix-blend-difference.",
|
||||||
|
"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
|
||||||
|
}
|
||||||
|
}
|
||||||
24
registry/components/AnimatedGridBackground.json
Normal file
@@ -0,0 +1,24 @@
|
|||||||
|
{
|
||||||
|
"name": "AnimatedGridBackground",
|
||||||
|
"description": "Grid pattern with animated pulsing squares using 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
|
||||||
|
}
|
||||||
|
}
|
||||||
20
registry/components/AuroraBackground.json
Normal file
@@ -0,0 +1,20 @@
|
|||||||
|
{
|
||||||
|
"name": "AuroraBackground",
|
||||||
|
"description": "Aurora borealis-style background with multiple rotated gradient bars and blur effect.",
|
||||||
|
"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
|
||||||
|
}
|
||||||
|
}
|
||||||
33
registry/components/AvatarGroup.json
Normal file
@@ -0,0 +1,33 @@
|
|||||||
|
{
|
||||||
|
"name": "AvatarGroup",
|
||||||
|
"description": "Displays a group of user avatars with overlapping layout and optional text label.",
|
||||||
|
"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",
|
||||||
|
"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
|
||||||
|
}
|
||||||
|
}
|
||||||
27
registry/components/BentoGlobe.json
Normal file
@@ -0,0 +1,27 @@
|
|||||||
|
{
|
||||||
|
"name": "BentoGlobe",
|
||||||
|
"description": "Interactive 3D rotating globe component using COBE library with theme-aware colors and customizable markers.",
|
||||||
|
"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": "<Globe 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
|
||||||
|
}
|
||||||
|
}
|
||||||
64
registry/components/BlogCardOne.json
Normal file
@@ -0,0 +1,64 @@
|
|||||||
|
{
|
||||||
|
"name": "BlogCardOne",
|
||||||
|
"description": "Blog section with card grid/carousel layout featuring image, category, title, excerpt, and author info.",
|
||||||
|
"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",
|
||||||
|
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||||
|
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||||
|
"useInvertedBackground": "'noInvert' | 'invertDefault'",
|
||||||
|
"ariaLabel?": "string (default: 'Blog section')",
|
||||||
|
"className?": "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={\"noInvert\"} 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
|
||||||
|
}
|
||||||
|
}
|
||||||
67
registry/components/BlogCardThree.json
Normal file
@@ -0,0 +1,67 @@
|
|||||||
|
{
|
||||||
|
"name": "BlogCardThree",
|
||||||
|
"description": "Blog section with vertical card layout featuring tag, title, description, and media with overlay button.",
|
||||||
|
"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-none')",
|
||||||
|
"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",
|
||||||
|
"buttons?": "Array<{text: string, onClick?: () => void, href?: string}>",
|
||||||
|
"textboxLayout": "'default' | 'split' | 'split-actions' | 'split-description' | 'inline-image' (required - 'inline-image' uses titleSegments for rich text with images)",
|
||||||
|
"useInvertedBackground": "'noInvert' | 'invertDefault'",
|
||||||
|
"ariaLabel?": "string (default: 'Blog section')",
|
||||||
|
"className?": "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', onBlogClick: () => console.log('clicked')}]} title=\"Featured Articles\" description=\"Explore our latest insights\" textboxLayout=\"default\" useInvertedBackground={\"noInvert\"} 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
|
||||||
|
}
|
||||||
|
}
|
||||||