web-design-methodology

Standardize web UI with token-first CSS and BEM naming.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/moughamir/justwaitit-review --skill web-design-methodology-moughamir
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: web-design-methodology
Source: https://github.com/moughamir/justwaitit-review/tree/main/.agents/skills/web-design-methodology
Command: npx skills add https://github.com/moughamir/justwaitit-review --skill web-design-methodology-moughamir

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

It solves inconsistent, fragile frontend implementations by providing a universal, repeatable methodology for structuring HTML/CSS and delivering accessible, responsive UI.

Core Features & Use Cases

  • Token-first CSS architecture: define semantic CSS custom properties for colors, typography, spacing, shadows, and radii before component styles.
  • BEM naming consistency: enforce Block-Element-Modifier conventions to keep component styles predictable and maintainable.
  • Mobile-first responsive implementation: design for 375px first, then enhance at standard breakpoints without horizontal overflow.
  • Optional three-state dark mode: add a JS-driven theme toggle only when the brief requires it, using the provided toggle approach.
  • Accessibility built in: semantic HTML, focus styles, skip link, labeled form controls, and WCAG-oriented contrast guidance.
  • Performance-minded rules: lazy-loading, preconnect for fonts, and keeping JS framework usage at vanilla JS only.

Quick Start

Apply the methodology by creating tokens in variables.css, implementing BEM component styles in styles.css, adding responsive nav in mobile-nav.css, and using the provided vanilla JS assets only when the brief requires mobile navigation or dark mode.

Frequently Asked Questions about web-design-methodology

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure CSS architecture using design tokens for responsive web pages?

Token-first CSS architecture structures responsive web pages by defining semantic custom properties for colors, typography, spacing, shadows, and radii in a variables file before writing component styles. This approach ensures consistent, maintainable design systems across marketing and application pages.

What's the best way to implement BEM naming for HTML and CSS components?

BEM naming for HTML and CSS components is best implemented by enforcing strict Block-Element-Modifier conventions to keep styles predictable. This methodology pairs blocks with their child elements and modifiers, preventing common layout anti-patterns and maintaining style predictability across typical page templates.

How do I add a dark mode toggle using CSS custom properties and vanilla JS?

A dark mode toggle using CSS custom properties and vanilla JS is added via a class-based approach, explicitly avoiding prefers-color-scheme media queries. This three-state toggle is included only when project requirements demand it, applying a JS-driven class swap to switch semantic token values.

How do I build mobile-first responsive layouts without horizontal overflow?

Mobile-first responsive layouts without horizontal overflow are built by designing for 375px width first, then enhancing styles at standard breakpoints. This methodology prevents horizontal scrolling by scaling components upward and enforcing strict layout rules across navigation patterns and typography systems.

Does this web design methodology require any JavaScript frameworks or dependencies?

This web design methodology requires no JavaScript frameworks or external dependencies, keeping implementation at vanilla JS only. It is suitable for production-grade marketing and application pages, utilizing provided assets for optional mobile navigation and dark mode toggles without framework overhead.

How do I ensure accessibility compliance when building semantic HTML and CSS navigation?

Accessibility compliance for semantic HTML and CSS navigation is ensured by incorporating focus styles, a skip link, labeled form controls, and WCAG-oriented contrast guidance. This methodology enforces accessible markup across page templates, preventing common call-to-action anti-patterns through a built-in quality checklist.