Meshify

Meshify is a node-based creative workspace for turning references and rough sketches into production-ready 2D assets, then pushing those assets into a 3D generation pass.

What It Does

• Works from a flow editor instead of a linear form
• Accepts optional image and sketch references
• Generates a polished 2D asset from prompt-only or reference-guided input
• Carries the result into a 3D model generation step
• Keeps editing and outputs separated with a Canvas / Gallery workspace switch
• Supports browser voice input for prompt entry when speech recognition is available
• Includes local preview and download flows for generated images and 3D assets

Product Flow

Image Reference (optional)
          \
           -> 2D Asset -> 3D Model
          /
Sketch Reference (optional)

The app opens directly into this workspace. The 2D Asset stage owns prompt shaping, reference handling, and image generation. The 3D Model stage uses the generated image as the handoff for 3D finalization and local preview.

Repo Layout

Path	Purpose
apps/web	React/Vite client for the flow editor, sketch tools, gallery, and 3D preview
apps/api	Thin Express API that owns provider secrets and generation endpoints
packages/shared	Shared request/response contracts and generation types
packages/prompts	Prompt-building logic for prompt-only and sketch-guided generation
docs	Product notes, implementation status, repo map, and operating context
assets/demo	Placeholder location for demo inputs and walkthrough assets

Stack

• React 19
• Vite
• TypeScript
• MUI
• React Flow
• Express 5
• Gemini via @google/genai for 2D generation
• fal.ai via @fal-ai/client for 3D generation

Quick Start

npm install
npm run dev:api
npm run dev:web

Web runs separately from the API. The API defaults to http://localhost:8787.

Commands

Command	Purpose
npm run dev:web	Start the Vite web app
npm run dev:api	Start the API in watch mode
npm run build:web	Build the web app
npm run build:api	Build the API bundle
npm run typecheck:web	Type-check the web app
npm run typecheck:api	Type-check the API
npm run lint:web	Lint the web app

Environment

Copy .env.example into a local .env and set the providers you intend to use.

Core variables:

• API_PORT
• AI_DEFAULT_PROVIDER
• GEMINI_API_KEY or GOOGLE_API_KEY
• GEMINI_IMAGE_MODEL
• GEMINI_VISION_MODEL
• FAL_KEY
• FAL_3D_MODEL

GET /health reports configured providers and the active model names the API sees at runtime.

Docs

Start here:

• docs/project_brief.md
• docs/product_spec.md
• docs/implementation_status.md
• docs/repo_map.md
• docs/run_notes.md