A-Frame Git Editor

This editor combines A-Frame Inspector, A-Frame Watcher and a git client.

It uses aframe-watcher-bun to save changes made in the A-Frame Inspector directly back to your HTML files, provided your A-Frame elements carry a unique, valid DOM id.

Quick Start

Clone this repository, then run :

bun install
bun dev

How it works

1. server.ts: A lightweight Bun server that serves your index.html and provides a /save endpoint.
2. index.html: Your A-Frame scene. It includes a small script to tell the A-Frame Inspector where to send changes.
3. Persistence: When you press the save icon in the A-Frame Inspector (CTRL+ALT+I), the changes are sent to the Bun server, which updates your index.html on disk.

Usage

1. Run bun dev.
2. Open http://localhost:3000 in your browser.
3. Press CTRL + ALT + I to open the Inspector.
4. Modify any entity (position, rotation, etc.).
5. Click the Floppy Disk 💾 icon in the top left of the Inspector.
6. Check your index.html file—the changes are saved!

Self-contained executable

Bun can compile the application into a standalone, self-contained executable :

bun run compile

will produce an executable aframe-git-editor linux amd64 binary that you can run without installing Bun.

Consult Bun's upstream documentation for more details.