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.
PTSD in Adult Children of Alcoholics: Signs and Support
Growing up with a parent who drinks too much often means always waiting for the next problem: a broken promise, an angry outburst, a holiday that falls apart. As a kid, you may have learned to read the room, keep quiet, or take care of everyone else. Those habits helped you get through it. Now […]
What the First Month of Recovery Can Look Like
Starting recovery can bring relief and fear at the same time. You may feel hopeful about finally getting help while also feeling exhausted, anxious, irritable, or unsure you can do this. Several of these feelings can exist at once, sometimes within the same hour. If someone you love is starting treatment, you may be carrying […]
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.
The Postpartum Mental Health Spectrum, Explained
The weeks after childbirth can be emotionally intense. Exhaustion, physical recovery, and the demands of caring for a newborn can make it difficult to know whether a new parent is going through an expected adjustment or needs more help. Postpartum mental health concerns exist on a spectrum. The baby blues are common and usually short-lived. […]
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.
Can GLP-1s Help With Stimulant Cravings? What the Research Shows
GLP-1 medications like Ozempic and Wegovy were built to treat diabetes and support weight loss. Along the way, researchers noticed something they didn’t expect: some people taking them also lost interest in alcohol and cigarettes. That raised a bigger question. If these drugs can quiet cravings for some substances, could they help with stimulants like […]
Who Is a Good Candidate for GLP-1 Medication in Addiction Treatment?
For some people, cravings are one of the hardest parts of early recovery. When they’re strong enough, they can make it difficult to stay engaged in treatment, or to begin treatment at all. Finding ways to ease that intensity can make a meaningful difference in whether someone is able to do the work of recovery. […]
Is Weight Gain Normal in Addiction Recovery?
Weight changes are common during addiction recovery, and they can happen for several reasons. Substance use can affect appetite, digestion, hydration, sleep, metabolism, and eating patterns. When use stops, the body begins adjusting to regular meals, new medications, different activity levels, and more consistent care. For some people, that adjustment includes weight gain. It may […]
What to Ask Your Doctor Before Taking a GLP-1 in Recovery
GLP-1 medications have become part of a much bigger conversation than diabetes, weight loss, or appetite. More people are asking whether medications like Ozempic, Wegovy, Mounjaro, and Zepbound may also affect cravings for alcohol, nicotine, or other substances. For someone in recovery, that can bring up real hope and real caution at the same time. […]
Can Semaglutide Help With Alcohol Cravings?
Semaglutide has become known for treating type 2 diabetes and supporting weight management. Now, researchers are asking a different question: could it also help reduce alcohol cravings? For someone struggling with alcohol use, that question can feel personal. Cravings can be loud, distracting, and hard to explain. They can show up after a stressful day, […]
Multiple Gallery Image Gallery
No images found.
No images found.