pcbjam/web/standalone/.env.example

71 lines
3.9 KiB
Shell
Raw Normal View History

# Standalone editor (Vite). Copy to standalone/.env. All vars must be VITE_-prefixed.
# Backend implementing the @pcbjam/shared contract (the example backend, or any
# conforming backend). Leave it pointing anywhere unreachable to use only the
# local-folder loader on the home page.
VITE_API_BASE_URL=http://localhost:3060
# Where PROJECTS come from: "remote" (default — the @pcbjam/shared backend above)
# or "static" (a read-only example gallery served from a CDN, NO backend — the
# demo.pcbjam.com mode; editor saves download to local). For "static" you must
# also set VITE_PROJECT_MANIFEST_URL.
# VITE_PROJECT_SOURCE=static
# VITE_PROJECT_MANIFEST_URL=https://cdn.pcbjam.com/content/2.7.7/manifest.json
# WASM asset root (no trailing slash). On `dev` the artifacts are symlinked into
# public/wasm and served by Vite at /wasm (a FLAT layout — files live directly
# under the root). For a prod CDN set an absolute URL, e.g.:
# VITE_WASM_ROOT=https://cdn.pcbjam.com/wasm
# A cross-origin CDN works: boot.ts loads the pthread worker via a same-origin
# blob shim, and the CDN must send CORP: cross-origin + ACAO (+ COEP/COOP on the
# app). VITE_WASM_ASSET_BASE_URL is the legacy name and is still honored.
VITE_WASM_ROOT=/wasm
# Per-release WASM manifest file under VITE_WASM_ROOT (e.g. "manifest-2.7.7.json").
# When set, the editor resolves each tool's versioned, content-addressed folder
# (VITE_WASM_ROOT/<tool>/<ver>/) from it at runtime (see docs/features/demo-deploy).
# Leave UNSET for the flat dev layout above.
# VITE_WASM_MANIFEST=manifest-2.7.7.json
# Override the artifact source dir the dev symlink points at (default:
# <repo>/tests/apps/kicad). Useful when serving prebuilt artifacts from elsewhere.
# WASM_SRC_DIR=
# Marketing / landing page the version badge links to (default https://pcbjam.com).
# VITE_LANDING_URL=https://pcbjam.com
# Companion management app origin. When set (the backed editor.pcbjam.com
# deploy), non-editor routes — home, project overview, mgmt-only paths —
# redirect there, preserving path + search (standalone-hardening 0006).
# Leave UNSET for dev and the demo: every route renders locally.
# VITE_APP_URL=https://app.pcbjam.com
# Honor `?user=` / `?libowner=` identity overrides ("1"). Dev servers and e2e
# harnesses set this so specs can mint isolated per-run identities; NEVER set
# it on a production build — the session user from /api/me (or the VITE_USER
# fallback) is the identity there (collab-presence 0009).
# VITE_ALLOW_USER_OVERRIDE=1
# Where the in-editor waitlist form POSTs (default https://www.pcbjam.com/api/waitlist).
# The demo is static with no backend, so it cross-posts to the landing site's
# serverless endpoint, which must send CORS for this origin (see
# site/src/pages/api/waitlist.ts). Same JSON contract {email, source, company_url}.
# Use the canonical www host: the apex 308-redirects to www and a CORS preflight
# can't follow redirects.
# VITE_WAITLIST_URL=https://www.pcbjam.com/api/waitlist
# Plausible analytics. Unset ⇒ no tracking (dev/checkout default). Set the shared
# site's pa-*.js script URL to enable (the pa- id keys the dashboard, no
# data-domain). Point it at a self-hosted/proxied copy on cdn.pcbjam.com if the
# plausible.io script won't load under COEP require-corp.
# VITE_PLAUSIBLE_SRC=https://plausible.io/js/pa-KjNS9YmidydULZTstsjRg.js
# Where a backend project's DOCUMENT content lives ("api" default | "ydoc").
# Same /p/<project> URLs either way. "api": file bytes come from the REST
# backend and a user save (File->Save in the editor) is uploaded back to it.
# "ydoc": the collab room (VITE_YJS_PROVIDER) is the source of truth - when the
# room holds the document it is materialized client-side instead of fetched,
# and saves stay in the browser (the provider persists the doc); the REST
# backend still serves project metadata + sibling files, and the file fetch is
# the first-open fallback that seeds the room.
# VITE_DOC_SOURCE=ydoc