CI: built output is never loaded — add a vite preview boot check after npm run build #92

Closed
opened 2026-09-12 01:57:43 -04:00 by jared · 0 comments
Owner

Location: .gitea/workflows/ci.yml — nothing runs after "Build" except size reporting

Problem

npm run build succeeding proves the bundler finished, not that the app boots. A wrong asset base path, a broken config.json copy, a service-worker registration error, or a top-level module throwing on load all produce a blank page that would deploy to chat.lotusguild.org unnoticed for ~11 minutes plus however long it takes someone to notice. The README itself warns that a blank page is "almost always a failed module/asset resolution".

Suggested fix

After the build, start npx vite preview --port 4173 &, wait for it, then run a headless Chromium (or even curl + a tiny Playwright script) that loads /, waits for the root element to have children, and fails on any pageerror or console error. This can share the Playwright setup from the smoke-test issue, but is worth doing even standalone since it needs no homeserver.


Filed from the September 2026 client audit (CI pipeline review, branch lotus @ 4bea4895).

**Location:** `.gitea/workflows/ci.yml` — nothing runs after "Build" except size reporting ### Problem `npm run build` succeeding proves the bundler finished, not that the app boots. A wrong asset base path, a broken `config.json` copy, a service-worker registration error, or a top-level module throwing on load all produce a blank page that would deploy to chat.lotusguild.org unnoticed for ~11 minutes plus however long it takes someone to notice. The README itself warns that a blank page is "almost always a failed module/asset resolution". ### Suggested fix After the build, start `npx vite preview --port 4173 &`, wait for it, then run a headless Chromium (or even `curl` + a tiny Playwright script) that loads `/`, waits for the root element to have children, and fails on any `pageerror` or console error. This can share the Playwright setup from the smoke-test issue, but is worth doing even standalone since it needs no homeserver. --- _Filed from the September 2026 client audit (CI pipeline review, branch `lotus` @ 4bea4895)._
jared added this to the Audit 2026-09 · Medium & Low milestone 2026-09-12 01:57:43 -04:00
jared added the priority: mediumtech-debtarea: build-ci labels 2026-09-12 01:57:43 -04:00
jared self-assigned this 2026-09-12 01:57:43 -04:00
jared closed this issue 2026-09-12 20:29:11 -04:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
2026-11-14
Dependencies

No dependencies set.

Reference: LotusGuild/cinny#92