Agent Skill
2/7/2026project-frontend-design
comprehensive design guide for the Meatballs project, combining high-quality frontend principles with the specific "Craft & Chao" design system. Use this skill for all frontend work in this project.
H
homywu
0GitHub Stars
1Views
npx skills add homywu/meatballs
SKILL.md
| Name | project-frontend-design |
| Description | comprehensive design guide for the Meatballs project, combining high-quality frontend principles with the specific "Craft & Chao" design system. Use this skill for all frontend work in this project. |
name: project-frontend-design description: comprehensive design guide for the Meatballs project, combining high-quality frontend principles with the specific "Craft & Chao" design system. Use this skill for all frontend work in this project.
This skill defines the specific design language for the Meatballs project, merging the "Craft & Chao" aesthetic with high-quality production standards. Avoid generic "AI slop" by strictly adhering to these specific theme patterns.
🎨 Core Design Philosophy: "Craft & Chao"
Commit to this bold aesthetic direction:
- Warm & Authentic: Evoke appetite and warmth using rich orange-red gradients. The site should feel "cooked", not sterile.
- Premium Quality: Use refined typography, generous spacing, and glass-morphism effects (
backdrop-blur). - Mobile-First: Designs must be optimized for single-column, touch-friendly interactions (min 44px targets).
📐 Theme & Aesthetics Guidelines
1. Color System
Do not use generic colors. Use the specific project palette:
- Primary:
orange-500tored-600gradients. Use for CTAs, price highlights. - Background:
#FDFBF7(Warm Off-White). Never use pure white#FFFFFFfor the main page background. - Neutral:
slate-50toslate-900for text and borders. - Semantic:
greenfor success,redfor warning. - Technique: Use opacity layers (
/90,/50) and gradients to create depth and sophistication.
2. Typography
Avoid generic font stacks.
- UI & Body:
font-sans(Clean, readable). - Accents & Prices:
font-serif(Premium, editorial feel). - Hierarchy:
- Hero:
text-4xl, Extrabold. - Prices:
text-5xl(Success page),text-xl(Cards). - Labels: Uppercase,
text-xs, Bold, wide tracking.
- Hero:
3. Component Patterns
- Buttons:
- Primary: Gradient
from-orange-500 to-red-600,rounded-full, with hover scale effects. - Secondary:
orange-50background,orange-700text.
- Primary: Gradient
- Cards:
- White background,
rounded-3xl(Very rounded),shadow-smtransitioning toshadow-xlon hover.
- White background,
- Inputs:
rounded-xl,bg-slate-50, focus ring inorange-500.
4. Motion & Interaction
Create a living interface, not a static page.
- Micro-interactions: Use
active:scale-95on clickable elements. - Transitions: Default to
duration-300. Useduration-700for entrances. - Feedback: Visual state must reflect user actions immediately (e.g., pulse animations).
🔧 Implementation Strategy
- Tailwind CSS: Use utility classes for almost everything.
- Icons: Lucide React (
size={14}tosize={20}). - Images: High-quality food photography with gradient overlays for text readability.
- Internationalization (i18n): All user-facing text must be internationalized using
next-intl. Never hardcode strings; use translation keys (e.g.,t('menu.title')).
🚫 Anti-Patterns (What to Avoid)
- Generic Aesthetics: Do not use "startup blue" or default Bootstrap/Material styles.
- Sterility: Avoid cold grays or pure whites without the warm off-white base.
- Flatness: Always use shadows, gradients, or blur to add depth to flat elements.
- Tiny Targets: Never make touch targets smaller than 44px.
Remember: The goal is a "Premium, Warm, Food-Focused" experience. Implementation must be meticulous and polished.
Skills Info
Original Name:project-frontend-designAuthor:homywu
Download