feat(optimization): migrate to Supabase Edge Functions & Storage

[Schlomoh]

This pull request introduces several significant improvements to the optimization workflow in the Vectreal platform, focusing on transitioning asset storage from Google Cloud Storage (GCP) to Supabase Storage, enhancing the optimization drawer UI with detailed metrics and file size comparisons, and modularizing optimization utilities for better maintainability and clarity.

Key changes include:

Migration from GCP to Supabase Storage

• Updated .env.development.example to remove GCP storage credentials and variables, replacing them with Supabase equivalents and clarifying that Supabase Storage is now used for asset storage in all environments. [1] [2] [3]
• Updated documentation in CLAUDE.md to reflect the storage migration and new Supabase workflow, including commands for serving Supabase edge functions and clarifying the role of the terraform directory. [1] [2]

Optimization Drawer UI & Metrics Enhancements

• Refactored the optimization drawer (optimization-drawer.tsx) to display detailed before-and-after metrics, including triangles, texture size, and file size, with animated transitions and clear percentage/file size reduction labels. Added a dedicated FileSizeComparison component for visualizing file size changes. [1] [2] [3] [4] [5] [6] [7]

Modularization and Utility Improvements

• Introduced new utility modules for optimization:
  • geometry-worker.ts: Runs geometry optimizations in a Web Worker to keep the UI responsive.
  • optimization-quota.ts: Handles quota checks and consumption for optimization runs, including guest limits and error handling.
  • scene-size.ts: Provides hooks for calculating scene and texture sizes post-optimization.
  • Centralized exports in utils/index.ts for easier imports.

Project Structure and Configuration

• Added symlinks in .claude/skills/ to reference skills managed in .agents/skills/, ensuring proper skill resolution. [1] [2] [3]

These changes collectively modernize the asset storage approach, improve the user experience around model optimization, and enhance the maintainability of the optimization codebase.- feat(core): expose optional encoder injection in TextureCompressOptions

• feat(platform): add Supabase Edge Function for texture optimization
• feat(platform): route texture optimization through Supabase Edge Function
• feat(optimization): run geometry steps in Web Worker, expose loadFromGlbBuffer
• feat(storage): migrate asset storage from GCS to Supabase Storage
• chore(cleanup): remove GCP Cloud Function, update env docs and CLAUDE.md
• chore(cleanup): remove gcloud-storage startup validation

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[Schlomoh]

Code review

Found 3 issues:

1. USDZ files crash the optimizer — loadBinaryModel calls optimizer.loadFromGlbBuffer(new Uint8Array(await file.arrayBuffer())) for all binary formats, but USDZ files are ZIP archives, not GLB. ModelOptimizer.loadFromBuffer() validates the glTF magic bytes and throws "Invalid glTF 2.0 binary. Expected 'glTF' magic bytes, got..." for USDZ. USDZ support is explicitly advertised (use-load-model.ts L51, L146–155) but will silently error whenever a USDZ is uploaded with optimization enabled.

vectreal-platform/packages/hooks/src/use-load-model/file-loaders.ts

Lines 31 to 36 in 9abe1ab

	if (optimizer) {
	const buffer = new Uint8Array(await file.arrayBuffer())
	await optimizer.loadFromGlbBuffer(buffer)
	}

2. CLAUDE.md commands section references the deleted optimize-textures Edge Function — the PR deletes apps/vectreal-platform/functions/optimize-textures/ entirely, but the supabase functions serve comment in CLAUDE.md still says # serve optimize-textures at :54321/functions/v1/. The command will not work; the function no longer exists.

vectreal-platform/CLAUDE.md

Lines 30 to 34 in 9abe1ab

	# Supabase (local) — includes DB, Auth, Storage, and Edge Function runtime
	pnpm supabase start
	pnpm supabase functions serve # serve optimize-textures at :54321/functions/v1/
	pnpm nx run vectreal-platform:supabase-db-reset

3. loadFromServer throws the original plain Error instead of the structured StructuredLoadError — normalizeServerLoadError(error, sceneId) creates a StructuredLoadError and emits it via the event system, but then throw error re-throws the original plain Error. Callers like use-preview-scene.ts catch the thrown error and call isStructuredLoadError(error), which will always return false since a plain Error is received. The not_found/quota_exceeded code-based error differentiation in the preview UI is therefore dead code.

vectreal-platform/packages/hooks/src/use-load-model/use-load-model.ts

Lines 276 to 285 in 9abe1ab

	return sceneLoadResult
	} catch (error) {
	console.error('Server scene loading failed:', error)
	dispatch({ type: 'set-file-loading', payload: false })
	eventSystem.emit(
	'server-load-error',
	normalizeServerLoadError(error, sceneId)
	)
	throw error
	}

🤖 Generated with Claude Code

_{- If this code review was useful, please react with 👍. Otherwise, react with 👎.}