
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 neumorphismAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 478 |
|---|---|
| repo stars | ★ 2.2k |
| Last updated | June 28, 2026 |
| Repository | bergside/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
<!-- 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 -->
Overview
Soft, extruded UI elements with inner and outer shadows on monochromatic surfaces for a tactile, embedded look.
Style Foundations
- Visual style: minimal, clean, high-contrast, playful, matrix
- Typography scale: desktop-first expressive scale
- Typography fonts: primary=Space Mono, display=Space Mono, mono=JetBrains Mono
- Typography weights: 100, 200, 300, 400, 500, 600, 700, 800, 900
- Color palette: primary, secondary, success, warning, danger, info
- Spacing scale: compact density mode
Colors
- Primary (#006666): Token from style foundations.
- Secondary (#F1F2F5): Token from style foundations.
- Success (#00A63D): Token from style foundations.
- Warning (#FE9900): Token from style foundations.
- Danger (#FF2157): Token from style foundations.
- Surface (#E7E5E4): Token from style foundations.
- Text (#1E2938): Token from style foundations.
- Neutral (#E7E5E4): Derived from the surface token for official format compatibility.
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.