Developer Guide

Local Commands

Run the app locally:

npm run dev

Build the web assets:

npm run build

Package the macOS app:

npm run package:mac

Open the packaged app:

open "release/Codex Refit.app"

After server changes:

node --check server.mjs

After Electron changes:

node --check electron/main.mjs

After frontend or bundle changes:

npm run build

After Electron, icon, or packaging changes:

npm run package:mac

General whitespace check:

git diff --check

Backend smoke test when the dev server is running:

curl http://127.0.0.1:5173/api/scan

The package script writes the app bundle to:

release/Codex Refit.app

The app icons live in:

electron/
public/app-icons/

Do not replace generated image assets or app icons unless that is the explicit task.

Confirm the working tree only contains intentional changes.
Run node --check server.mjs.
Run git diff --check.
Run npm run build.
Run npm run package:mac.
Open release/Codex Refit.app.
Run a scan and a Speed Check.
Commit and push.
Attach a zipped app build to a GitHub Release when publishing for non-developers.