Clean Webflow Architecture: How to Build Sites That Don't Fall Apart
Key Takeaways
- 01. Use a consistent class naming system — BEM or a flat utility system, pick one and stick to it
- 02. Never style elements directly — always use classes
- 03. CMS collections should model your content, not your layout
- 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-47does
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 Loadinteractions 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:
- Creating the Style Guide page
- Defining base typography classes (
heading-xl,heading-lg,body-md,body-sm) - Setting up color variables
- 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.
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 ↗