zJaaal
Back to the map

Content Types

Mar – May 2023

My first big project at dotCMS. Our designer redesigned the form builder, and I built it, rewriting its styles on top of the ones the whole product shares.

Why it exists

Content types define the structure of the content in dotCMS, and the form builder is where you add and arrange their fields.

The old builder didn't look bad, but it didn't feel like the rest of dotCMS. Our designer redesigned it to fit in context, and my job was to make it real.

Key decisions

  • One source for colors and spacing

    The new design reused the colors and spacing the rest of dotCMS already had, from the shared SCSS library, instead of one-off values, so the builder finally felt part of the product.

  • SCSS organized to last

    I rewrote a lot of the styles and organized the files so they read the same way everywhere. I'm still proud of it: it lasted, and became the example of how to write SCSS files on the project afterwards.

See it work

Coming soon
The redesigned form builder: fields in rows, in the same colors and spacing as the rest of dotCMS.

The hard part

Everything was new: the codebase, its logic, and how its styles fit together. I read a lot of code before changing any, and had to be clever with SCSS to make the new design fit without breaking what was around it.

And it didn't land in one go: it took four PRs over six weeks, because we kept refining it along the way.

Where it is now

Fully shipped. As far as I know it hasn't needed changes since, beyond a theme change across the whole product, which wasn't my work.