admin/Claw3D
1
0
Fork 0
mirror of https://github.com/iamlukethedev/Claw3D.git synced 2026-07-31 03:52:15 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add studio local test script

Browse Source 
Co-authored-by: Luke The Dev <iamlukethedev@users.noreply.github.com>
This commit is contained in:
Cursor Agent
2026-04-19 01:45:15 +00:00
co-authored by Luke The Dev
parent 1b50754e86
commit 7e99992ba2
1 changed files with 99 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/studio-image-builder-test-script.md
+99
View File
@@ -0,0 +1,99 @@
# Claw3D Studio Local Test Script
This script verifies the current Claw3D Studio builders.
Important.
- The world builder and image-guided asset builder work locally.
- No gateway connection is required for any steps in this document.
- If the app shows any gateway-related controls in the header, they can be ignored for Studio testing.
## Preconditions
1. Install dependencies.
2. Start Claw3D locally.
3. Open the app in a browser.
4. Navigate to `/studio`.
Commands.
- `npm install`
- `npm run dev`
## Test A: Text world builder
Goal.
- Confirm prompt-only world generation works without a gateway.
Steps.
1. Open `/studio`.
2. Do not upload an image.
3. Enter a project name.
4. Enter a generation brief describing a world or asset set.
5. Choose style, scale, focus, and optionally seed.
6. Click `Generate scene`.
Expected.
- A new project appears in the project library.
- The 3D preview renders.
- Scene notes appear.
- The project card shows `Export GLB`, `Export manifest`, and `Apply to office`.
Extra checks.
- Click `Export GLB` and confirm a `.glb` download starts.
- Click `Export manifest` and confirm a `.json` download starts.
- Click `Apply to office` and confirm a success status message appears.
## Test B: Image-guided avatar builder
Goal.
- Confirm image upload and image-guided avatar proxy generation works locally.
Steps.
1. Open `/studio`.
2. Click `Upload image`.
3. Select a PNG, JPEG, or WEBP reference image.
4. Wait for the upload to finish.
5. Confirm the reference image preview appears.
6. Confirm palette chips are extracted and displayed.
7. Keep or update the project name and prompt.
8. Click `Generate from image`.
Expected.
- A new project appears in the project library.
- The project shows the `image avatar` mode tag.
- The 3D preview renders an avatar-like proxy.
- The preview shows the reference image overlay.
- The project card shows a thumbnail of the uploaded source image.
Extra checks.
- Click `Export GLB` and confirm a `.glb` download starts.
- Click `Export manifest` and confirm a `.json` download starts.
- Confirm the status line reports successful generation and export.
## Test C: Local-only behavior
Goal.
- Confirm Studio generation does not depend on any gateway.
Steps.
1. Keep the app on `/studio`.
2. Do not connect any gateway.
3. Run both Test A and Test B.
Expected.
- Text world generation still works.
- Image-guided avatar generation still works.
- GLB export still works.
- No gateway connection is required at any point.
## Automated checks
Run these after code changes.
- `npm run typecheck`
- `npm run build`
- `npm run test -- --run tests/unit/studioWorldRoute.test.ts`
- `npx eslint src/app/api/studio-world/route.ts src/features/studio-world/**/*.tsx src/features/studio-world/**/*.ts src/lib/studio-world/**/*.ts tests/unit/studioWorldRoute.test.ts`
## Current scope note
The image builder currently creates a stylized 3D proxy guided by the uploaded image.
It does not yet perform full neural image-to-mesh reconstruction.