For local development, the Go backend and React interface run on your machine; PostgreSQL runs in Docker. Edit the model in Generator UI and records in the generated admin.
Working in the interface
- Open Content and change an entity, field or relationship.
- Save with Finish and go to Generate.
- Click Preview changes, inspect the changes and Generate.
- After restarting the application, open the admin address printed in the terminal and check the changed form on a record.
Generator UI does not start Go/React or manage Docker. Prepare the environment with the commands below, then return to model configuration in the browser.
Terminal startup and environment maintenance
Open a terminal in the generated project root and run:
make dev
Install Go, Node/npm and Make and start Docker first. The command prepares the local environment, starts PostgreSQL and applies migrations. If no administrator exists, it offers to create a superadmin account. Password input is hidden; there is no default password. API and admin then start, with their logs in this terminal. Addresses are printed in the output. Defaults are API http://127.0.0.1:8081 and interface http://127.0.0.1:5173.
If generated deployment files exist, the common controller can start the same environment. First create and check the development configuration:
mkdir -p deploy/environments
jq --arg root "$(pwd -P)/deploy/.state/dev" \
'.root=$root | .backup.root=($root+"/backups")' \
deploy/generated/examples/dev-local.json > deploy/environments/dev.json
bash ./deploy/control check --env dev
bash ./deploy/control up --env dev
In this mode, up runs make dev. Run the following in another terminal: the first command displays PostgreSQL logs; the second stops the environment.
bash ./deploy/control logs --env dev --service postgres
bash ./deploy/control down --env dev
Go and React logs remain in the startup terminal. dev-local does not accept --json or confirmation arguments for server operations. The environment JSON also does not replace .env or Make parameters. Stopping preserves PostgreSQL data.
After changing the model
Stop the application processes, Generate, then run make dev again. Do not delete the database volume to apply migrations. If you have changed environment settings, check them before startup: preparation must not silently replace existing configuration.
Related guides
Continue model work with UI interface. Editor startup parameters are covered in CLI: project preparation. For another application layout, open environment selection.