Home
Blog
Client-First vs Mast vs Lumos: Which Webflow Framework Should You Use in 2026?

Client-First vs Mast vs Lumos: Which Webflow Framework Should You Use in 2026?

Last updated:
April 19, 2026

If you've been building websites in Webflow for any length of time, you've likely come across the question: Do I need a framework? And if you decide the answer is yes, a second, equally confusing question follows, which one?

As someone who builds Webflow sites professionally using the Finsweet Client-First system and Lumos on client projects every day, I've spent a lot of time with all three of the most popular frameworks: Client-First, Mast, and Lumos. Each has its own philosophy, strengths, and trade-offs.

In this guide, I'll break down what each framework is, how it works, and most importantly, which one is right for you as a Webflow developer.

Client-First vs Mast vs Lumos

What Is a Webflow Framework?

Before diving into the comparison, let's get clear on what a framework actually is in the context of Webflow.

A Webflow framework is a structured system of rules, class naming conventions, layout strategies, and component patterns that guides how you build a Webflow site. Think of it as your development playbook, it tells you how to name classes, structure pages, manage typography, handle spacing, and set up global styles.

Without a framework, every developer builds in their own way. That might be fine for solo projects, but the moment a second developer (or even your future self) opens the project, things get confusing fast. A framework solves this by making projects consistent, maintainable, and scalable from day one.

A good Webflow framework typically includes:

  • A clear class naming convention
  • A defined page and section structure
  • A utility class system for spacing, typography, and layout
  • A style guide cloneable to start new projects from
  • Documentation explaining how and why each decision was made

The three most widely used frameworks in the Webflow community today are Client-First by Finsweet, Mast by No-Code Supply Co., and Lumos by Timothy Ricks. Let's break each one down.

Client-First by Finsweet

What Is Client-First?

Client-First is the most established and widely adopted Webflow framework available today. It was developed by Finsweet, one of the most respected teams in the Webflow ecosystem and it has been the default framework of choice for thousands of Webflow developers and agencies worldwide since its release.

The name itself tells you everything about its philosophy: the client comes first. Every decision in Client-First is made with the goal of creating a Webflow project that a client (or any non-technical person) can comfortably manage and that any Webflow developer can jump into without prior context.

How Client-First Works

Client-First organizes classes into two types: custom classes and utility classes.

Custom classes are written with an underscore(_) in the name for example, hero_content or blog-card_image. The underscore signals that this class belongs to a specific component or section and is only used in that context.

Utility classes have no underscore for example, padding-global, text-color-primary, or margin-large. These are reusable classes applied across the whole project to handle common styling tasks.

Client-First also defines a strict core page structure:

  • page-wrapper wraps all content on the page
  • main-wrapper holds the main body content (important for accessibility)
  • section_[identifier] labels each section in the navigator
  • padding-global handles horizontal spacing site-wide
  • padding-section-[size] controls top and bottom section padding
  • container-[size] manages the max-width of content

This structure is followed on every single page, which means any Webflow developer familiar with Client-First can navigate any Client-First project instantly.

Typography in Client-First

Client-First encourages starting with HTML tag-level styles for H1–H6, body, and paragraph elements. Classes are only added when there's a deviation from the defaults. For overrides, a system of typography utility classes exists, heading-style-h2, text-size-large, text-color-brand, and so on, all of which follow predictable naming patterns.

Spacing in Client-First

Spacing is handled through a combination of utility spacing classes and custom class margins/padding. The system uses rem units throughout (where 1rem = 16px), which has significant accessibility benefits, it respects browser font size settings and zoom.

Who Should Use Client-First?

Client-First is the ideal starting point if:

  • You're newer to Webflow and want a well-documented, beginner-friendly system
  • You're working on a project that will be handed off to a client who might edit it
  • You're working in a team or agency and need everyone speaking the same language
  • You want deep, comprehensive documentation to guide every decision

The trade-off is that Client-First can feel verbose. Class names are intentionally long and descriptive (no abbreviations, ever), and the learning curve for the full documentation can feel overwhelming at first. But that verbosity is precisely what makes it readable by anyone, at any time.

Mast by No-Code Supply Co.

What Is Mast?

Mast is a lightweight, component-first CSS framework for Webflow developed by No-Code Supply Co. Now in version 2.4, it has evolved significantly since its original 2023 release and brings a more developer-centric approach compared to Client-First.

Where Client-First leans heavily on custom classes and descriptive naming for readability, Mast leans into a hybrid system combining base classes, utility classes, and a powerful 12-column grid system inspired by Bootstrap, all tied together with Webflow's native variables.

The tagline from their own documentation says it well: Mast enables you to build roughly 80% of any site efficiently with default classes and components, with the remaining 20% handled through custom classes and your own developer intuition.

How Mast Works

Mast uses three types of classes:

Base classes are foundational and handle common layout and UI structures. They don't use a prefix and often serve as the anchor that combo classes attach to. Examples: section, container, row, col, btn, form.

Utility classes are prefixed with u- and handle quick, targeted style adjustments. Examples: u-bg-primary, u-mb-sm, u-text-center, u-overflow-hidden. These are the classes you reach for when you need a fast one-off change without creating a new custom class.

Custom classes are created for unique components that need their own specific styling. Mast encourages custom classes when utility stacking would get unwieldy generally, if you need more than four utility classes on a single element, it's time for a custom class instead.

Combo classes are modifier classes prefixed with cc- (for example, button cc-secondary or section cc-footer) and are used to create variants of base or custom classes.

The 12-Column Grid System

One of Mast's most defining features is its Bootstrap-inspired 12-column grid. It uses row and col classes with responsive modifiers like col-lg-8, col-md-6, col-sm-12 to control how columns behave at each breakpoint. This makes layouts predictable and fast to build once you're comfortable with the system.

col-lg-8   → spans 8 of 12 columns on desktop
col-md-6   → spans 6 of 12 columns on tablet
col-sm-12  → spans full width on mobile landscape


Variables in Mast

Mast uses Webflow's native variable system extensively, organizing variables into collections for Typography, Color, Theme, Layout, and Components. This allows you to update a single variable and have the change cascade globally across the entire site, a major time-saver on large projects.

Mast v2.0 also introduced a theme/mode system — including base, invert, accent 1, and accent 2 modes which makes implementing dark/light mode or section-specific color themes straightforward.

Components in Mast

Mast ships with a growing library of pre-built Webflow components including buttons, navbars, footers, forms, accordions, modals, sliders (built on Swiper.js), marquees, tabs, and more. These components are properly structured for accessibility and use consistent naming, making them drop-in ready for most projects.

A particularly useful addition in recent versions is the Build Mode component system a set of section, row, column, and content components that allow non-developer collaborators to build pages in Webflow's page builder without breaking the layout system.

Who Should Use Mast?

Mast is a strong choice if:

  • You're an experienced Webflow developer comfortable with a Bootstrap-style layout system
  • You want to leverage Webflow variables and native component architecture
  • You're building large, scalable sites quickly without excessive custom class creation
  • You want a more compact codebase than Client-First with better out-of-the-box component support

The main learning curve with Mast is the 12-column grid system. Once that clicks, the rest of Mast tends to follow naturally. If grid-based layout feels natural to you from frontend development experience, Mast will feel right at home.

Lumos by Timothy Ricks

What Is Lumos?

Lumos is the newest and most technically ambitious of the three frameworks, developed by Timothy Ricks and released in mid-2023. Now in version 2.x, Lumos takes a performance-first, variable-driven approach to Webflow development that is unlike either Client-First or Mast.

Where Client-First prioritizes readability and client-friendliness, and Mast balances speed and structure, Lumos optimizes for performance, flexibility, and developer control. It's designed for experienced Webflow developers who want to push the limits of what's possible.

How Lumos Works

Lumos uses a stacked utility class approach. Every element starts with a component class (the base), and utility classes are stacked on top to handle all styling layout, typography, spacing, color, and more.

The key insight in Lumos is this: by stacking a utility class on a component class, you get the ability to make global changes to that utility across the whole project without touching individual elements. Want to change how all hero section headings are sized? Rename the utility class and the change propagates everywhere it's been used.

Variables as the Foundation

Lumos relies heavily on Webflow variables for almost everything font sizes, spacing, grid configurations, color modes, and more. Instead of hard-coding values into classes, Lumos connects most styling to variables that can be updated globally.

This approach means the initial setup requires more planning, but it pays enormous dividends on large or long-running projects. Making a brand-wide font size change or a color palette update becomes a matter of changing a handful of variable values.

In recent versions, Lumos also adopted fluid typography using CSS clamp() which allows text to scale smoothly across all screen sizes without hard breakpoints, resulting in a more polished and accessible responsive experience.

Color Modes in Lumos

One of the standout features of Lumos is its color mode system. Unlike a simple light/dark toggle, Lumos's color modes can be applied at the section level meaning different parts of the same page can have different active color themes. This is incredibly powerful for modern marketing sites where sections alternate between light backgrounds, dark backgrounds, and brand-colored sections.

The Lumos Chrome Extension

Timothy Ricks also built and maintains a Chrome extension for Lumos that speeds up development considerably. It includes features like fast class naming (auto-generating child class names from parent component classes), automatic px-to-rem unit conversion, variable wrapping in var() and calc() functions, and quick attribute handling for component props. For developers building in Lumos daily, this extension is essentially non-negotiable.

Who Should Use Lumos?

Lumos is the right choice if:

  • You're an experienced Webflow developer with a solid understanding of CSS
  • You're building ambitious, performance-critical projects where codebase efficiency matters
  • You want the most flexibility possible in terms of theming, responsiveness, and global control
  • You're comfortable investing time in the initial setup in exchange for long-term maintainability
  • You need advanced color mode features, like per-section dynamic theming

The trade-off with Lumos is the learning curve. It's the steepest of the three frameworks by a significant margin. It's not designed for beginners, and a client making edits inside Lumos without developer guidance is generally not ideal. But for a developer who takes the time to learn it properly, Lumos offers a level of control and performance optimization that neither Client-First nor Mast can match.

Client-First vs Mast vs Lumos: Side-by-Side Comparison

← Scroll to compare →

Feature Client‑First Mast Lumos
Best for Beginners & agencies Mid-level developers Advanced developers
Learning curve Moderate Moderate–High High
Class naming Descriptive, verbose BEM-inspired, compact Component + stacked utilities
Layout system Flexbox + Grid, custom 12-column grid Utility-based, variable-driven
Variable support Partial Full (native Webflow) Full (core to system)
Component library Minimal Extensive Moderate
Client-editability Excellent Good Limited
Performance Good Good Excellent
Color modes Basic Good (theme modes) Advanced (per-section)
Documentation Extensive Comprehensive Growing
Community size Very large Growing Growing fast
Best for handoffs ✅ Yes ✅ Yes ⚠️ Developer-only

Which Framework Is Best? My Honest Take

After building projects using all three frameworks, here's my honest take as a Webflow developer:

Use Client-First when you're working with clients who will manage their site post-launch, building on a team with mixed experience levels, or starting out with frameworks. The documentation alone is worth it, it's the most thorough of the three by a wide margin, and the naming conventions make even a large project understandable at a glance. It's the framework I default to for most client projects because of how well it scales for handoff.

Use Mast when you're an experienced developer who wants to build fast with a clean grid system, and your project will benefit from a rich component library right out of the box. Mast's native variable integration is excellent, and the Build Mode components are a genuine differentiator if you're working with non-developer collaborators in Webflow. It's also a strong choice if you have a frontend development background and the 12-column grid feels intuitive to you.

Use Lumos when you're a seasoned developer building a complex, high-performance project where long-term scalability and code efficiency are the top priorities. Lumos rewards the time investment. Once you're deep into a Lumos build, the ability to make global changes through variables and stacked utilities is genuinely impressive and the color mode system opens up creative possibilities that other frameworks simply don't offer.

For most professional Figma to Webflow projects I take on, I use Client-First as the foundation because it's the most handoff-friendly, most documented, and most universally understood framework in the community. For more complex, performance-driven projects, I incorporate Lumos principles to achieve greater efficiency.

Can You Mix Frameworks?

Short answer: in theory, yes in practice, no. Mixing frameworks creates confusion because each system has its own logic for class naming, spacing, and structure. Dropping Client-First classes into a Lumos build (or vice versa) will lead to conflicts and make the project harder to maintain, not easier.

The best approach is to commit to one framework per project, learn it deeply, and stay consistent throughout the build.

FAQs About Webflow Frameworks

1. Do I need a framework to build in Webflow?

No, you don't need a framework Webflow works perfectly well without one. But for any project larger than a simple landing page, using a framework significantly improves organization, scalability, and maintainability. It also makes handing off projects to other developers or clients far less painful.

2. Is Client-First still being updated?

Client-First's core documentation has been relatively stable since early 2024, which reflects the maturity of the system rather than abandonment. The fundamentals it covers class naming, core structure, typography, spacing are largely timeless within Webflow. Lumos and Mast have been more actively updated with variable modes and new components.

3. Which framework has the most community support?

Client-First has the largest community of the three, largely because it's the oldest and most widely taught. There are thousands of developers building with it, which means more tutorials, more questions answered in community forums, and more freelancers who will understand your project if they pick it up.

4. What if I'm building a site for a client who wants to edit it themselves?

Client-First is the strongest choice here. Its naming conventions are specifically designed so that non-developers can understand the structure. Mast also supports client editing reasonably well. Lumos is generally best left to developer-only projects unless the client has some technical background.

5. How long does it take to learn each framework?

Client-First: 1–2 weeks to get comfortable with the basics, several months to fully internalize the deeper documentation. Mast: Similar timeline, with extra time needed to get comfortable with the grid system. Lumos: 4–8 weeks minimum to feel confident, depending on your existing CSS depth. The Chrome extension helps significantly.

6. Which framework is best for Figma to Webflow projects?

I personally use Client-First for most Figma to Webflow conversions. The style guide cloneable gives you a structured starting point with pre-built utility classes, and the naming conventions translate naturally from a Figma component structure. Lumos is also excellent for Figma-to-Webflow projects when the design system is complex and benefits from variable-driven styling.

Conclusion: Pick One, Learn It Well

The honest truth is that all three frameworks Client-First, Mast, and Lumos are genuinely good systems built by knowledgeable people who care deeply about the Webflow ecosystem. None of them is objectively the best for every situation.

What matters far more than which framework you choose is that you choose one and learn it properly. A Webflow site built consistently with any of these frameworks will be easier to maintain, easier to hand off, and more performant than a site built without any framework at all.

If you're just getting started with structured Webflow development, start with Client-First. Once you've mastered it, exploring Mast or Lumos will feel like a natural progression rather than an overwhelming leap.

If you're working on a project and want to make sure it's built with the right framework, clean naming, and long-term scalability in mind get in touch and let's talk through the right approach for your specific needs.

Table of Contents

Need help setting up any Webflow framework for your next Webflow project?

Sanjeewa.