Back to Skills

frontend-design-fix-vue

matteocervelli
Updated Yesterday
15 views
10
10
View on GitHub
Otherdesign

About

This skill automatically enhances generic Vue component designs by applying systematic improvements across typography, color, motion, spatial composition, and backgrounds. It analyzes existing Vue files to identify bland patterns and transforms them into distinctive interfaces using Anthropic's design framework. Use it when you need to quickly upgrade the visual aesthetics of your Vue components beyond basic styling.

Documentation

Frontend Design Fix - Vue

Overview

Transform bland, generic Vue component designs into visually distinctive interfaces by systematically applying the 5 design dimensions from Anthropic's design framework.

Core Workflow

1. Analysis Phase

  • Read existing Vue component files (.vue, CSS modules, styles)
  • Identify generic elements (Inter/Roboto fonts, purple gradients, centered layouts, no animations, solid backgrounds)
  • Score current design against anti-patterns checklist
  • Generate "before" snapshot with metrics

2. Assessment Phase

  • Understand brand/context from existing content and component props
  • Identify target audience and purpose
  • Determine appropriate aesthetic direction based on component usage

3. Dimension-Based Fixes

Typography

  • Replace generic system fonts (Inter, Roboto, Arial) with distinctive typeface pairs
  • Apply extreme weight ranges (100-200 for thin, 800-900 for bold)
  • Increase size jumps (3x+ progression instead of 1.5x)
  • Create high-contrast pairings (Display + Mono, Serif + Sans)
  • Use scoped styles with CSS-in-JS (styled-components, emotion) or Tailwind

Color & Theme

  • Remove default purple gradients on white backgrounds
  • Introduce CSS custom properties or Vue provide/inject for theming
  • Establish dominant colors with sharp accent colors
  • Avoid evenly-distributed palettes (use 70-20-10 rule)
  • Create theme variants (light/dark) with consistent color tokens

Motion

  • Add orchestrated page load animations (fade, scale, slide)
  • Implement staggered reveals with v-transition or Vue Transition Group
  • Add hover state surprises and micro-interactions
  • Include scroll-triggered animations via vue-observe-visibility
  • Use vue-motion or @vue/composable for complex sequences

Spatial Composition

  • Break centered, predictable layouts
  • Add asymmetry or intentional overlap
  • Introduce diagonal flow or grid-breaking elements
  • Adjust spacing (generous negative space OR controlled density)
  • Use CSS Grid and Flexbox creatively with Vue slots

Backgrounds

  • Replace solid colors with layered gradients
  • Add geometric patterns or subtle noise textures
  • Create atmospheric depth with multiple background layers
  • Add contextual effects (blur, blend modes)
  • Use pseudo-elements for background layering

4. Implementation

  • Apply fixes systematically per dimension
  • Update component templates and styles
  • Maintain accessibility standards (WCAG 2.1 AA)
  • Preserve all existing functionality and component props
  • Test with responsive design

5. Validation

  • Re-score against anti-patterns checklist
  • Generate "after" snapshot with improved metrics
  • Create before/after comparison report
  • Verify accessibility compliance with Vue Testing Library

Design Audit Checklist

Typography Audit

  • Current font stack is generic (Inter, Roboto, Arial, system stack)
  • Font weights are limited (only regular and bold)
  • Size progression is minimal (1.25-1.5x multiplier)
  • No distinctive pairing strategy
  • Poor readability on colored backgrounds
  • No responsive typography scaling

Color & Theme Audit

  • Purple/blue gradient on white background (cliché)
  • No CSS custom properties or provide/inject for theming
  • Evenly distributed color palette (5+ primary colors)
  • No accent color for emphasis
  • Insufficient contrast in interactive elements
  • No dark mode support

Motion Audit

  • No page load animations or v-enter/v-leave transitions
  • No staggered reveals for lists with TransitionGroup
  • Hover states missing or uninspired
  • No scroll interactions
  • Abrupt transitions between states
  • Missing micro-interactions on buttons/forms

Spatial Composition Audit

  • Centered, symmetrical layouts throughout
  • Predictable margins and padding
  • No intentional asymmetry in component layouts
  • Grid-aligned everything (no breaking)
  • Single-column or evenly-spaced multi-column layouts

Background Audit

  • Solid white or light gray backgrounds
  • No layering or depth in backgrounds
  • No texture or pattern application
  • Generic or missing hero sections
  • No atmospheric or contextual effects in components

Implementation Tips

Vue 3 + Composition API + Tailwind

<template>
  <div class="
    bg-gradient-to-br from-slate-900 via-slate-800 to-slate-900
    min-h-screen
    font-body
  ">
    <h1 class="
      font-display
      text-6xl font-black
      animate-fade-in-up
    ">
      Distinctive Title
    </h1>
  </div>
</template>

<script setup>
import { ref } from 'vue';

const isVisible = ref(false);
</script>

<style scoped>
:root {
  --font-display: 'Playfair Display', serif;
  --font-body: 'Inter', sans-serif;
  --font-mono: 'IBM Plex Mono', monospace;
  --primary: #1a1a1a;
  --accent: #ff6b35;
}

.font-display {
  font-family: var(--font-display);
}

.font-body {
  font-family: var(--font-body);
}

@keyframes fadeInUp {
  from {
    opacity: 0;
    transform: translateY(20px);
  }
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

.animate-fade-in-up {
  animation: fadeInUp 0.6s ease-out;
}
</style>

Vue Transition Group for Staggered Lists

<template>
  <TransitionGroup
    tag="div"
    class="grid gap-4"
    name="stagger"
  >
    <div
      v-for="(item, index) in items"
      :key="item.id"
      :style="{ '--stagger-index': index }"
    >
      {{ item.content }}
    </div>
  </TransitionGroup>
</template>

<script setup>
import { TransitionGroup } from 'vue';

defineProps({
  items: Array,
});
</script>

<style scoped>
.stagger-enter-active,
.stagger-leave-active {
  transition: all 0.4s ease-out;
  transition-delay: calc(var(--stagger-index, 0) * 100ms);
}

.stagger-enter-from {
  opacity: 0;
  transform: translateY(20px);
}

.stagger-leave-to {
  opacity: 0;
  transform: translateY(-20px);
}
</style>

Vue Provide/Inject for Theme

<!-- ThemeProvider.vue -->
<template>
  <div :style="themeStyles">
    <slot />
  </div>
</template>

<script setup>
import { provide, computed } from 'vue';

const theme = {
  colors: {
    primary: '#1a1a1a',
    accent: '#ff6b35',
    surface: '#fafafa',
  },
  fonts: {
    display: "'Playfair Display', serif",
    body: "'Inter', sans-serif",
  },
};

const themeStyles = computed(() => ({
  '--primary': theme.colors.primary,
  '--accent': theme.colors.accent,
  '--surface': theme.colors.surface,
}));

provide('theme', theme);
</script>

Accessibility Maintenance

  • Keep WCAG AA color contrast minimum 4.5:1 for text
  • Maintain focus visible outlines in interactive elements
  • Use semantic HTML with Vue components
  • Test with Vue Testing Library
  • Preserve ARIA attributes

Examples

See /examples/showcase.md for before/after comparisons:

  • Generic landing page → Distinctive landing page
  • Boring dashboard → Visually striking dashboard
  • Plain form → Aesthetically enhanced form

Success Metrics

After applying fixes, the design should:

  • Score 0-2 items remaining on the anti-patterns checklist
  • Have distinctive typography choices in components
  • Include motion and micro-interactions with Vue Transitions
  • Feature asymmetric or broken-grid layouts
  • Use layered/textured backgrounds via pseudo-elements or gradients
  • Maintain or improve accessibility scores
  • Support light/dark theme variants

Quick Install

/plugin add https://github.com/matteocervelli/llms/tree/main/frontend-design-fix-vue

Copy and paste this command in Claude Code to install this skill

GitHub 仓库

matteocervelli/llms
Path: frontend-design-system/skills/_archive/frontend-design-fix-vue

Related Skills

langchain

Meta

LangChain is a framework for building LLM applications using agents, chains, and RAG pipelines. It supports multiple LLM providers, offers 500+ integrations, and includes features like tool calling and memory management. Use it for rapid prototyping and deploying production systems like chatbots, autonomous agents, and question-answering services.

View skill

Algorithmic Art Generation

Meta

This skill helps developers create algorithmic art using p5.js, focusing on generative art, computational aesthetics, and interactive visualizations. It automatically activates for topics like "generative art" or "p5.js visualization" and guides you through creating unique algorithms with features like seeded randomness, flow fields, and particle systems. Use it when you need to build reproducible, code-driven artistic patterns.

View skill

webapp-testing

Testing

This Claude Skill provides a Playwright-based toolkit for testing local web applications through Python scripts. It enables frontend verification, UI debugging, screenshot capture, and log viewing while managing server lifecycles. Use it for browser automation tasks but run scripts directly rather than reading their source code to avoid context pollution.

View skill

requesting-code-review

Design

This skill dispatches a code-reviewer subagent to analyze code changes against requirements before proceeding. It should be used after completing tasks, implementing major features, or before merging to main. The review helps catch issues early by comparing the current implementation with the original plan.

View skill