Breeze, the tailwind based, developers CMS

This documents breeze, by using breeze. Breeze integrates content editor into the rails workflow and lets developers define the layouts they create.

Breeze renders pages, that are made up of sections, that may include cards. Breeze also manages images, even lets you edit them, and manages translations when you go international.

All data is stored in yaml files, images as assets. Breeze makes commits for changes which developers upstream in a very rails sort of way.

Page

A page is basically your html body, max width 1920 and full height.

A page has many sections, there are different kinds, but always full width

Section

There are many predefined styles of sections, but all full width. Styles may also be defined by the developer.

Sections may include cards. These may be rendered in a eg grid, or as form fields, it's up to the section.

Card

There are also many predefined card styles, eg for grids or features. But also for form fields.

Cards and sections may have options, like background, margin, or alignment.

Cards may also have an image and use (and scale) it to their needs.

Practically

Ok, while that may have sounded abstract, here it is in practice.

You are reading a Page with 4 sections. This section is has blue background, the one above white.

The above section has 3 cards, which are arranged as a grid with 3 columns (responsive, off course).

Breeze allows you to create and edit this structure, the texts and possibly images. And allows developers to define more styles to choose from.

More user functionality

Rounding off the introduction with options, images, changes and translations.
For more details including markdown and in place editing see the tutorial.

options small

Options

Sections and Cards have options (defined by the developer). Background and text color and or alignment are common examples.

images small

Images

Breeze lets you add, remove and edit images. Simple editing is especially useful to match sizes or aspect ratios as needed (eg same for all these cards, 16:9)

translations small

Translations

If you define languages, breeze will create translations and let you edit them in a special ui made for translators. It also shows how many are outdated.

changes small

Changes

Breeze keeps track of changes and creates commits. If your system has a user, it will track that too. Commited changes are pushed upstream.

Ready for more?

Remember, everything you have read is created with an unmodified breeze. Developers can easily enhance the look and customise it to your needs.

Install

If you want to install or try it out, go to

Examples

If you want to look at some example sites
- Hub Feenix
- EcoFrame House
- Nomad site

Tutorial

Or have a look at the tutorial to get a better feel for the details