Immersive Awe Canvas¶
Interactive WebGL worlds with time-of-day controls, responsive theming, and agent-friendly repo automation.
Signal¶
Project Signal
- Status: Experiment, shipping visual updates bi-weekly -> monthly basis.
- Focus: 3D scene exploration + live parameter editing
- Stack: React, Three.js, Zustand state, deployment via Lovable + GitHub Pages
- Ideal For: Frontend devs exploring creative coding patterns
Quick Links¶
Onboarding Checklist¶
- Clone the repo and install dependencies (
pnpm installper the project README). - Start the dev server with
pnpm devto load the canvas playground and inspector panel. - Explore
agents/for RULES + MEMORY to understand how automated contributors should behave.
Highlights¶
- Toggle between curated scenes, adjust time-of-day gradients, and see lighting changes instantly.
- Live inspector exposes camera, fog, and particle settings backed by Zustand state snapshots.
- Framework-driven
agents/directory keeps repo automation consistent with Docs-as-Code standards.
Code Snapshot¶
```tsx import { Canvas } from '@react-three/fiber'; import { OrbitControls, Environment } from '@react-three/drei'; import { useThemeStore } from '../stores/theme';
export function AweScene() { const { gradient, fog } = useThemeStore();
return ( ); } ```
```bash
Clone and start the dev server¶
git clone https://github.com/BA-CalderonMorales/immersive-awe-canvas.git cd immersive-awe-canvas pnpm install pnpm dev ```
Core Scenarios¶
- Creative prototyping: Quickly concept ambient hero sections or marketing visuals inside a browser.
- Design handoff: Share Lovable-hosted builds so designers can tweak parameters before exporting captures.
- Agent workflows: Use consistent RULES/MEMORY files to script GitHub Copilot-style agents inside the repo.
Documentation Map¶
| Document | Description |
|---|---|
| Quick Start | Local dev requirements, scripts, and scene controls |
| Scene Details | Architecture, component breakdown, and customization hooks |
| Agent Rules | Repository guardrails for AI collaborators |