SKILL.md
$27
2. Structural Requirements for Immersive UI
When scaffolding a page or generating core components, include the following architectural layers to transform a standard page into an experience.
2.1 The Entry Sequence (Preloading & Initialization)
A blank screen is unacceptable. The user's first interaction must set expectations.
- Implementation: Generate a lightweight preloader component that handles asset resolution (fonts, initial images, 3D models).
- Animation: Output code that transitions the preloader away fluidly—such as a split-door reveal, a scale-up zoom, or a staggered text sweep.
2.2 The Hero Architecture
The top fold must command attention immediately.
- Visuals: Output code that implements full-bleed containers (
100vh/100dvh).
- Typography Engine: Ensure headlines are broken down syntactically (e.g., span wrapping by word or character) to allow for cascading entrance animations.
- Depth: Utilize subtle floating elements or background clipping paths to create a sense of scale and depth behind the primary copy.
2.3 Fluid & Contextual Navigation
- Implementation: Do not generate standard static navbars. Output sticky headers that react toscroll direction (hide on scroll down, reveal on scroll up).
- Interactivity: Include hover states that reveal rich content (e.g., mega-menus that display image previews of the hovered link).
3. The Motion Design System
Animation is not an afterthought; it is the connective tissue of a premium site. Always implement the following motion principles:
3.1 Scroll-Driven Narratives
Generate code utilizing modern scroll libraries (like GSAP's ScrollTrigger) to tie animations to user progress.
- Pinned Containers: Create sections that lock into the viewport while secondary content flows past or reveals itself.
- Horizontal Journeys: Translate vertical scroll data into horizontal movement for specific galleries or showcases.
- Parallax Mapping: Assign subtle, varying scroll-speeds to background elements, midground text, and foreground imagery.
3.2 High-Fidelity Micro-Interactions
The cursor is the user's avatar. Build interactions around it.
- Magnetic Components: Write logic that calculates the distance between the mouse pointer and a button, pulling the button towards the cursor dynamically.
- Custom Tracking Elements: Generate custom cursor components that follow the mouse with calculated interpolation (lerp) for a smooth drag effect.
- Dimensional Hover States: Use CSS Transforms (
scale,rotateX,translate3d) to give interactive elements weight and tactile feedback.
4. Typography & Visual Texture
The aesthetics of your generated code must reflect premium craftsmanship.
- Type Hierarchy: Enforce massive contrast in scale. Headlines should utilize extreme sizing (
clamp()functions spanning up to12vw), while body copy remains incredibly crisp (16px-18pxminimum).
- Font Selection: Always recommend or implement highly specified variable fonts or premium typefaces over system defaults.
- Atmospheric Filters: Implement CSS/SVG noise overlays (
mix-blend-mode: overlay, opacity0.02 - 0.05) to remove digital sterility and add photographic grain.
- Lighting & Glass: Utilize
backdrop-filter: blur(x)combined with ultra-thin, semi-transparent borders to create modern, frosted-glass depth.
5. The Performance Imperative
A beautiful site that stutters is a failure. Enforce strict performance guardrails in all generated code:
- Hardware Acceleration: Only animate properties that do not trigger layout recalculations:
transformandopacity. Code that animateswidth,height,top, ormarginshould be fiercely avoided.
- Render Optimization: Apply
will-change: transformintelligently on complex moving elements, but remove it post-animation to conserve memory.
- Responsive Degradation: Wrap custom cursor logic and heavy hover animations in
@media (hover: hover) and (pointer: fine)to ensure pristine performance on touch devices.
- Accessibility: Wrap heavy continuous animations in
@media (prefers-reduced-motion: no-preference). Never sacrifice user accessibility for aesthetic flair.
6. Implementation Ecosystem
When the user asks you to implement these patterns, leverage industry-standard libraries tailored to their framework:
For React / Next.js Targets
- Structure the application to support Framer Motion for layout transitions and spring physics.
- Recommend Lenis (
@studio-freight/lenis) for smooth scrolling context.
- Implement React Three Fiber (
@react-three/fiber) if webGL or 3D interactions are requested.
For Vanilla / HTML / Astro Targets
- Rely heavily on GSAP (GreenSock Animation Platform) for timeline sequencing.
- Utilize vanilla Lenis via CDN for scroll hijacking and smoothing.
- Use SplitType for safe, accessible typography chunking.
Summary of Action
Whenever you receive a prompt to "Build a premium landing page," "Create an Awwwards-style component," or "Design an immersive UI," you must automatically:
- Wrap the output in a robust, scroll-smoothed architecture.
- Provide CSS that guarantees perfect performance using composited layers.
- Integrate sweeping, staggered component entrances.
- Elevate the typography using fluid scales.
- Create an intentional, memorable aesthetic footprint.