Generalizing this theme for usage
- Delete all posts
- Update the Site Logo below (favicon, square-based)
- Empty Media Library, besides the Site Logo you just uploaded
- This will break the image galleries below
- Delete boilerplate SCSS in main.scss (keep all the rest)
- Disable any default Block Variants this brand doesn’t use
- Add in per-design Block Styles and Variants
Animation Primer & Library
Animations are managed using both an animated element, and its parent. The parent receives a class named .has-animation, which works in tandem with some JavaScript code. That code runs on page load, and then every time the page is scrolled.
Once an element has been detected as scrolled into view, the parent is appended an additional class, named .has-been-revealed. With minimal exceptions, animations are only triggered on elements with a specific animation class, that is the child of an element bearing both the classes .has-animation and .has-been-revealed.
Basic Animations
.fade-in-up.fade-in-right.fade-in-down.fade-in-right.reveal-in.draw-in-line.draw-in-line-80Like the above animations, leverages the class .has-animation but also the class (on parent still) of .has-image-animation.
Advanced Animations
Tilted Text Animation:
- As seen on Astute Homepage
- Limited as it does not flow like real text — text is grouped by line, then sub-grouped by word
Retro Machinery Animation:
- As seen on Astute 404
- Static layer overlaid with two reels, underlaid by two additional reels through transparencies in main layer
Scroll-based Rings:
- As seen on Astute Services
- Outermost ring stays static
- Other two rings rotate with scroll up/down
- Middle ring rotates clockwise/counterclockwise
- Innermost ring rotates counterclockwise/clockwise
Scroll-based Globe:
- As seen on KSG Homepage
- Scroll-based triggers to paginate text alongside animation
- Most complexity in terms of planning for active and idle states of globe
SCSS Architecture
|sass/
| - meta.scss # WP Header Comments for style meta
|
|– utils/ # Misc stuff like variables, helper classes, functions, mix-ins, and animation stuff
| |– _variables.scss # Sass Variables
| |– _functions.scss # Sass Functions
| |– _mixins.scss # Sass Mixins
| |– _helpers.scss # Class & placeholders helpers
| |– animations.scss # Class & placeholders helpers
|
|– base/ # Boilerplate, typography, normalizing -- shouldn't need edits
| |– normalize.scss # Reset/normalize
| |– _typography.scss # Typography rules
| ... # Etc…
|
|– layout/ # Globals, grid system, forms, etc.
| |– _navigation.scss # Navigation
| |– _header.scss # Header
| |– _footer.scss # Footer
| |– _forms.scss # Forms
| ... # Etc…
|
|– components/ # Styles specific to widgets -- overrides for ACF Blocks go here
| |– _buttons.scss # Buttons -- includes default permutations
| |– _carousel.scss # Carousel
| |– _cover.scss # Cover
| |– _dropdown.scss # Dropdown
| ... # Etc…
|
|– sections/ # Styles specific to pages
| |– _home.scss # Home specific styles
| |– _contact.scss # Contact specific styles
| ... # Etc…
|
| – main.scss # Primary Sass file -- only @import and comments in here
Anatomy of a Style Guide
Font Faces, Weights, Styles, Sizes
- List out all font families used
- List out all font weights used in those families
- Styles refers to normal vs. italics, so just call out if any fonts should also have their italics variant registered (if applicable, not off font families offer italics)
- All font sizes used, even one-offs like copyright text only used in a single place
Each Unique Text Element Instance
- Paragraphs, Headings, List Items
- Any permutations of those items
- One-off text variants are still Paragraphs like “Label” or whatnot
- Additional styles for semantic headings, such as if the H1 on Homepage differs from how an H1 would look on a Blog Post
- Unordered list variants besides default bullet (see top level of this list)
- Ordered list variants (number, letter, Roman num, etc.), if applicable
Other Relevant Elements
- Callout any element with more than one permutation
- Buttons, specifically color changes and functionality such as play buttons
- Block Quotes
Paragraphs & Text Variants
This is normal text.
This is some fancy variant.
This is some other fancy variant
Headings
Heading 1
Heading 2
Heading 3
Heading 4
Heading 5
Heading 6
List Styles
- This is an
- unordered list
- using default bullets
- This is an
- ordered list
- using numbers
Button Styles
ACF Custom Blocks /acf-blocks/
Blog Category Filter and API Blog Listing (two blocks)
Category block doesn’t work without the API Blog Listing block.
Breadcrumb (Dynamic)
Only works if the page has a parent page, otherwise it assumes you wanna go 🏠. Includes plain, chevron, and arrow (for now, and counting).
Flex Divider (Colorable)
Vertical line on desktop; horizontal line on mobile. There is no native vertical line in HTML, but there is for horizontal.
Hamburger Toggle (Colorable)
Must be implemented in conjunction with the meganav (see header).
Expanding Bio
Line height will look wonky pending your brand choice, will need to be refined on a per-site basis (quick and easy to do that, though).
FAQ Items (w/ Category Filter)
Filter does not render on mobile.
All
Category One
Category Two
Category One
Example Item One
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque sodales, nulla vel tristique euismod, orci erat laoreet massa, vitae accumsan augue tellus aliquet tortor. Mauris ante tortor, varius nec posuere vitae, tincidunt at tortor. Sed malesuada elementum sollicitudin. Quisque ornare neque quis orci laoreet egestas eu at justo. Vestibulum a congue nunc. Nulla ultricies tortor vel nunc rutrum scelerisque. Sed accumsan aliquet ex sit amet congue. Phasellus eu nibh ipsum. Nunc dapibus, odio sit amet tempus interdum, purus quam accumsan turpis, nec posuere metus elit vitae ipsum. Praesent non lorem id tellus pretium lacinia. Nunc porta lectus mi, eu ornare ipsum facilisis a. Nam et eros aliquet, tristique lorem ac, congue nisi. Sed faucibus ornare diam sed ultrices. Suspendisse quis blandit orci. Phasellus dictum dictum sapien eget tempus. Curabitur ut vestibulum erat.
Example Item One
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque sodales, nulla vel tristique euismod, orci erat laoreet massa, vitae accumsan augue tellus aliquet tortor. Mauris ante tortor, varius nec posuere vitae, tincidunt at tortor. Sed malesuada elementum sollicitudin. Quisque ornare neque quis orci laoreet egestas eu at justo. Vestibulum a congue nunc. Nulla ultricies tortor vel nunc rutrum scelerisque. Sed accumsan aliquet ex sit amet congue. Phasellus eu nibh ipsum. Nunc dapibus, odio sit amet tempus interdum, purus quam accumsan turpis, nec posuere metus elit vitae ipsum. Praesent non lorem id tellus pretium lacinia. Nunc porta lectus mi, eu ornare ipsum facilisis a. Nam et eros aliquet, tristique lorem ac, congue nisi. Sed faucibus ornare diam sed ultrices. Suspendisse quis blandit orci. Phasellus dictum dictum sapien eget tempus. Curabitur ut vestibulum erat.
Category Two
Example Item Two
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque sodales, nulla vel tristique euismod, orci erat laoreet massa, vitae accumsan augue tellus aliquet tortor. Mauris ante tortor, varius nec posuere vitae, tincidunt at tortor. Sed malesuada elementum sollicitudin. Quisque ornare neque quis orci laoreet egestas eu at justo. Vestibulum a congue nunc. Nulla ultricies tortor vel nunc rutrum scelerisque. Sed accumsan aliquet ex sit amet congue. Phasellus eu nibh ipsum. Nunc dapibus, odio sit amet tempus interdum, purus quam accumsan turpis, nec posuere metus elit vitae ipsum. Praesent non lorem id tellus pretium lacinia. Nunc porta lectus mi, eu ornare ipsum facilisis a. Nam et eros aliquet, tristique lorem ac, congue nisi. Sed faucibus ornare diam sed ultrices. Suspendisse quis blandit orci. Phasellus dictum dictum sapien eget tempus. Curabitur ut vestibulum erat.
Example Item Two
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque sodales, nulla vel tristique euismod, orci erat laoreet massa, vitae accumsan augue tellus aliquet tortor. Mauris ante tortor, varius nec posuere vitae, tincidunt at tortor. Sed malesuada elementum sollicitudin. Quisque ornare neque quis orci laoreet egestas eu at justo. Vestibulum a congue nunc. Nulla ultricies tortor vel nunc rutrum scelerisque. Sed accumsan aliquet ex sit amet congue. Phasellus eu nibh ipsum. Nunc dapibus, odio sit amet tempus interdum, purus quam accumsan turpis, nec posuere metus elit vitae ipsum. Praesent non lorem id tellus pretium lacinia. Nunc porta lectus mi, eu ornare ipsum facilisis a. Nam et eros aliquet, tristique lorem ac, congue nisi. Sed faucibus ornare diam sed ultrices. Suspendisse quis blandit orci. Phasellus dictum dictum sapien eget tempus. Curabitur ut vestibulum erat.
“Details” Items (FAQ but w/o Filter)
Example Category
Example Item
Example Item
Search Results (Colorable)
Dynamically shows results from search query when added to a “Search” Gutenberg template. If not part of that template, will render a list of all pages.
Coping With Anxiety: Ways to Calm Your Mind and Regain Control
While anxiety can be overwhelming, it doesn’t have to control your life. If you’re ready to feel more like yourself again, try these anxiety coping mechanisms.
Why Co-Occurring Disorders Are Common & How to Treat Them
Learn why co-occurring disorders—addiction and mental health—are so common, how they interact, and why treating both is key to recovery.
Inpatient, Outpatient, or IOP? How to Choose the Right Treatment
Selecting the right program depends on the level of care required and where you are in your recovery journey. Explore the most common treatment options here.
The Role of Shame in Addiction
Shame and guilt are deeply intertwined in addiction, often acting as the emotional drivers that keep people stuck in a harmful cycle. Here, we define that cycle and give guidance on how to break it.
5 Ways to Practice Self-Forgiveness in Recovery
Self-forgiveness is essential for healing and moving forward in recovery. Use this insight to learn how to practice it in your own journey.
Signs That You Need Help for Sex Addiction
It’s not always easy to recognize when something has crossed the line from a normal, healthy sexual interest to something more compulsive. However, if you can recognize the signs, you’ll be in a better position to find or offer support.
Family Roles in Addiction and Their Impact on Recovery
Addiction and recovery are extremely personal experiences. However, your family (whether biological or chosen) is also impacted by your addiction, and can play an integral role in your recovery.
Is Alcoholism Genetic? Defining the Common Causes
What exactly pushes someone into the category of struggling with alcoholism? In this blog post, we’ll define the factors that contribute to alcoholism including genetics, lifestyle, personal history, and more.
What is Emotional Dysregulation? Definition, Symptoms & Treatments
If you or a loved one experiences frequent mood changes or has trouble managing emotions, you may be dealing with emotional dysregulation. Here’s what that means and what you can do about it.
How to Heal From Complex Trauma: 3 Phases of Recovery
Complex trauma can be a heavy and often misunderstood experience. In this blog post, we’ll help you understand the symptoms and impact of complex trauma and explore the steps to recovery.
Multiple Gallery Image Gallery
No images found.
No images found.