visudev
v1.0.0
Published
VisuDEV: preview runner (visudev-runner). Later: full local stack via npx visudev.
Downloads
121
Readme
visudev
Preview Runner for VisuDEV: clone repo, build and run the app, expose a URL for the Live App / AppFlow view.
Quick start
npx visudev-runnerStarts the runner on port 4000 (override with PORT=4001 npx visudev-runner).
AppFlow
- Local: Run the VisuDEV app with
npm run dev(in the repo). In dev mode the app useshttp://localhost:4000by default. Start the runner in another terminal:npx visudev-runner. AppFlow will use it. - Deployed app: Set
PREVIEW_RUNNER_URLin Supabase (Edge Function secrets) to the runner’s public URL (e.g.https://your-runner.example.com). Run the runner on that server withnpx visudev-runner.
Env (optional)
PORT– API port (default 4000)USE_REAL_BUILD=1– clone, build and run the app (default stub)USE_DOCKER=1– run each preview in a containerGITHUB_TOKEN– for private reposGITHUB_WEBHOOK_SECRET– for webhook signature verification
API
POST /start– start a preview (body:repo,branchOrCommit,projectId)GET /status/:runId– status andpreviewUrlPOST /stop/:runId– stop and free portPOST /refresh– pull, rebuild, restart for a runGET /health– health check
Later this package will grow into the full local VisuDEV stack (npx visudev).
