/shvchk
Development February 28, 2026 · 9 min read

Clean Webflow Architecture: How to Build Sites That Don't Fall Apart

#webflow#architecture#best-practices

Key Takeaways

  1. 01. Use a consistent class naming system — BEM or a flat utility system, pick one and stick to it
  2. 02. Never style elements directly — always use classes
  3. 03. CMS collections should model your content, not your layout
  4. 04. Symbols (components) are your best friend for repeated UI patterns

Six months after launch, someone opens the Webflow designer and can’t figure out why changing one class breaks three other sections.

We’ve inherited sites like this. Here’s how to never build one.

The Root Problem

Webflow makes it too easy to style things directly on elements. Click an element, change a property, move on. No class created. No structure.

Multiply this by 50 pages and 6 months and you get a site where:

  • Every heading has slightly different styles
  • “Changing the button color” requires editing 40 elements
  • Nobody knows what div-block-47 does

The fix isn’t discipline — it’s system design upfront.

1. Pick a Class Naming Convention

We use a flat utility system inspired by Tailwind, but adapted for Webflow’s constraints:

[component]-[element]--[modifier]

hero-heading
hero-heading--large
card-body
card-body--muted

The rule: every visual property lives in a class. No inline styles. No “just this once” direct edits.

:::tip Create a Style Guide page in every Webflow project. It’s a hidden page that documents all your base classes: typography, colors, buttons, spacing. New team members thank you later. :::

2. Structure Your Symbols

Symbols (Webflow’s components) are the most underused feature. Any UI pattern that appears more than once should be a Symbol:

  • Navigation
  • Footer
  • Card variants
  • CTA sections
  • Feature blocks

The mistake we see: teams build the same card layout 12 times with slight variations, instead of one Symbol with modifier classes.

:::warning Webflow Symbols have one major limitation: they can’t accept dynamic content (props) from outside. Plan your Symbol boundaries carefully — if a section needs unique content on every page, it’s not a good Symbol candidate. :::

3. Design Your CMS Collections for Content, Not Layout

The most common CMS mistake: creating collection fields to control how something looks, not what it is.

Wrong:

Blog Post
├── hero_background_color
├── show_sidebar (toggle)
└── card_image_position

Right:

Blog Post
├── title
├── slug
├── published_at
├── category (ref)
├── tags (multi-ref)
└── featured_image

Layout decisions belong in the designer, not the CMS. Your CMS should model your content model, not your design system.

4. Interactions: Keep Them Isolated

Webflow interactions are powerful and easy to abuse. The rule we follow:

  • One interaction per element
  • Interactions live on the element they animate, not a parent
  • Never use Page Load interactions for layout — use CSS instead

5. Folder Your Assets

A 6-month-old Webflow project with no asset organization looks like a Downloads folder. Images named image-1.png, image-copy-2.png, final-FINAL.png.

Our convention:

blog/    — blog featured images
team/    — author photos
clients/ — logos
og/      — Open Graph images

The 10-Minute Setup That Saves Hours

Before any new Webflow project, we spend 10 minutes:

  1. Creating the Style Guide page
  2. Defining base typography classes (heading-xl, heading-lg, body-md, body-sm)
  3. Setting up color variables
  4. Creating the base component library (button variants, card shell, section wrapper)

Everything built after that references these foundations. Changing the primary color takes 30 seconds.


Want us to audit your existing Webflow site? Get in touch — we’ll tell you what’s worth fixing and what’s fine to leave.

B

Written by

Bohdan Shvchk

Founder & Shopify and Webflow Developer

5+ years building on Webflow, 2+ years on Shopify. Previously at a digital agency. Obsessed with performance and clean architecture.

LinkedIn ↗