How to run the Ops app on your machine, the checks every change must pass, and how it is deployed.
The repository is utopiaspace-ops. A push to development deploys straight to production at utopia-ops.vercel.app, where Encik Beku technicians use it. Work on a branch and merge only when the change is ready for them.
For web development you need the app, Utopia OE, and the backend of the BU you are working on.
utopiaspace-core checkout..env.localAsk the team for the Hub Supabase values. The environment section of the repository's README.md is out of date, so follow .env.local.example.
OE runs on port 8081. Set the BU's BU_<CODE>_BASE_URL and BU_<CODE>_TOKEN in utopiaspace-core/.env.
Always use port 3010. Web push is registered for localhost:3010 only.
Every EXPO_PUBLIC_* value is built into the app and can be read by anyone who has it. Restart the app after changing one.
| Value | Local | Notes |
|---|---|---|
EXPO_PUBLIC_SUPABASE_URL, EXPO_PUBLIC_SUPABASE_ANON_KEY | The Hub project | Required. Without them the app shows a configuration error screen. |
EXPO_PUBLIC_ENCIK_BEKU_API_URL | http://localhost:8081 | Despite the name, this is the OE gateway for every BU. If you leave it unset, the web app talks to the production Encik Beku API. On an Android emulator use http://10.0.2.2:8081. |
EXPO_PUBLIC_ENCIK_BEKU_API_KEY | A token from your local Encik Beku portal | Must not be empty. Never use a production token. |
EXPO_PUBLIC_ENABLED_BUS | For example encik-beku,ibnu-sina | The BUs this build offers. Production leaves it unset, which means Encik Beku only. |
EXPO_PUBLIC_ONESIGNAL_APP_ID | Optional | Blank turns web push off. |
For a BU slice, lint just that BU with npx eslint src/bu/<key> app/<key>. A failing type check still exports and ships broken code, so fix it first.
WEB_PWA_PARITY.md.lib/ with a test.The web app is what technicians use today.
development starts the GitHub Actions workflow deploy-web-development.yaml.npx expo export -p web.utopia-ops Vercel project. The change is live in a few minutes.Environment values are built in at build time. After changing one in Vercel, deploy again.
Type-checks, builds, and deploys to production from your machine. You need to be in the utopiahubs-projects Vercel team.
The browser calls /eb-api/* on the same site, and vercel.json forwards it to api.oe.utopiagroup.com.my. This avoids cross-site request blocks.
utopia-ops.vercel.app. The per-deploy Vercel URLs ask for a Vercel login.
After a deploy, sign in as a technician, open a job, start it, record an item, photo, and payment, and complete it with a signature.
The service worker only caches the app shell so the app can open offline. It never caches sign-in or job data.
Built with EAS. All profiles use the same package, com.utopiaspace.ops, so only one can be installed on a phone at a time.
| Profile | Output | Use for |
|---|---|---|
development | Debug APK with the development client | Native changes on a test phone |
staging | APK | Internal testing |
production | App bundle, version number raised automatically | Store or managed-device release |
RNBG_LICENSE_KEY as an EAS secret. Without it the library is skipped.
The plan is to hand the Android app out through Scalefusion device management in kiosk mode. The code does not check for it yet.