# Physic Claw Vea

> An interactive 3D visualization application featuring an "Augmented Entity" with reactive shaders and emotional states.

- Skill: `diegosouzapw/physic-claw-vea` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add diegosouzapw/physic-claw-vea`
- Raw SKILL.md: https://api.skillmd.com/api/skills/diegosouzapw/physic-claw-vea/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: diegosouzapw (https://skillmd.com/u/diegosouzapw)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/diegosouzapw/physic-claw-vea

---


# PhysicClaw-VEA

## Overview
PhysicClaw-VEA is an advanced interactive 3D experience built with **React Three Fiber** and **Three.js**. The core of the application is an "Augmented Entity" that dynamically reacts to simulated internal states such as "thinking", emotions, and intensity levels through custom shaders and animations.

## Key Features

### 🎨 Advanced 3D Visualization
- Immersive scene rendering using React Three Fiber.
- Support for loaded 3D models (GLB/FBX) with animation playback.
- Fallback to procedural geometry when models are loading or unavailable.

### ⚡ Reactive Shaders (`EnergyShader`)
- Custom GLSL shaders that visually modify the entity in real-time.
- Visual parameters include:
    - **Intensity**: Fluctuating energy levels.
    - **Thinking State**: Visual pulses indicating processing.
    - **Mood**: Color shifts based on the entity's emotional state.

### 🧠 "Soul" System (State Management)
- Powered by **Zustand** for global state management (`soulStore`).
- Simulates the entity's internal "soul" or consciousness, driving the visual changes and behaviors.

### 💬 Chat Interface
- An overlay interface allowing users to interact with the entity via text.
- Connects directly to the entity's state to trigger responses or visual changes.

## Tech Stack
- **Frontend**: React (v19), TypeScript, Vite
- **3D Graphics**: Three.js, React Three Fiber, Dre
- **State**: Zustand
- **Styling**: Tailwind CSS (configured)

## Installation & Usage

1.  **Install dependencies**:
    ```bash
    npm install
    ```

2.  **Run locally**:
    ```bash
    npm run dev
    ```

3.  **Build**:
    ```bash
    npm run build
    ```