RaheesAhmed/frontend-design

Frontend Design

Design Thinking Process

Before writing ANY code, commit to a bold aesthetic direction:

1. Purpose — What problem does this interface solve? Who uses it?
2. Tone — Pick a distinct aesthetic: brutalist, retro-futuristic, luxury, editorial, organic, maximalist, neo-brutalist, art-deco, pastel, industrial
3. Differentiation — What makes this UNFORGETTABLE?
4. Constraints — Framework, performance budget, accessibility requirements

CRITICAL: Choose a clear conceptual direction and execute with precision. No generic designs.

Design System Creation

CSS Custom Properties Foundation

:root {
  /* Typography scale (modular scale ratio 1.25) */
  --font-display: 'Cabinet Grotesk', sans-serif;
  --font-body: 'Satoshi', sans-serif;
  --font-mono: 'JetBrains Mono', monospace;
  --text-xs: clamp(0.64rem, 0.59rem + 0.29vw, 0.8rem);
  --text-sm: clamp(0.8rem, 0.73rem + 0.36vw, 1rem);
  --text-base: clamp(1rem, 0.91rem + 0.45vw, 1.25rem);
  --text-lg: clamp(1.25rem, 1.14rem + 0.57vw, 1.56rem);
  --text-xl: clamp(1.56rem, 1.42rem + 0.71vw, 1.95rem);
  --text-2xl: clamp(1.95rem, 1.78rem + 0.89vw, 2.44rem);
  --text-3xl: clamp(2.44rem, 2.22rem + 1.11vw, 3.05rem);

  /* Spacing scale */
  --space-1: 0.25rem;
  --space-2: 0.5rem;
  --space-3: 0.75rem;
  --space-4: 1rem;
  --space-6: 1.5rem;
  --space-8: 2rem;
  --space-12: 3rem;
  --space-16: 4rem;
  --space-24: 6rem;

  /* Radius */
  --radius-sm: 0.375rem;
  --radius-md: 0.75rem;
  --radius-lg: 1rem;
  --radius-xl: 1.5rem;
  --radius-full: 9999px;

  /* Transitions */
  --ease-out: cubic-bezier(0.16, 1, 0.3, 1);
  --ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1);
  --duration-fast: 150ms;
  --duration-normal: 300ms;
  --duration-slow: 500ms;
}

Color System (HSL-based for flexibility)

:root {
  --hue-primary: 262;
  --primary: hsl(var(--hue-primary) 83% 58%);
  --primary-light: hsl(var(--hue-primary) 83% 72%);
  --primary-dark: hsl(var(--hue-primary) 83% 44%);
  --primary-ghost: hsl(var(--hue-primary) 83% 58% / 0.08);

  --surface-0: hsl(240 10% 3.9%);     /* Deepest background */
  --surface-1: hsl(240 10% 5.9%);     /* Cards */
  --surface-2: hsl(240 10% 9%);       /* Elevated cards */
  --surface-3: hsl(240 10% 13%);      /* Hover states */
  --text-primary: hsl(0 0% 98%);
  --text-secondary: hsl(240 5% 65%);
  --text-tertiary: hsl(240 5% 45%);
  --border: hsl(240 4% 16%);
  --border-subtle: hsl(240 4% 12%);
}

Component Architecture

Composition over inheritance

function Card({ children, variant = "default", interactive = false, className, ...props }) {
  return (
    <div
      className={cn(
        "rounded-xl border transition-all duration-300",
        variant === "default" && "bg-surface-1 border-border",
        variant === "ghost" && "bg-transparent border-transparent",
        variant === "elevated" && "bg-surface-2 border-border shadow-lg",
        interactive && "cursor-pointer hover:border-primary/50 hover:shadow-primary/5 hover:shadow-lg",
        className
      )}
      {...props}
    >
      {children}
    </div>
  );
}

Animation Patterns

Staggered reveal on scroll (CSS-only)

.reveal-item {
  opacity: 0;
  transform: translateY(20px);
  animation: revealUp 0.6s var(--ease-out) forwards;
}
.reveal-item:nth-child(1) { animation-delay: 0ms; }
.reveal-item:nth-child(2) { animation-delay: 80ms; }
.reveal-item:nth-child(3) { animation-delay: 160ms; }
.reveal-item:nth-child(4) { animation-delay: 240ms; }

@keyframes revealUp {
  to { opacity: 1; transform: translateY(0); }
}

Hover micro-interactions

.interactive-card {
  transition: transform var(--duration-normal) var(--ease-spring),
              box-shadow var(--duration-normal) var(--ease-out);
}
.interactive-card:hover {
  transform: translateY(-4px) scale(1.01);
  box-shadow: 0 20px 40px -12px rgb(0 0 0 / 0.3);
}

Gradient text effect

.gradient-text {
  background: linear-gradient(135deg, var(--primary-light), var(--primary), #ec4899);
  -webkit-background-clip: text;
  -webkit-text-fill-color: transparent;
  background-clip: text;
}

Responsive Design Strategy

/* Mobile-first breakpoints */
/* sm: 640px  md: 768px  lg: 1024px  xl: 1280px  2xl: 1536px */

.grid-responsive {
  display: grid;
  grid-template-columns: 1fr;
  gap: var(--space-4);
}
@media (min-width: 768px) {
  .grid-responsive { grid-template-columns: repeat(2, 1fr); }
}
@media (min-width: 1024px) {
  .grid-responsive { grid-template-columns: repeat(3, 1fr); }
}

Accessibility Requirements

• All interactive elements have visible focus rings
• Color contrast ratio ≥ 4.5:1 for text, ≥ 3:1 for large text
• All images have descriptive alt attributes
• Keyboard navigation works for all interactive elements
• ARIA labels on icon-only buttons
• prefers-reduced-motion media query for all animations
• Semantic HTML: <nav>, <main>, <article>, <section>

Anti-Slop Rules

NEVER use these generic choices:

• Inter, Roboto, Arial as display fonts (body is OK)
• Purple-on-white color schemes without context
• Generic card grids with no visual hierarchy
• Stock photos without treatment
• Cookie-cutter hero sections (big text + CTA + image)

ALWAYS make unexpected, intentional choices that serve the context.