Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
bergside avatar

Neumorphism

  • 478 installs
  • 2.2k repo stars
  • Updated June 28, 2026
  • bergside/awesome-design-skills

neumorphism is a Claude Code design skill that implements soft neumorphic UI depth for developers who need tactile cards, buttons, and panels without heavy skeuomorphism.

About

neumorphism is a Claude Code agent skill from bergside/awesome-design-skills that teaches developers how to build soft neumorphic interface elements using subtle inset and outset box shadows. The skill targets dashboards, mobile app screens, and browser plugin UIs that benefit from gentle tactile depth while staying flatter than classic skeuomorphic design. Developers reach for neumorphism when cards, buttons, and panels should feel pressable and dimensional against a monochromatic or near-monochromatic background. The skill focuses on shadow pairing, highlight placement, and contrast constraints that keep neumorphic controls readable and accessible. Use it during frontend implementation when a utilitarian flat UI needs physical affordance without ornate textures or realistic materials.

  • Soft inset and outset shadow recipes
  • Monochromatic surface color systems
  • Tactile button and card depth treatments
  • Accessible contrast guardrails for soft UI
  • Dashboard and mobile-friendly neumorphic panels

Neumorphism by the numbers

  • 478 all-time installs (skills.sh)
  • Ranked #608 of 1,880 Design & UI/UX skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/bergside/awesome-design-skills --skill neumorphism

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs478
repo stars2.2k
Last updatedJune 28, 2026
Repositorybergside/awesome-design-skills

How do you build neumorphic UI components in CSS?

Implement soft neumorphic cards, buttons, and panels with subtle inset/outset shadows for dashboards, mobile apps, and plugin UIs seeking tactile depth without heavy skeuomorphism.

Who is it for?

Frontend developers styling dashboards, mobile apps, or plugin UIs that need soft tactile depth on monochromatic surfaces.

Skip if: Content-heavy editorial sites, interfaces requiring strict WCAG contrast on varied photography, or designs that demand flat minimalism only.

When should I use this skill?

A developer asks for neumorphic, soft UI, inset shadows, or tactile depth on cards, buttons, or dashboard panels.

What you get

Neumorphic card, button, and panel styles with paired inset/outset shadows and contrast-safe backgrounds.

  • Neumorphic component CSS
  • Shadow and highlight pairing patterns

Files

SKILL.mdMarkdownGitHub ↗

<!-- TYPEUI_SH_MANAGED_START -->

Neumorphism club Design System Skill (Universal)

Mission

You are an expert design-system guideline author for neumorphism. Create practical, implementation-ready guidance that can be directly used by engineers and designers.

Brand

Join the private club where people are building, monetizing, and marketing products with AI.

Style Foundations

  • Visual style: minimal, clean, high-contrast, playful, matrix
  • Typography scale: desktop-first expressive scale | Fonts: primary=Space Mono, display=Space Mono, mono=JetBrains Mono | weights=100, 200, 300, 400, 500, 600, 700, 800, 900
  • Color palette: primary, secondary, success, warning, danger, info | Tokens: primary=#006666, secondary=#F1F2F5, success=#00A63D, warning=#FE9900, danger=#FF2157, surface=#E7E5E4, text=#1E2938
  • Spacing scale: compact density mode

Accessibility

WCAG 2.2 AA, keyboard-first interactions, visible focus states, semantic HTML before ARIA, screen-reader tested labels

Writing Tone

concise, confident, helpful, clear, friendly

Rules: Do

  • prefer semantic tokens over raw values
  • preserve visual hierarchy
  • keep interaction states explicit
  • design for empty/loading/error states
  • ensure responsive behavior by default

Rules: Don't

  • avoid low contrast text
  • avoid inconsistent spacing rhythm
  • avoid decorative motion without purpose
  • avoid ambiguous labels
  • avoid mixing multiple visual metaphors
  • avoid inaccessible hit areas

Expected Behavior

  • Follow the foundations first, then component consistency.
  • When uncertain, prioritize accessibility and clarity over novelty.
  • Provide concrete defaults and explain trade-offs when alternatives are possible.
  • Keep guidance opinionated, concise, and implementation-focused.

Guideline Authoring Workflow

1. Restate the design intent in one sentence before proposing rules. 2. Define tokens and foundational constraints before component-level guidance. 3. Specify component anatomy, states, variants, and interaction behavior. 4. Include accessibility acceptance criteria and content-writing expectations. 5. Add anti-patterns and migration notes for existing inconsistent UI. 6. End with a QA checklist that can be executed in code review.

Required Output Structure

When generating design-system guidance, use this structure:

  • Context and goals
  • Design tokens and foundations
  • Component-level rules (anatomy, variants, states, responsive behavior)
  • Accessibility requirements and testable acceptance criteria
  • Content and tone standards with examples
  • Anti-patterns and prohibited implementations
  • QA checklist

Component Rule Expectations

  • Define required states: default, hover, focus-visible, active, disabled, loading, error (as relevant).
  • Describe interaction behavior for keyboard, pointer, and touch.
  • State spacing, typography, and color-token usage explicitly.
  • Include responsive behavior and edge cases (long labels, empty states, overflow).

Quality Gates

  • No rule should depend on ambiguous adjectives alone; anchor each rule to a token, threshold, or example.
  • Every accessibility statement must be testable in implementation.
  • Prefer system consistency over one-off local optimizations.
  • Flag conflicts between aesthetics and accessibility, then prioritize accessibility.

Example Constraint Language

  • Use "must" for non-negotiable rules and "should" for recommendations.
  • Pair every do-rule with at least one concrete don't-example.
  • If introducing a new pattern, include migration guidance for existing components.

<!-- TYPEUI_SH_MANAGED_END -->

Related skills

FAQ

What UI elements does the neumorphism skill style?

neumorphism covers soft neumorphic cards, buttons, and panels using subtle inset and outset shadows. The skill targets dashboards, mobile apps, and plugin UIs that need tactile depth without heavy skeuomorphism.

What background works best for neumorphic design?

neumorphism works best on monochromatic or near-monochromatic backgrounds where paired highlight and shadow tones create readable inset and outset depth on cards and controls.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.