Claude Skill

andy-liquid

Three.js liquid metal / bloom 3D animation video renderer using React + Three.js

LLM Mart · 0 points · 3 views 0 listing impressions 0 install-command copies
Download aipmandy-andy-video-skill-01-programmatic-animation_andy-liquid-27683b8.zip · 111 KB

Install

skills CLI npx skills add https://github.com/AIPMAndy/Andy-Video-Skill/tree/main/01-programmatic-animation/andy-liquid
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install aipmandy-andy-video-skill@llmmart
Git git clone https://github.com/AIPMAndy/Andy-Video-Skill.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole aipmandy/andy-video-skill collection as a plugin from our marketplace. Git is the plain clone.

README

Andy Liquid

Andy Liquid License TypeScript React

为现代 Web 应用打造的顶级液态与玻璃效果库

English | 示例 | 文档 | 贡献


✨ 核心特性

🌊 液态画布 - 基于 Three.js 的 3D 液态扭曲效果,带来流动的视觉冲击
🪟 玻璃面板 - 完美还原 Apple 风格的玻璃态效果,支持无障碍访问
🎯 流体按钮 - 磁吸式悬停效果,物理级弹簧动画
🔄 形态过渡 - 丝滑的形状变换动画
🧭 液态导航 - 浮岛和 Dock 风格导航栏

🚀 快速开始

安装

# npm
npm install @andy-liquid/react

# pnpm
pnpm add @andy-liquid/react

# bun
bun add @andy-liquid/react

基础使用

import { LiquidCanvas, GlassPanel, FluidButton } from '@andy-liquid/react'

export default function App() {
  return (
    <div className="relative min-h-screen">
      {/* 液态背景 */}
      <LiquidCanvas 
        text={["Hello", "World"]}
        intensity={7}
        metalness={0.35}
        roughness={0.45}
        enableRain={true}
      />
      
      {/* 玻璃面板 */}
      <GlassPanel 
        variant="medium"
        className="max-w-2xl mx-auto mt-20 p-8"
      >
        <h1 className="text-4xl font-bold mb-4">
          欢迎来到液态世界
        </h1>
        <p className="text-gray-600">
          体验顶级视觉效果带来的极致交互
        </p>
        
        {/* 流体按钮 */}
        <FluidButton
          variant="primary"
          magnetic={true}
          onClick={() => console.log('Clicked!')}
        >
          开始探索
        </FluidButton>
      </GlassPanel>
    </div>
  )
}

📦 包结构

包名 描述 状态
@andy-liquid/core 核心效果引擎 ✅ 可用
@andy-liquid/react React 组件封装 ✅ 可用
@andy-liquid/vue Vue 组件 🚧 开发中
@andy-liquid/svelte Svelte 组件 📋 计划中

🎨 组件

LiquidCanvas - 液态画布

3D 液态扭曲背景效果,基于 Three.js 实现。

<LiquidCanvas 
  text={["你的", "文字"]}
  intensity={7}           // 扭曲强度 1-10
  metalness={0.35}        // 金属度 0-1
  roughness={0.45}        // 粗糙度 0-1
  displacementScale={2}   // 位移缩放
  enableRain={true}       // 雨滴效果
  className="custom-class"
/>

特点:

  • 🎭 动态文字纹理生成
  • 🌈 可自定义材质属性
  • ⚡ 高性能 WebGL 渲染
  • 📱 响应式适配
  • 🎨 支持自定义样式

GlassPanel - 玻璃面板

Apple 风格的玻璃态效果,带模糊背景和半透明。

<GlassPanel 
  variant="light"      // light | medium | dark
  blur="default"       // subtle | default | strong
  className="p-6"
>
  你的内容
</GlassPanel>

变体:

  • light - 轻度模糊,高透明度
  • medium - 中度模糊,适中透明度
  • dark - 深度模糊,低透明度

FluidButton - 流体按钮

带磁吸和弹簧动画的交互式按钮。

<FluidButton
  variant="primary"    // primary | secondary | ghost
  magnetic={true}      // 磁吸效果
  springConfig={{      // 弹簧配置
    tension: 300,
    friction: 20
  }}
  onClick={handleClick}
>
  点击我
</FluidButton>

特性:

  • 🧲 磁吸式鼠标跟随
  • 🌊 流体动画过渡
  • ⚙️ 可配置弹簧物理
  • 🎯 完整的键盘支持

🎯 设计理念

Andy Liquid 融合了顶级设计实践:

  • 🍎 Apple 液态玻璃 - 借鉴 iOS/macOS 的玻璃态设计语言
  • 🎬 高端视觉 - 对标国际一线代理商的视觉标准
  • ⚡ 性能优先 - 60fps 流畅动画,优化的资源加载
  • ♿ 无障碍访问 - 符合 WCAG 标准,完整的键盘和屏幕阅读器支持
  • 🎨 高度可定制 - 灵活的配置选项,适应各种设计需求

🛠️ 技术栈

  • TypeScript - 类型安全的开发体验
  • React 19 - 最新的 React 特性
  • Three.js - 强大的 3D 图形库
  • Framer Motion - 流畅的动画库
  • Tailwind CSS - 实用优先的样式方案
  • Turbo - 高性能 Monorepo 构建

🎪 在线演示

查看完整的交互式示例:

📖 完整文档

访问 andy-liquid.dev 获取:

  • 📘 完整 API 文档
  • 🎓 使用教程
  • 🎨 设计指南
  • 💡 最佳实践
  • 🔧 迁移指南

🤝 贡献

欢迎贡献代码、报告问题或提出建议!

  1. Fork 本仓库
  2. 创建你的特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交你的改动 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启 Pull Request

查看 CONTRIBUTING.md 了解详细指南。

📄 开源协议

MIT © Andy - 自由使用,保留署名

🙏 致谢

本项目基于以下优秀的开源项目:

🌟 Star History

如果这个项目对你有帮助,请给个 Star ⭐

Star History Chart


English

Premium liquid and glass effects library for modern web applications

✨ Features

🌊 Liquid Canvas - Three.js powered 3D liquid distortion effects
🪟 Glass Panels - Apple-style glassmorphism with accessibility
🎯 Fluid Buttons - Magnetic hover with spring physics
🔄 Morph Transitions - Smooth shape-shifting animations
🧭 Liquid Navigation - Floating island and dock-style navigation

🚀 Quick Start

Installation

npm install @andy-liquid/react

Basic Usage

import { LiquidCanvas, GlassPanel } from '@andy-liquid/react'

export default function App() {
  return (
    <div>
      <LiquidCanvas 
        text={["Hello", "World"]}
        intensity={7}
      />
      <GlassPanel variant="medium">
        <h1>Beautiful Glass Effect</h1>
      </GlassPanel>
    </div>
  )
}

📦 Packages

  • @andy-liquid/core - Core effects engine
  • @andy-liquid/react - React components
  • @andy-liquid/vue - Vue components (coming soon)
  • @andy-liquid/svelte - Svelte components (planned)

🎨 Design Philosophy

Andy Liquid integrates best practices from:

  • 🍎 Apple's Liquid Glass design language
  • 🎬 High-end agency visual standards
  • ⚡ Performance-first fluid animations
  • ♿ WCAG accessibility compliance

📖 Documentation

Visit andy-liquid.dev for complete documentation.

🤝 Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

📄 License

MIT © Andy

🙏 Credits

Built upon:

Skill manifest

Andy Liquid

Three.js-based 3D liquid metal animation renderer. Produces professional-grade visual effects for video: bloom post-processing, particle systems, dynamic camera movements.

Quick Start

cd andy-liquid
pnpm install
pnpm build

Use Cases

  • Brand launch videos
  • Cinematic intros
  • Generative art backgrounds

See README.md for full documentation.

Files (andy-video-skill)
  • .agents
    • skills
      • andy-liquid
        • SKILL.md 7.3 KB
          Loading…
  • .github
    • workflows
      • ci.yml 492 B
        Loading…
    • CI-TEST.md 14 B
      Loading…
  • apps
    • example
      • app
        • test
          • page.tsx 495 B · in bundle
        • favicon.ico 25.3 KB · in bundle
        • globals.css 488 B · in bundle
        • layout.tsx 1.1 KB · in bundle
        • page.tsx 2.9 KB · in bundle
      • public
        • file.svg 391 B · in bundle
        • globe.svg 1 KB · in bundle
        • next.svg 1.3 KB · in bundle
        • vercel.svg 128 B · in bundle
        • window.svg 385 B · in bundle
      • .gitignore 480 B · in bundle
      • AGENTS.md 327 B
        Loading…
      • CLAUDE.md 11 B
        Loading…
      • eslint.config.mjs 465 B · in bundle
      • next.config.ts 133 B
        Loading…
      • package.json 642 B
        Loading…
      • pnpm-workspace.yaml 54 B
        Loading…
      • postcss.config.mjs 94 B · in bundle
      • README.md 1.4 KB
        Loading…
      • tsconfig.json 666 B
        Loading…
  • design
    • principles.md 4.8 KB
      Loading…
  • examples
    • README.md 3.5 KB
      Loading…
  • packages
    • core
      • src
        • components
          • LiquidCanvas
            • engine.ts 5.4 KB
              Loading…
            • index.ts 146 B
              Loading…
            • types.ts 704 B
              Loading…
        • effects
          • magnetic.ts 2.6 KB
            Loading…
          • ripple.ts 2.7 KB
            Loading…
        • styles
          • glass.css 3.4 KB · in bundle
          • liquid.css 2.6 KB · in bundle
        • utils
          • physics.ts 2.2 KB
            Loading…
          • webgl-helper.ts 2.3 KB
            Loading…
        • index.ts 506 B
          Loading…
      • eslint.config.mjs 234 B · in bundle
      • package.json 892 B
        Loading…
      • tsconfig.json 630 B
        Loading…
      • tsup.config.ts 206 B
        Loading…
    • react
      • src
        • components
          • FluidButton.tsx 2.8 KB · in bundle
          • GlassPanel.tsx 1.1 KB · in bundle
          • LiquidCanvas.tsx 2.2 KB · in bundle
        • hooks
          • useMagneticHover.ts 569 B
            Loading…
          • useRipple.ts 544 B
            Loading…
        • index.ts 642 B
          Loading…
      • eslint.config.mjs 719 B · in bundle
      • package.json 1.1 KB
        Loading…
      • tsconfig.json 654 B
        Loading…
      • tsup.config.ts 226 B
        Loading…
  • .gitignore 81 B · in bundle
  • .prettierrc 127 B · in bundle
  • CONTRIBUTING.md 2.5 KB
    Loading…
  • LICENSE 1.4 KB · in bundle
  • package.json 938 B
    Loading…
  • pnpm-lock.yaml 179.2 KB
    Loading…
  • pnpm-workspace.yaml 40 B
    Loading…
  • PROJECT_SUMMARY.md 5.3 KB
    Loading…
  • README.md 7.7 KB
    # Andy Liquid
    
    <div align="center">
    
    ![Andy Liquid](https://img.shields.io/badge/Andy-Liquid-00D9FF?style=for-the-badge)
    ![License](https://img.shields.io/badge/license-MIT-green?style=for-the-badge)
    ![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue?style=for-the-badge)
    ![React](https://img.shields.io/badge/React-19-61DAFB?style=for-the-badge)
    
    **为现代 Web 应用打造的顶级液态与玻璃效果库**
    
    [English](#english) | [示例](#-快速开始) | [文档](#-组件) | [贡献](#-贡献)
    
    </div>
    
    ---
    
    ## ✨ 核心特性
    
    🌊 **液态画布** - 基于 Three.js 的 3D 液态扭曲效果,带来流动的视觉冲击  
    🪟 **玻璃面板** - 完美还原 Apple 风格的玻璃态效果,支持无障碍访问  
    🎯 **流体按钮** - 磁吸式悬停效果,物理级弹簧动画  
    🔄 **形态过渡** - 丝滑的形状变换动画  
    🧭 **液态导航** - 浮岛和 Dock 风格导航栏  
    
    ## 🚀 快速开始
    
    ### 安装
    
    ```bash
    # npm
    npm install @andy-liquid/react
    
    # pnpm
    pnpm add @andy-liquid/react
    
    # bun
    bun add @andy-liquid/react
    ```
    
    ### 基础使用
    
    ```tsx
    import { LiquidCanvas, GlassPanel, FluidButton } from '@andy-liquid/react'
    
    export default function App() {
      return (
        <div className="relative min-h-screen">
          {/* 液态背景 */}
          <LiquidCanvas 
            text={["Hello", "World"]}
            intensity={7}
            metalness={0.35}
            roughness={0.45}
            enableRain={true}
          />
          
          {/* 玻璃面板 */}
          <GlassPanel 
            variant="medium"
            className="max-w-2xl mx-auto mt-20 p-8"
          >
            <h1 className="text-4xl font-bold mb-4">
              欢迎来到液态世界
            </h1>
            <p className="text-gray-600">
              体验顶级视觉效果带来的极致交互
            </p>
            
            {/* 流体按钮 */}
            <FluidButton
              variant="primary"
              magnetic={true}
              onClick={() => console.log('Clicked!')}
            >
              开始探索
            </FluidButton>
          </GlassPanel>
        </div>
      )
    }
    ```
    
    ## 📦 包结构
    
    | 包名 | 描述 | 状态 |
    |------|------|------|
    | `@andy-liquid/core` | 核心效果引擎 | ✅ 可用 |
    | `@andy-liquid/react` | React 组件封装 | ✅ 可用 |
    | `@andy-liquid/vue` | Vue 组件 | 🚧 开发中 |
    | `@andy-liquid/svelte` | Svelte 组件 | 📋 计划中 |
    
    ## 🎨 组件
    
    ### LiquidCanvas - 液态画布
    
    3D 液态扭曲背景效果,基于 Three.js 实现。
    
    ```tsx
    <LiquidCanvas 
      text={["你的", "文字"]}
      intensity={7}           // 扭曲强度 1-10
      metalness={0.35}        // 金属度 0-1
      roughness={0.45}        // 粗糙度 0-1
      displacementScale={2}   // 位移缩放
      enableRain={true}       // 雨滴效果
      className="custom-class"
    />
    ```
    
    **特点:**
    - 🎭 动态文字纹理生成
    - 🌈 可自定义材质属性
    - ⚡ 高性能 WebGL 渲染
    - 📱 响应式适配
    - 🎨 支持自定义样式
    
    ### GlassPanel - 玻璃面板
    
    Apple 风格的玻璃态效果,带模糊背景和半透明。
    
    ```tsx
    <GlassPanel 
      variant="light"      // light | medium | dark
      blur="default"       // subtle | default | strong
      className="p-6"
    >
      你的内容
    </GlassPanel>
    ```
    
    **变体:**
    - `light` - 轻度模糊,高透明度
    - `medium` - 中度模糊,适中透明度
    - `dark` - 深度模糊,低透明度
    
    ### FluidButton - 流体按钮
    
    带磁吸和弹簧动画的交互式按钮。
    
    ```tsx
    <FluidButton
      variant="primary"    // primary | secondary | ghost
      magnetic={true}      // 磁吸效果
      springConfig={{      // 弹簧配置
        tension: 300,
        friction: 20
      }}
      onClick={handleClick}
    >
      点击我
    </FluidButton>
    ```
    
    **特性:**
    - 🧲 磁吸式鼠标跟随
    - 🌊 流体动画过渡
    - ⚙️ 可配置弹簧物理
    - 🎯 完整的键盘支持
    
    ## 🎯 设计理念
    
    Andy Liquid 融合了顶级设计实践:
    
    - 🍎 **Apple 液态玻璃** - 借鉴 iOS/macOS 的玻璃态设计语言
    - 🎬 **高端视觉** - 对标国际一线代理商的视觉标准
    - ⚡ **性能优先** - 60fps 流畅动画,优化的资源加载
    - ♿ **无障碍访问** - 符合 WCAG 标准,完整的键盘和屏幕阅读器支持
    - 🎨 **高度可定制** - 灵活的配置选项,适应各种设计需求
    
    ## 🛠️ 技术栈
    
    - **TypeScript** - 类型安全的开发体验
    - **React 19** - 最新的 React 特性
    - **Three.js** - 强大的 3D 图形库
    - **Framer Motion** - 流畅的动画库
    - **Tailwind CSS** - 实用优先的样式方案
    - **Turbo** - 高性能 Monorepo 构建
    
    ## 🎪 在线演示
    
    查看完整的交互式示例:
    
    - 🌐 [Live Demo](https://andy-liquid.vercel.app)
    - 📚 [Storybook](https://andy-liquid-storybook.vercel.app)
    - 🎮 [CodeSandbox](https://codesandbox.io/s/andy-liquid)
    
    ## 📖 完整文档
    
    访问 [andy-liquid.dev](https://andy-liquid.dev) 获取:
    
    - 📘 完整 API 文档
    - 🎓 使用教程
    - 🎨 设计指南
    - 💡 最佳实践
    - 🔧 迁移指南
    
    ## 🤝 贡献
    
    欢迎贡献代码、报告问题或提出建议!
    
    1. Fork 本仓库
    2. 创建你的特性分支 (`git checkout -b feature/AmazingFeature`)
    3. 提交你的改动 (`git commit -m 'Add some AmazingFeature'`)
    4. 推送到分支 (`git push origin feature/AmazingFeature`)
    5. 开启 Pull Request
    
    查看 [CONTRIBUTING.md](CONTRIBUTING.md) 了解详细指南。
    
    ## 📄 开源协议
    
    MIT © Andy - 自由使用,保留署名
    
    ## 🙏 致谢
    
    本项目基于以下优秀的开源项目:
    
    - [threejs-components](https://github.com/klevron/threejs-components) by Kevin Levron - Three.js 组件库
    - [liquid-effect-animation](https://github.com/StarKnightt/liquid-effect-animation) by StarKnightt - 液态效果灵感
    - [taste-skill](https://github.com/Leonxlnx/taste-skill) by Leonxlnx - 设计参考
    
    ## 🌟 Star History
    
    如果这个项目对你有帮助,请给个 Star ⭐
    
    [![Star History Chart](https://api.star-history.com/svg?repos=AIPMAndy/andy-liquid&type=Date)](https://star-history.com/#AIPMAndy/andy-liquid&Date)
    
    ---
    
    <div id="english"></div>
    
    # English
    
    **Premium liquid and glass effects library for modern web applications**
    
    ## ✨ Features
    
    🌊 **Liquid Canvas** - Three.js powered 3D liquid distortion effects  
    🪟 **Glass Panels** - Apple-style glassmorphism with accessibility  
    🎯 **Fluid Buttons** - Magnetic hover with spring physics  
    🔄 **Morph Transitions** - Smooth shape-shifting animations  
    🧭 **Liquid Navigation** - Floating island and dock-style navigation  
    
    ## 🚀 Quick Start
    
    ### Installation
    
    ```bash
    npm install @andy-liquid/react
    ```
    
    ### Basic Usage
    
    ```tsx
    import { LiquidCanvas, GlassPanel } from '@andy-liquid/react'
    
    export default function App() {
      return (
        <div>
          <LiquidCanvas 
            text={["Hello", "World"]}
            intensity={7}
          />
          <GlassPanel variant="medium">
            <h1>Beautiful Glass Effect</h1>
          </GlassPanel>
        </div>
      )
    }
    ```
    
    ## 📦 Packages
    
    - `@andy-liquid/core` - Core effects engine
    - `@andy-liquid/react` - React components
    - `@andy-liquid/vue` - Vue components (coming soon)
    - `@andy-liquid/svelte` - Svelte components (planned)
    
    ## 🎨 Design Philosophy
    
    Andy Liquid integrates best practices from:
    
    - 🍎 Apple's Liquid Glass design language
    - 🎬 High-end agency visual standards
    - ⚡ Performance-first fluid animations
    - ♿ WCAG accessibility compliance
    
    ## 📖 Documentation
    
    Visit [andy-liquid.dev](https://andy-liquid.dev) for complete documentation.
    
    ## 🤝 Contributing
    
    Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
    
    ## 📄 License
    
    MIT © Andy
    
    ## 🙏 Credits
    
    Built upon:
    - [threejs-components](https://github.com/klevron/threejs-components) by Kevin Levron
    - [liquid-effect-animation](https://github.com/StarKnightt/liquid-effect-animation) by StarKnightt
    - [taste-skill](https://github.com/Leonxlnx/taste-skill) by Leonxlnx
    
  • SKILL.md 517 B
    ---
    name: andy-liquid
    description: Three.js liquid metal / bloom 3D animation video renderer using React + Three.js
    version: 0.1.0
    ---
    
    # Andy Liquid
    
    Three.js-based 3D liquid metal animation renderer. Produces professional-grade
    visual effects for video: bloom post-processing, particle systems, dynamic camera
    movements.
    
    ## Quick Start
    
    ```bash
    cd andy-liquid
    pnpm install
    pnpm build
    ```
    
    ## Use Cases
    
    - Brand launch videos
    - Cinematic intros
    - Generative art backgrounds
    
    See `README.md` for full documentation.
    
  • skills-lock.json 243 B
    Loading…
  • turbo.json 492 B
    Loading…

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.