Skip to content

F
finwise-miniapp-fe
Merged
Opened by ThinhNC@ThinhNC
Report abuse

fix(frontend): resolve ZMP black screen

Summary

  • Fixed the black screen displayed when opening the frontend in the Zalo Mini App simulator.
  • Moved index.html from src/ to the repository root.
  • Removed the custom Vite root: "./src" configuration.
  • Updated the application entry path to /src/app.ts.
  • Ensured production builds are generated in the root-level www/ directory.
  • Updated .agents documentation to reflect the current project structure, authentication flow, and development workflow.

Root Cause

ZMP CLI starts Vite using the repository root. The previous configuration placed index.html under src/ while also overriding the Vite root.

As a result, the simulator frame loaded successfully on port 3000, but the application iframe on port 2999 returned HTTP 404, producing a blank or black screen.