aesthetic.computer
Monorepo for Aesthetic.Computer
aesthetic.computer
1# Starfield for Teia
2
3This is an example of packaging the `starfield` piece from aesthetic.computer for deployment as a Teia Interactive OBJKT.
4
5## About Starfield
6
7The starfield piece creates a classic 3D starfield effect with stars moving toward the viewer, creating a hypnotic space travel visualization.
8
9**Features:**
10- 128 animated stars by default (configurable)
11- 3D projection with perspective
12- Infinite loop with star recycling
13- Configurable speed and spread
14- Optional color and alpha parameters
15
16## Teia Package Details
17
18**Package Size:** ~520KB
19**Files Bundled:** 62
20**Dependencies:** Full aesthetic.computer system + WebGL libraries
21
22### Package Contents
23```
24starfield/
25├── index.html # Entry point with Teia integration
26├── cover.svg # Generated placeholder cover
27└── aesthetic.computer/ # AC system bundle
28 ├── boot.mjs # Modified for Teia sandbox
29 ├── bios.mjs # Core system
30 ├── style.css # Styles
31 ├── lib/ # 45+ library modules
32 ├── systems/ # 3 system modules
33 └── dep/ # 6 dependency files
34```
35
36## Testing Results
37
38✅ **Loads successfully** in Teia iframe environment
39✅ **All dependencies** resolved properly
40✅ **Animation runs** smoothly at 60fps
41✅ **No console errors** after fixes
42✅ **Responsive** to window resizing
43
44## Known Issues
45
46- ⚠️ Some unmapped source file warnings (cosmetic only)
47- ⚠️ WebRTC features disabled in sandbox mode (not used by starfield)
48
49## Performance
50
51- **Initial load:** ~0.5s
52- **Memory usage:** ~15MB
53- **CPU usage:** Low (efficient WebGL rendering)
54- **Mobile compatibility:** Good
55
56## Teia Integration Notes
57
58The piece automatically detects Teia environment via:
59```javascript
60window.acOBJKT_MODE = true;
61window.acPIECE_NAME = "starfield";
62```
63
64Teia URL parameters are accessible:
65```javascript
66window.acOBJKT_VIEWER // Viewer's Tezos address
67window.acOBJKT_CREATOR // Creator's Tezos address
68```
69
70## Deployment Steps
71
721. Package: `./teia/pack-for-teia.sh starfield`
732. Test locally: `cd teia/output/starfield && python3 -m http.server`
743. Upload `starfield.zip` to [teia.art/mint](https://teia.art/mint)
754. Preview and mint!
76
77## Source Code
78
79Original piece: [`/system/public/aesthetic.computer/disks/starfield.mjs`](../../system/public/aesthetic.computer/disks/starfield.mjs)
80
81## Live Example
82
83🚀 **Ready for OBJKT deployment!** This piece demonstrates that aesthetic.computer works beautifully in the Teia Interactive OBJKT environment.