Menu

Tree [caff9f] main 1.0.0 /
 History

HTTPS access


File Date Author Commit
 assets 2025-11-10 duongpham17 duongpham17 [4a2872] first commit
 build 2 days ago duongpham17 duongpham17 [caff9f] first commit
 public 2025-11-10 duongpham17 duongpham17 [e110e5] first commit
 src 2 days ago duongpham17 duongpham17 [caff9f] first commit
 .gitignore 2025-11-10 duongpham17 duongpham17 [4a2872] first commit
 README.md 2025-11-10 duongpham17 duongpham17 [fb9013] updadted readme
 package-lock.json 2 days ago duongpham17 duongpham17 [caff9f] first commit
 package.json 2 days ago duongpham17 duongpham17 [caff9f] first commit
 tsconfig.json 2025-11-10 duongpham17 duongpham17 [4a2872] first commit

Read Me

Packaging the application

Before releasing
1) change package.json version
2) check public/electron.js is set to production
3) npm run build
4) git add . -> ... -> git push
5) npm run dist

npm run dist

Issues
1. Preload.js can fail if a required package has issues. Delete one by one and ensure its loading

  1. HashRouter instead of BrowserRouter if you are using files as a path.

  2. Production and development environment can be a pain, better to just have 2 files and use whatever one is needed.

  3. Building using npx electron-builder seems to be a much better choice over npm.

  4. packaged & wont open, try npm run dev, if the app opens its listening on
    localhost:XXXX, ensure file path is correct. Revert back to issue 1. if needed.

  5. Package.json file may require a "homepage": "./", while your there check main is also correct, "public/electron.js"

  6. Made 2 files one for production and development in electron.js and swtich between the two less prone to bugs but more annoying.

  7. Releasing to GITHUB and the app starts having DAMAGE problems?

    • xattr path/to/applciation.app
      com.apple.provenance → macOS knows it came from the internet (Safari, Chrome, etc.).
      com.apple.quarantine → Gatekeeper has locked it and won’t let it run because it’s
    • xattr -cr path/to/applciation.app
      to then remove and allow it to work again
  8. If packaging and theres no .exe file, try building in a terminal with administrator