Common Issues
I Cannot Sign In
Check username or email, password, temporary lockouts after repeated attempts, MainApp backend on 8000, and Keycloak on 4000 when used by the flow.
I Do Not See Builder
The likely cause is missing roles. Ask an administrator to check that your user has builder manager, builder user, or admin privileges.
Builder Does Not Open
Check browser popup blocking, Builder frontend on 5174, the bridge at /bridge?init=1, and that the MainApp_DEMO session is still valid.
DB Designer Asks Me to Set a Password
This can happen on first access through the bridge. Complete the password setup screen to create or connect the user in the data system.
A Table Does Not Load
Check NocoDB on 8081, DB Designer backend on 8002, selected base, table permissions, and any UI error messages.
Data Changes Are Not Saved
Possible causes are an expired session, invalid NocoDB token, missing required field, incompatible data type, or unreachable backend.
Builder Export Is Incomplete
Static components export more easily. Dynamic components may require APIs, user sessions, or additional configuration.
Collaboration Updates Do Not Appear
Check collaboration backend on 6000, network availability, project permissions, and whether collaborators are editing the same project.
Local Ports
| Port | Service |
|---|---|
5173 | MainApp frontend |
5174 | Form Builder frontend |
5175 | DB Designer frontend |
8000 | MainApp backend |
8001 | Form Builder backend |
8002 | DB Designer backend |
8081 | NocoDB |
4000 | Keycloak |
Quick Checklist
- Are you signed in to MainApp_DEMO?
- Do you see the right sidebar entry?
- Is the local service running?
- Is the port reachable?
- Do you have the correct roles?
- Does the issue remain after logout and login?