Build a React app
You can build a React app from WaveMaker Studio in two ways: a full Maven build, or a frontend-only build with npm.
Build properties
The Maven build takes two properties.
app.contextPathis the sub-route the frontend loads its bundle files (JS, CSS) from. Set it when the app is served under a path such ashttps://wavemaker.ai/app1. If the app is served from the domain root, pass"".app.serverPathis the base URL of the backend the frontend calls. Set it when you use a WaveMaker backend.
Option 1: Maven build
With a WaveMaker backend
mvn clean install \
-Pdeployment \
-DoptimizeUIBuild=true \
-Dapp.contextPath=/QuickMobile \
-Dapp.serverPath=http://example.com/QuickMobile \
-Dbuild.ui.mode=react
Without a WaveMaker backend
Pass an empty serverPath. Keep contextPath if the app lives under a sub-route.
mvn clean install \
-Pdeployment \
-DoptimizeUIBuild=true \
-Dapp.contextPath=/app2 \
-Dapp.serverPath="" \
-Dbuild.ui.mode=react
contextPath matters when several apps share one domain and are routed by path:
https://wavemaker.ai/app1
https://wavemaker.ai/app2
Each app needs to know which sub-route to fetch its bundles from. serverPath does the same job for API calls.
Option 2: Build only the React app
Use this when you don't want the Maven build.
-
Download the React zip from Studio.
-
Set the environment variables:
NEXT_PUBLIC_SERVER_PATH="" # backend URL, or empty if there is no WaveMaker backend
NEXT_PUBLIC_BASE_PATH="/app1" # only when served from a sub-route, otherwise "" -
Run the build:
npm run build -
Deploy the generated build directory to any static host.
Apps with WMX components
If the project has WMX components, they are built along with the app. You don't need a separate build step. List any extra libraries a component needs in that component's own package.json.
Serve the build with nginx
What you need: when a user opens domain/app (or refreshes domain/app/orders), nginx must return index.html.
Why: the React app is a single page. Only index.html exists as a real file, and the routing happens in the browser. If nginx is asked for /app/orders directly, it finds no such file and returns a 404.
What to do: add a fallback in the nginx config so any path that isn't a real file returns index.html:
location /app/ {
root /var/www; # build output is in /var/www/app
try_files $uri $uri/ /app/index.html;
}
The location path must match the contextPath (or NEXT_PUBLIC_BASE_PATH) used in the build. For an app at the domain root, use location / and /index.html.
Which values to use
| Scenario | contextPath | serverPath |
|---|---|---|
| WaveMaker backend, sub-route | /app | backend URL |
| No WaveMaker backend, sub-route | /app | "" |
| No WaveMaker backend, domain root | "" | "" |