Back to Docs

Navigation

Cwicly Setup

Automatic.css officially supports Cwicly as of version 2.7. Please follow the instructions below for proper setup.

Step 1: Install Cwicly

For a smooth setup process, install Cwicly before you install Automatic.css. Cwicly needs to exist when ACSS is activated so that ACSS can check for the existence of Cwicly, pre-load utility classes, and automatically activate various aspects of the framework.

Official Cwicly setup instructions

Step 2: Install Automatic.css

Download and install the latest version of Automatic.css from your account dashboard. Remember, you need v2.7 at minimum.

Step 3: Turn on ACSS Support for Gutenberg

Cwicly is a Gutenberg-based builder, so we need to make sure ACSS Gutenberg support is activated.

Head over to the Options tab in ACSS and turn on Gutenberg support. Ensure all settings in the Gutenberg area are set to “On” except for “Class-First Workflow.”

By default, Cwicly has a class-first workflow, so we need this setting off.

Step 4: Configure Cwicly Admin Settings

In the WordPress admin, go to Cwicly > Settings and open the “Advanced Settings” panel.

Cwicly admin settings

Here are the recommended settings to confirm:

  • Remove List Container = On
  • Remove Classes & IDs = On
  • Cwicly Defaults = Off
  • Remove SVG Filters = On
  • Remove WordPress Global Styles = On
  • Remove WordPress Emojis = On
  • Remove Gutenberg Template Part Wrapper = On
  • Remove Container Block Display Properties = Off
  • All Deprecated Settings = Off

Step 4: Configure Cwicly Builder Settings & Global Styles

Open Cwicly by editing a page. Once the builder loads, navigate to the Settings Panel:

Cwicly Global Settings Panel

Breakpoint Setup

Cwicly and Automatic.css must use matching breakpoint values. The actual values are up to you as long as they are identical between Automatic.css and Cwicly.

One challenge with Cwicly is the lack of additional breakpoints. Automatic.css has four breakpoints by default, with support for up to six breakpoints. Cwicly only has two breakpoints.

By default, the “Tablet” breakpoint in Cwicly matches the “L” breakpoint in Automatic.css with a value of 992px, so you don’t have to change that one if you don’t want to.

The “Mobile” breakpoint in Cwicly (576px) doesn’t match any ACSS breakpoints by default, so we must adjust this. In our experience, 576px is too wide to get a good feel for how your site will render on most phones. We recommend changing this breakpoint value to match ACSS’s “S” breakpoint (480px).

Cwicly Breakpoint Setup

Backend Setup

This is not required for ACSS, but we recommend clicking on the “Backend” icon (the one in the middle) and then setting Dark Mode to “Dark” and “Inspector” to “Left” (optional).

Setting the Inspector to the left will give you a more traditional page builder experience, though many Cwicly users prefer the inspector stay on the right since that’s where the block inspector is natively in Gutenberg.

Setting Up Cwicly Builder Defaults

Font Setup

Next, navigate to the Typography Settings area by clicking the “A” icon.

Setting Global Typography Styles in Cwicly

Set your preferred font family for Body and Headings. We recommend making sure all other inputs here are unset. Automatic.css will handle all text sizing, line height, etc. for body text and headings.

Default Element Behavior

Cwicly allows you to set some default styling on certain elements. We recommend you set default styling on two elements in particular – the Section element and the Container element.

Navigate to the Elements Global Styles panel by clicking the 3D box icon. Then click the “Section” icon in the middle.

Setting Global Element Styles in Cwicly

If this area is blank, click the “+” icon to add a new element.

Add global styles for a Section element and click on it to open the styles panel. Once the styles panel is open, click the “Layout” icon.

Section Element Global Style in Cwicly

Set the default display property to “Flex” and the default flex-direction to “Column.” This will make it easier to use the --container-gap variable to space out your section’s inner containers.

Next, click the icon for the “Container” element.

Again, if this area is blank, click the “+” to add new global styles rules.

Container Element Global Style in Cwicly

With the styles panel for Container open, click the Sizing icon.

Set the width to “100%” and the max-width to var(--content-width).

This will sync your containers to the website width you set in Automatic.css.

Optional: Cwicly Support for Posts & CPTs

By default, we don’t load styles in the builder on posts or custom post types. This is due to the limitations of Gutenberg to know what type of content you’re creating (an actual post or a page layout).

Support for posts and CPTs exists, though, you just have to add it manually. Open your functions.php file and add the following:

add_filter(
    'acss/gutenberg/allowed_post_types',
    function( $post_types ) {
        return array_merge( $post_types, array( 'post' ) ); // Add your post types in the array().
    }
);
Code language: PHP (php)

This allows you to add support for posts/CPTs selectively.

We hope to improve this experience in the future.

You’re all set!

ACSS and Cwicly are now ready to work together. You can proceed with the rest of ACSS setup or begin building your site!