Onlook Docs

Common Issues

Codesandbox Preview

Codesandbox may ask you to confirm to proceed. You can click the button by switching to Preview mode in onlook, and click the "Yes, proceed to preview" link and switch back. The UI should render properly inside the iframe after that.

Codesandbox confirmation mode

Switch to Preview mode

Authentication Issues

If you encounter issues with reloading pages and being unauthenticated then check your node version, install a more recent version, re-install dependencies and restart the project. Minimum version v20.16.0 or latest is recommended.

Avoid version v20.11.0 of Node as it has shown this issue in the past.

node --version

You may have to delete cookies to clear the authentication state.

Delete cookies

"Column not found" error

If you encounter issues such as "Column not found" error, your database may be out of sync with the schema. There are 2 things to try to get it back in sync:

  1. Run bun db:push to push the schema to the database. If there are conflicts, you can try step 2.
  2. Run bun db:reset to fully reset the database and re-run the migrations. WARNING: This will delete all data in the database.