BintzGavin/helios / skills/examples/solid
example-solid
VerifiedPatterns for using Helios with SolidJS. Use when building compositions in a SolidJS environment, utilizing signals for fine-grained reactivity.
SolidJS Composition Patterns
Integrate Helios into SolidJS components using Signals to manage frame state reactivity with high performance.
Quick Start
1. Create Helios Signal
Wrap the Helios instance in a SolidJS signal to make state reactive.
// lib/createHeliosSignal.js
import { createSignal, onCleanup } from 'solid-js';
export function createHeliosSignal(helios) {
const [frame, setFrame] = createSignal(helios.getState());
const unsubscribe = helios.subscribe((state) => {
setFrame(state);
});
onCleanup(() => {
unsubscribe();
});
return frame;
}
2. Create Composition Component
// App.jsx
import { createEffect } from 'solid-js';
import { Helios } from '@helios-project/core';
import { createHeliosSignal } from './lib/createHeliosSignal';
// Initialize Helios (outside component or in a context)
const helios = new Helios({
duration: 10,
fps: 30,
width: 1920,
height: 1080
});
// Bind for external control
helios.bindToDocumentTimeline();
function App() {
let canvasRef;
// Create reactive accessor
const state = createHeliosSignal(helios);
createEffect(() => {
const canvas = canvasRef;
if (!canvas) return;
const ctx = canvas.getContext('2d');
const { currentFrame, width, height } = state();
// Clear
ctx.clearRect(0, 0, width, height);
// Draw
ctx.fillStyle = '#446b9e';
const x = (currentFrame / (10 * 30)) * width;
ctx.fillRect(x, height / 2 - 50, 100, 100);
});
return (
<canvas
ref={canvasRef}
width={1920}
height={1080}
style={{ width: '100%', height: 'auto' }}
/>
);
}
export default App;
3. Three.js Integration
Integrate three with Helios by synchronizing the render loop via createEffect.
// App.jsx
import { createEffect, onCleanup, onMount } from "solid-js";
import * as THREE from "three";
import { Helios } from "@helios-project/core";
import { createHeliosSignal } from "./lib/createHeliosSignal";
// Singleton initialization pattern
if (!window.helios) {
window.helios = new Helios({
fps: 30,
duration: 10,
width: 1920,
height: 1080
});
}
export default function App() {
let canvasRef;
const state = createHeliosSignal(window.helios);
onMount(() => {
// 1. Setup Three.js Scene
const scene = new THREE.Scene();
const camera = new THREE.PerspectiveCamera(75, window.innerWidth / window.innerHeight, 0.1, 1000);
const renderer = new THREE.WebGLRenderer({ canvas: canvasRef, antialias: true });
// 2. Create Objects
const geometry = new THREE.BoxGeometry();
const material = new THREE.MeshBasicMaterial({ color: 0x00ff00 });
const cube = new THREE.Mesh(geometry, material);
scene.add(cube);
camera.position.z = 5;
// 3. Sync Render Loop
createEffect(() => {
const s = state();
const t = s.currentTime;
// Update animation state based on time
cube.rotation.x = t * 0.5;
cube.rotation.y = t * 0.5;
renderer.render(scene, camera);
});
// 4. Cleanup
onCleanup(() => {
renderer.dispose();
geometry.dispose();
material.dispose();
});
});
return <canvas ref={canvasRef} style={{ width: '100%', height: '100%' }} />;
}
Key Concepts
- Fine-Grained Reactivity: SolidJS signals update only what changes. However, since Helios updates on every frame (30-60 times/sec), wrapping the entire state in a signal is the standard approach for canvas rendering.
createEffect: UsecreateEffectto trigger imperative canvas drawing logic whenever the Helios signal updates.- Cleanup: Always use
onCleanupto remove the Helios subscription when the component unmounts.
Source Files
- Helper:
examples/solid-animation-helpers/src/lib/createHeliosSignal.js - Example:
examples/solid-canvas-animation/ - Example:
examples/solid-threejs-canvas-animation/
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |