ISO methodology: atQuo CSS naming guide

Content Series: 
Stack Decoded
December 15, 2025
2m
Collaborative web projects often stall due to code conflicts and confusing naming conventions. The ISO methodology solves this by creating a universal 'grammar' that lets internal teams and external agencies work in parallel at maximum speed, without needing to read a 50-page manual.

Highlights/Summary

Version: 1.8 (Sept 2025)

Philosophy: Robust structure, flexible content.

The ISO methodology solves the "decision tax" and fragility inherent in collaborative web development, where diverse teams (internal, freelancers, agencies) often waste hours debugging conflicts or deciphering inconsistent naming conventions. By enforcing a rigid three-part structure separated by underscores—[WHERE]_[WHAT]_[WHICH]—but allowing total flexibility within those bounds, ISO creates a "firewall" around every section of a website. This ensures that a freelancer working on a "Hero" section can move at maximum speed using their preferred naming style without fear of breaking the "Footer," eliminating the cognitive load of strict naming dogma while guaranteeing the structural consistency required for scalable, high-speed production.

Why did we call it like that? ISO stands for Isolation, Structure, Object. We wanted to refer to isolating code to prevent conflicts, enforcing a simple structure for consistency, and clearly defining the HTML object being styled.

1. The concept: a framework, not a prison

This methodology doesn't seek to impose how to name things, but help how to structure them so they don't break. It is a robust and simple system:

  • Does your team prefer short names (hro1)? It works.
  • Does the agency prefer descriptive names (hero-home)? It works.
  • Are two teams with different styles collaborating? It works.

As long as everyone respects the Sacred Structure, the system can handle any style without breaking.

2. The only sacred rule

To avoid reading extensive manuals, there is only one law: Your class must have 3 parts, separated by underscores.

[WHERE]_[WHAT]_[WHICH]

The underscore (_) is the containment wall. It allows flexibility to exist without causing chaos.

3. The flexible formula

A. [WHERE] _ (The ID or scope)

Defines the section. It is the isolation bubble. Total freedom: Use whatever your team decides is clearest.

  • nav_ (Simple)
  • hro1_ (Numeric / Sequential)
  • hero-main_ (Descriptive)
  • campaign-xmas_ (Specific)

Golden rule: Everything inside that section must start with this same prefix.

B. [WHAT] _ (The object)

What is the HTML element? Keep this simple so any developer understands it quickly.

  • wrap (containers)
  • grid, col (layout)
  • card (components)
  • head, text (typography)
  • img, icon, btn, link (visuals and actions)

C. [WHICH] (The variant)

The surname. Be as specific as the design requires.

  • main
  • intro-bold
  • feature-dark-mode

4. Examples of flexibility in action

The system adapts to the team, not the other way around.

For example, a "speed" team might prefer typing less, choosing a class like hro1_text_intro. This works perfectly because the underscore maintains the structural order even with short codes.

A "clarity" team, on the other hand, might prefer reading clear English and opt for hero-home_text_intro. The underscore separates the concepts just the same, ensuring readability.

Finally, an "enterprise" team might need to be extremely specific, using something like srv-new-design_card_dark. The system supports that level of detail without breaking the structure.

See the pattern? No matter the style, the visual structure _ _ always tells you where to cut.

5. Practical code examples

Example A: descriptive style (external agency)

Ideal if collaborating with agencies that don't know your internal codes.

<section class="landing-page_wrap">
  <div class="landing-page_grid_hero">
    
    <div class="landing-page_col_content">
      <h1 class="landing-page_head_main-title">We do more</h1>
      
      <div class="landing-page_wrap_buttons">
        <a href="#" class="button-primary">Start</a> <!-- Global -->
      </div>
    </div>

  </div>
</section>


Example B: short style (internal team / Relia)

Ideal for rapid iteration and daily maintenance.

<section class="srv1_wrap">
  <div class="srv1_grid_list">
    
    <div class="srv1_card_item">
       <h3 class="srv1_head_card">Relia</h3>
       <p class="srv1_text_desc">Subscription.</p>
    </div>

  </div>
</section>

6. Summary for new collaborators (kick-off)

  1. Define your prefix: What do you want to call this section? (hero-main, footer, cta-2). That is your [WHERE].
  2. Add an underscore: _
  3. Say what it is: (text, img, card). That is your [WHAT].
  4. Add an underscore: _
  5. Say which one it is: (title, main, blue). That is your [WHICH].

Result: hero-main_text_title

Transcription

About atQuo

atQuo is a creative partner that operates at the intersection of design, technology, and marketing strategy. Our **Insights and Talks** exist to demystify this intersection, sharing the expert knowledge required to make smarter decisions about the tools and tactics that drive growth. This same expertise fuels our services, where we execute on that strategy to build powerful digital experiences that help brands scale with clarity and confidence.

About the 

Stack Decoded

Today's most successful brands are built on a complex ecosystem of software, apps, and AI. In Stack Decoded, the experts at atQuo cut through the noise, demystifying the critical digital tools that power growth.

ISO methodology: atQuo CSS naming guide

Diego G.
•  
December 15, 2025
2m
 read

Stack Decoded

(Content Series)
Today's most successful brands are built on a complex ecosystem of software, apps, and AI. In Stack Decoded, the experts at atQuo cut through the noise, demystifying the critical digital tools that power growth.
You are reading:
ISO methodology: atQuo CSS naming guide

Version: 1.8 (Sept 2025)

Philosophy: Robust structure, flexible content.

The ISO methodology solves the "decision tax" and fragility inherent in collaborative web development, where diverse teams (internal, freelancers, agencies) often waste hours debugging conflicts or deciphering inconsistent naming conventions. By enforcing a rigid three-part structure separated by underscores—[WHERE]_[WHAT]_[WHICH]—but allowing total flexibility within those bounds, ISO creates a "firewall" around every section of a website. This ensures that a freelancer working on a "Hero" section can move at maximum speed using their preferred naming style without fear of breaking the "Footer," eliminating the cognitive load of strict naming dogma while guaranteeing the structural consistency required for scalable, high-speed production.

Why did we call it like that? ISO stands for Isolation, Structure, Object. We wanted to refer to isolating code to prevent conflicts, enforcing a simple structure for consistency, and clearly defining the HTML object being styled.

1. The concept: a framework, not a prison

This methodology doesn't seek to impose how to name things, but help how to structure them so they don't break. It is a robust and simple system:

  • Does your team prefer short names (hro1)? It works.
  • Does the agency prefer descriptive names (hero-home)? It works.
  • Are two teams with different styles collaborating? It works.

As long as everyone respects the Sacred Structure, the system can handle any style without breaking.

2. The only sacred rule

To avoid reading extensive manuals, there is only one law: Your class must have 3 parts, separated by underscores.

[WHERE]_[WHAT]_[WHICH]

The underscore (_) is the containment wall. It allows flexibility to exist without causing chaos.

3. The flexible formula

A. [WHERE] _ (The ID or scope)

Defines the section. It is the isolation bubble. Total freedom: Use whatever your team decides is clearest.

  • nav_ (Simple)
  • hro1_ (Numeric / Sequential)
  • hero-main_ (Descriptive)
  • campaign-xmas_ (Specific)

Golden rule: Everything inside that section must start with this same prefix.

B. [WHAT] _ (The object)

What is the HTML element? Keep this simple so any developer understands it quickly.

  • wrap (containers)
  • grid, col (layout)
  • card (components)
  • head, text (typography)
  • img, icon, btn, link (visuals and actions)

C. [WHICH] (The variant)

The surname. Be as specific as the design requires.

  • main
  • intro-bold
  • feature-dark-mode

4. Examples of flexibility in action

The system adapts to the team, not the other way around.

For example, a "speed" team might prefer typing less, choosing a class like hro1_text_intro. This works perfectly because the underscore maintains the structural order even with short codes.

A "clarity" team, on the other hand, might prefer reading clear English and opt for hero-home_text_intro. The underscore separates the concepts just the same, ensuring readability.

Finally, an "enterprise" team might need to be extremely specific, using something like srv-new-design_card_dark. The system supports that level of detail without breaking the structure.

See the pattern? No matter the style, the visual structure _ _ always tells you where to cut.

5. Practical code examples

Example A: descriptive style (external agency)

Ideal if collaborating with agencies that don't know your internal codes.

<section class="landing-page_wrap">
  <div class="landing-page_grid_hero">
    
    <div class="landing-page_col_content">
      <h1 class="landing-page_head_main-title">We do more</h1>
      
      <div class="landing-page_wrap_buttons">
        <a href="#" class="button-primary">Start</a> <!-- Global -->
      </div>
    </div>

  </div>
</section>


Example B: short style (internal team / Relia)

Ideal for rapid iteration and daily maintenance.

<section class="srv1_wrap">
  <div class="srv1_grid_list">
    
    <div class="srv1_card_item">
       <h3 class="srv1_head_card">Relia</h3>
       <p class="srv1_text_desc">Subscription.</p>
    </div>

  </div>
</section>

6. Summary for new collaborators (kick-off)

  1. Define your prefix: What do you want to call this section? (hero-main, footer, cta-2). That is your [WHERE].
  2. Add an underscore: _
  3. Say what it is: (text, img, card). That is your [WHAT].
  4. Add an underscore: _
  5. Say which one it is: (title, main, blue). That is your [WHICH].

Result: hero-main_text_title

A word about this series

Stack Decoded

Today's most successful brands are built on a complex ecosystem of software, apps, and AI. In Stack Decoded, the experts at atQuo cut through the noise, demystifying the critical digital tools that power growth.

Continue reading...

Look for a new...
Your journey begins here.
Let's talk
.5/5 FROM 10 REVIEWS
Reviewed on Clutch
.TOP WEB DESIGN COMPANY
NY City 2024
.TOP E-COMMERCE DEVS
NY City 2024
.100% JOB SUCCESS PROVIDER
UpWork 2017-2024
.TOP RATED PLUS PROVIDER
UpWork 2019-2024
.5.0/5 Rated
Google Business Reviews
.TOP BIGCOMMERCE COMPANY
New York 2025
.CLUTCH CHAMPION
Fall 2024
.GLOBAL FEATURED
Fall 2024
More creation.
Less administration.
atQuo, registered as Quo Agency, Inc. in New York, is a multifaceted company that blends the expertise of a creative agency with the efficiency of a tech-driven professional services firm. The company is structured to help brands scale their creative output through a suite of three distinct products: Relia, Kit, and Agency. Our model is designed to eliminate wasted time at every stage of your growth. Start fast by launching a defined project in minutes with a fixed-price Kit, which lets you bypass the entire proposal and negotiation process. As your needs become more frequent, build momentum with a flexible Relia subscription to get an on-demand creative team for all day-to-day tasks without the repetitive hiring loop. Finally, for your most mission-critical initiatives, you can immediately activate our strategic Agency partner, skipping the months-long search for a vetted, top-tier firm.