.env.example

# StemStudio OSS — sample environment.
#
# Copy this file to `.env` at the repo root.
#   • Vite reads it via `client/.env` (the OSS Vite config points there).
#   • The Go AI server (`server/cmd/ai-server`) reads `.env` from the repo
#     root at startup.
#   • The multiplayer sidecar (`stemstudio-multiplayer/`) reads its own
#     `.env` inside that submodule; see its README.
#
# Any AI provider key you omit makes that provider unavailable; the editor
# will show a BYOK prompt when a user invokes a feature that needs it.

# ─── Build flag ─────────────────────────────────────────────────────────────
# Tells Vite to compile the OSS-mode UI (hides hosted-only features, shows
# the first-time bootstrap modal, tree-shakes Firebase + Stripe + MediaPipe
# out of the bundle). The Go AI server reads this to enable its dummy-token
# auth bypass (only the AI server bypasses; the storage server still
# requires real auth in integrated deploys).
BUILD_MODE=oss

# ─── Local-dev service URLs (read by the editor) ────────────────────────────
# `bun run dev:oss` orchestrates Vite + Go AI server + multiplayer sidecar
# under concurrently. The values below are the defaults each launches with.
# Override only if you run those services on different ports / hosts.

# Go AI server URL — where the editor sends every `/api/AI/*` request.
REACT_APP_SERVER_HOST=http://localhost:8081

# Colyseus multiplayer sidecar — WebSocket endpoint and REST endpoint
# (used for matchmaking + room lookup).
REACT_APP_MULTIPLAYER_SERVER_URL=ws://localhost:2567
REACT_APP_MULTIPLAYER_API_SERVER=http://localhost:2567

# Copilot bridge (stemstudio-copilot submodule). Optional — leave unset to
# hide the copilot panel entirely. When set, the editor opens an ACP/WS
# connection here.
# REACT_APP_COPILOT_SERVER_URL=ws://localhost:3000/acp

# Community / social channels. Each one is rendered as a clickable button
# in the dashboard sidebar / footer; unset values hide the corresponding
# button so a fresh deployment starts with no community links wired up.
# REACT_APP_DISCORD_URL=https://discord.gg/your-invite
# REACT_APP_DISCORD_SERVER_URL=https://discord.com/invite/your-invite
# REACT_APP_X_URL=https://x.com/your-handle
# REACT_APP_YOUTUBE_URL=https://www.youtube.com/@your-channel

# External destinations rendered in footers / dashboard. Each one is empty
# by default — the consuming component hides the link when unset.
# REACT_APP_BLOG_URL=https://blog.example.com
# REACT_APP_FORUM_URL=https://forum.example.com
# REACT_APP_DOCS_URL=https://docs.example.com
# REACT_APP_ABOUT_URL=https://example.com/about

# Default model-generation provider. The editor shows this provider's UI
# first when a user opens the "Generate Model" panel. Valid: meshy, tripo.
# REACT_APP_DEFAULT_AI_GENERATOR=meshy

# Feature flag: enable the Monaco-based behavior script authoring panel
# in OSS builds. Defaults to "false"; flip to "true" if you want it
# visible by default.
# REACT_APP_SCRIPTS_ENABLED=true

# ─── Local-dev service ports (read by the orchestrator) ─────────────────────
# These are the ports `bun run dev:oss` boots services on. Editor-side
# REACT_APP_* values above must match these if you change either side.

REACT_APP_PORT=5173       # Vite editor — http://localhost:<PORT>
AI_SERVER_PORT=8081       # Go AI server — http://localhost:<PORT>
MULTIPLAYER_PORT=2567     # Multiplayer sidecar — ws://localhost:<PORT>

# ─── AI provider keys (read by the Go AI server) ────────────────────────────
# Env-supplied keys always take precedence over per-session BYOK keys
# submitted from the editor. Leave a key commented out (or empty) to make
# the provider BYOK-only.

# Anthropic (Claude) — copilot + behavior generation.
# ANTHROPIC_API_KEY=
# (alias kept for legacy)
# CLAUDE_API_KEY=

# OpenAI — alternate copilot + image generation.
# OPENAI_API_KEY=
# OPENAI_IMAGE_MODEL=gpt-image-1

# Gemini (Google) — alternate copilot.
# GEMINI_API_KEY=

# Meshy — text-to-3D model generation.
# MESHY_API_KEY=

# Tripo — alternate text-to-3D + character rigging.
# TRIPO_API_KEY=

# Rodin (Hyper3D) — alternate text-to-3D model generation.
# RODIN_API_KEY=
# Optionally override the API base URL (staging / self-hosted):
# RODIN_API_BASE_URL=

# ElevenLabs — text-to-speech, NPC voices.
# ELEVEN_LABS_API_KEY=

# AnythingWorld — rigged character + animation library.
# ANYTHING_WORLD_API_KEY=

# Default LLM provider routed for chat-style flows when more than one is
# configured. Valid: anthropic, openai, gemini.
# DEFAULT_LLM_PROVIDER=anthropic