Animations & Interactions
Files: src/config/config.toml, section content files · Skill level: Beginner
Givo’s motion is calm on purpose: content fades in with a small rise, once, as it scrolls into view; amounts count up once; progress bars fill once. Hover effects change color or underline only. Every animation respects the visitor’s reduce motion setting.
Fade-In On Scroll
[settings.animation] enable = true respectReducedMotion = true easing = "cubic-bezier(0.215, 0.61, 0.355, 1)" # standard ease-out; avoid springy curves duration = "700ms" # reveal and intro duration distance = "1.25rem" # how far content rises while fading in rootMargin = "0px 0px -8% 0px" threshold = 0.14 # how much of an element is visible before it startsenable = falseshows everything at once, with no fade.- Keep
respectReducedMotion = true: some visitors get dizzy from motion. - Keep
distancesmall for a calm feel.
Content already in view when the page loads fades in right away, without waiting for a scroll. Without JavaScript, everything shows with no fade. The hero copy rises in once on page load, and the hero photo only fades.
Developers can add the effect to any element with the data-scroll-reveal attribute (most theme sections use data-scroll-reveal="fade-up"). data-scroll-reveal-delay and data-scroll-reveal-duration set the timing of one element, in milliseconds. The script is in src/layouts/components/widgets/GlobalScripts.astro, and the styles in src/styles/animation.css.
Count-Up Figures
Amounts and figures count up from zero once when they scroll into view:
- the raised amount, goal, and donor count on cause cards and at the top of each cause page
- the impact numbers (
metrics-section.md), on the homepages and wherever the section is used - the spending percentages of the gift split section
- the figures on
/impact/
list: - value: 18400 # sample label: "children started the school year with a full kit" - value: 6 # sample label: "wells drilled, tested, and handed to village committees"- Write
valueas a plain number. Text before or after it goes inprependValueorappendValue(for exampleappendValue: "+"). - The number follows the page language:
18,400in English shows as18 400in French. Arabic pages keep Western digits. - The page’s HTML always holds the final value, so search engines, screen readers, and visitors without JavaScript see the real number.
- With reduced motion, or
[settings.animation] enable = false, the final value shows at once.
Developers can add the effect to any element whose final text is already in the HTML with data-count-up (src/lib/countUp.ts). The number is counted, and the text around it stays as it is (“$48,900”, “86%”).
Progress Bars
The green bar of each cause (the goal thread) fills from empty to its share of the goal once, when it scrolls into view. With reduced motion, or without JavaScript, it is drawn full at once. The share comes from raised and goal in the cause file; see Causes & Campaign Progress.
Accordions And Disclosures
Questions in the FAQ sections slide open and closed. Other disclosures (the mobile menu groups, the footer columns on phones, Markdown accordions) slide too, in browsers that can animate to an automatic height; in others they open at once. With reduced motion, they all open without animation. The styles are in src/styles/animation.css.
The Header Menu
On large screens, every dropdown and the Causes mega menu share one panel. When a menu opens, the panel moves into place while it fades in. Moving between menus, the panel changes width, height, and position while the content slides across. With reduced motion, the panel only fades, and the mobile menu fades instead of sliding. There is no setting for it; the styles are in src/styles/navigation.css. See Navigation.
Gallery Lightbox
On /gallery/ and in the photo grid of a cause page, a photo opens full size in a lightbox with a short fade. Arrow keys and swipes move between photos, and Esc closes it. With reduced motion, it opens without the fade.
Smooth Scrolling
Givo ships with smooth scrolling on, powered by Lenis. It turns itself off on touch devices and for visitors who ask for reduced motion:
[settings.smoothScroll] enable = true respectReducedMotion = true duration = 1.1 # Higher value feels slower and smoother easing = "expo" # expo | linear | easeOutQuad | easeOutCubic smoothWheel = true syncTouch = false wheelMultiplier = 1 touchMultiplier = 1 anchors = true autoRaf = true stopInertiaOnNavigate = trueSet enable = false to use the browser’s normal scrolling. Keep respectReducedMotion = true. Your own scripts can reach Lenis as window.__themeLenis, which only exists where smooth scroll is running. Smooth Scroll explains every key.
Other Interactions
These are not animations to configure, but they respond as visitors use them:
| Where | What it does |
|---|---|
| Donation form | Choosing an amount or switching between one-time and monthly updates the impact receipt and the button total at once |
| Donate bar on phones | Slides away while the footer is visible, while a form field has focus, and while the menu or a dialog is open ([settings.mobileActionBar]) |
| Buttons | hoverEffect: "text-flip" flips the label on hover (see Common Changes) |
| Light/dark switch | Changes the colors at once, with no fade |
Do It With AI
Make the animations on my Givo site [calmer | off]: in [settings.animation] ofsrc/config/config.toml, [set enable = false | set duration to "500ms" and distance to "0.75rem"].Keep respectReducedMotion = true and don't change [settings.smoothScroll]. Then tell me which pagesto check.