Choosing the right visual editor for your website: Platform-first vs. Code-first

Visual editors in or outside CMS are gaining traction for their intuitive interfaces and powerful features. However, not all visual editors are created equal. Today, I would like to talk about the two main types of visual editors and their respective pros and cons to help you make an informed decision about your development needs.

The rise of visual editors in composable architectures

Visual editors have become a cornerstone in modern web design, particularly within composable architectures. These architectures are akin to a puzzle, integrating various content sources—from CMSs and e-commerce systems to payment and digital asset management—into a cohesive website. Visual editors simplify the editing process, allowing content editors to make changes without deep knowledge of the underlying platforms.

The two big buckets of visual editors

Visual editors generally fall into two categories: platform-first and code-first. Let's explore what each of these entails.

Platform-first visual editors

Platform-first visual editors are all about providing a comprehensive service. They offer a web interface that connects all your data sources, allowing you to edit your website components—from hero's to lists—visually within the platform.

How it works:

• You map your website components to the platform's configuration.
• Data source connections are managed within the platform.
• Select a field (prop) in a component and choose the correct data from a connected API.
• When you save your changes, the platform stores the composition data and exposes it as a REST API.

This approach keeps your front-end code clean and straightforward. Your website simply retrieves composition data from the visual editor's platform and renders it accordingly.

Code-first visual editors

On the flip side, code-first visual editors take a minimalist approach. They don't store any data themselves; instead, they provide the tools for visual editing while leaving data management to your front-end code.

How it works:

• Your front-end code establishes connections to data sources.
• The visual editor uses these connections through configurations in your codebase.
• HTML annotations enable inline editing, allowing changes to be written back to the CMS.

This method gives you full control over your data and keeps your website independent from the visual editor.

Pros and cons of platform-first and code-first visual editors

Platform-first

Pros:

• The platform's interface allows for easy configuration.
• Front-end code remains simple and uncluttered.
• The visual editor platform provides many built-in features.

Cons:

• You become reliant on the platform for your website's functionality. It’s a relatively big buy-in.
• Removing the platform from your website leaves you with little to no data.

Code-first

Pros:

• Your website remains functional with or without the visual editor.
• You maintain complete control over your data and how it's managed.

Cons:

• Due to not storing any data, the lack of on-platform features can limit your editing capabilities.
• Front-end code becomes more complex, requiring a skilled technical team.

Making the Right Choice for Your Brand or Agency

Deciding between a platform-first or code-first visual editor depends on your specific needs and resources. A platform-first solution might be the way to go if you value simplicity and built-in features. However, if control and independence are your priorities, then a code-first editor will serve you better.

Consider your team's technical expertise, your willingness to rely on a third-party platform, and the level of complexity you're prepared to handle in your front-end code. By understanding the nuances of each type of visual editor, you can choose to align with your brand's or agency's goals.

Originally published at https://timbenniks.dev/writing/choosing-the-right-visual-editor