Skip to content
Skills Library
Programming · Building & coding

hyper-effects

/hyper-effects

Use when building or troubleshooting Flutter UI with package:hyper_effects, including state-driven animation, mount entrances, springs, rolling text, layout size, hover/press feedback, scroll transitions, timelines, TimelineController, keyframe sequencing, loops, or migration to version 0.4.0.

Licence
BSD-3-Clause
Last repository change
20.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 20.10.2026, without references to retired models or APIs.

Licence

BSD-3-Clause, otwarta.

What it does and when to use it

Use when building or troubleshooting Flutter UI with package:hyper_effects, including state-driven animation, mount entrances, springs, rolling text, layout size, hover/press feedback, scroll transitions, timelines, TimelineController, keyframe sequencing, loops, or migration to version 0.4.0.

Original author description

Use when building or troubleshooting Flutter UI with package:hyper_effects, including state-driven animation, mount entrances, springs, rolling text, layout size, hover/press feedback, scroll transitions, timelines, TimelineController, keyframe sequencing, loops, or migration to version 0.4.0.

How it works

  1. Choose the driver
  2. Contracts to preserve
Original SKILL.md headings · 41 lines, 466 words
SKILL.md preview
---
name: hyper-effects
description: Use when building or troubleshooting Flutter UI with package:hyper_effects, including state-driven animation, mount entrances, springs, rolling text, layout size, hover/press feedback, scroll transitions, timelines, TimelineController, keyframe sequencing, loops, or migration to version 0.4.0.
---

# Hyper Effects

For Hyper Effects **0.4.0**. Check the consuming app's resolved version before applying this reference; older releases have different APIs.

## Choose the driver

| Intent | API |
| --- | --- |
| Static appearance | Effect extensions without a driver |
| React to state or replay an event | `.animate(trigger: value)` |
| Entrance once per mounted State | `.immediate()` |
| Entrance and later trigger changes | `.animate(trigger: value, startState: AnimationStartState.eager)` |
| Sequential absolute keyframes | `.step(...).timeline(...)` |
| Pointer or scroll response | `.pointerTransition(...)` / `.scrollTransition(...)` |

Effects wrap widgets. An animation drives its descendant effect scope; nested drivers create independent scopes, not a sequence. Keep widget identity stable across state changes.

Use widget classes for reusable UI, not widget-returning helper functions. The short example below belongs inside `build`, with Flutter material and Hyper Effects imported.

```dart
return Text('$count')
    .roll(widthCurve: Curves.easeOut)
    .animate(trigger: count, duration: const Duration(milliseconds: 250));
```

`Text.roll()` reads the receiver's current text and retains its previous value. It takes **named options only**, not a replacement string. Call it before other extensions erase the receiver's `Text` type. For arbitrary widgets, use `Widget.roll()` with distinct child keys; its options are `slideInDirection`, `slideOutDirection`, `multiplier`, and `useSnapshots`.

## Contracts to preserve

- `trigger` changes use equality comparison. Use an incrementing integer for repeated events; repeatedly assigning `true` is not a new event.
- Default `lazy` mounts at starting values and waits. `eager` plays on mount and keeps the trigger live. `#immediate` occupies the trigger slot; ordinary rebuilds do not replay it, but a new State does.
- Use explicit `from:` for deliberate entrances/replays. For ordinary retargeting, preserve effect identity and derive the destination and trigger from state; do not blindly add a fixed origin.
- Choose `motion:` **or** `duration:`/`curve:`, never both. Cupertino spring duration is perceptual, not exact settling time.
- True vector springs support translation, scale, rotation, opacity, padding, alignment and size. Blur, clipping and other non-vector effects use a normalized interpolation fallback: no guaranteed physical overshoot or velocity handoff. Prefer curved motion when that distinction matters.
- `playIf: false` does not drive to the destination. `skipIf: true` jumps there without playback **or `onEnd`**. Reduced-motion entrances generally need the latter; completion-dependent UI needs an explicit skipped path.
- Layout: `.widthTo()`, `.heightTo()`, `.sizeTo()`, `.sizeOf()` change layout; `.scale()` changes paint. Null size axes/factors represent layout modes, not zero-sized endpoints.
- Translation hit tests move by default, but ancestor bounds still constrain hit testing. Hidden controls need an interaction policy such as `IgnorePointer`.

Read [recipes and pitfalls](references/recipes.md) for effects and interaction. For sequencing, loops, scrubbing, or migration from animateAfter, read [timelines](references/timelines.md). Verify snippets with `flutter analyze` and widget tests in the consuming package. Test mount, retrigger, interruption, reduced motion and actual tap positions where relevant. Use finite pumps for infinite loops.
Files in this package (3)
  • SKILL.md 4 KB
  • references/recipes.md 5 KB
  • references/timelines.md 7 KB

Versions

The database has no other skills named hyper-effects.

Database snapshot: 13.11.2026 · package version 5f4804fc7b7d (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100flutter-animating-apps
    Implements animated effects, transitions, and motion in a Flutter app. Use when adding visual feedback, shared element transitions, or physics-based animations.
  • 100animations
    Animation knowledge base - Framer Motion, CSS animations, scroll effects, best practices. Use when adding animations, transitions, motion effects, or scroll-triggered effects to UI components.
  • 100animation-patterns
    SwiftUI animation patterns including springs, transitions, PhaseAnimator, KeyframeAnimator, SF Symbol effects, scroll-driven effects, mesh gradients, text renderers, and shader effects. Use when implementing, reviewing, or fixing animation or visual-effect code on iOS/macOS.
  • 100animation-recipe-library
    200+ copy-paste animation recipes in CSS, Framer Motion, and GSAP: entrances, micro-interactions, page transitions, scroll-driven effects, spring physics, and cursor and text effects, each with timing, easing, and a reduced-motion fallback. Use when you need working motion code…
  • 100motion
    Motion (formerly Framer Motion) is an animation library for React that animates components through declarative props. Use when adding fade-ins, hover and tap effects, exit animations with AnimatePresence, layout and shared-element transitions, scroll-linked or scroll-triggered…
  • 100gsap
    GSAP is a JavaScript animation library for tweens, timelines, scroll-driven animation (ScrollTrigger), SVG morphing and text splitting. Use it when building complex timelines, scroll-linked animations, SVG morphing, text animations, or high-performance web animations beyond CSS capabilities.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.