Skip to main content

Troubleshooting

Hosanna UI troubleshooting documentation provides solutions to common issues developers may encounter while working with the framework. Below are some common problems and their resolutions:

Port Already in Use​

The Hosanna UI bundler runs on port 5173. If another process is using this port, you can either terminate the process or change the port.

Terminating a Process on Port 5173​

Run the following command to find the process ID (PID) for the process listening on port 5173:

sudo lsof -i :5173

Then terminate the process using:

kill -9 <PID>
kill -9 <PID>

On Windows, use Resource Monitor to find the process and Task Manager to stop it.

Using a Port Other Than 5173​

You can configure the bundler to use a different port by running:

npm run dev --port=3000

Update your application to load the JavaScript bundle from the new port.

Missing or Incompatible Libraries​

Make sure all required dependencies for Hosanna UI are installed and compatible with your project. For a typical TypeScript setup, check your package.json for the following (example):

"dependencies": {
  "hosanna-ui": "^1.0.0",
  "react": "^18.0.0",
  "typescript": "^5.0.0"
}

After updating dependencies, run:

npm install

If you see errors about missing types, ensure you have the necessary type definitions:

npm install --save-dev @types/<library-name>

Learn More​