FAQ

FAQ / Troubleshooting

1. Backend won't start — Communications link failure / MySQL connection error

Make sure MySQL is running locally. Confirm nestify_db database exists: CREATE DATABASE nestify_db; Double-check credentials in src/main/resources/application.properties.

2. Frontend shows CORS errors when calling the backend

Confirm the backend's CORS config (in config/) allows http://localhost:5173 as an origin. Make sure both backend (8080) and frontend (5173) are running simultaneously.

3. Login fails even with correct sample credentials

Confirm the database was seeded with the sample admin / tenant1 users (check your data initializer or run the seed SQL if provided). Check that the JWT secret in application.properties hasn't been changed between token generation and validation.

4. 401/403 errors on protected endpoints

Make sure the JWT is being sent as Authorization: Bearer in the request header. Confirm the logged-in user's role (ADMIN/TENANT) matches what the endpoint requires.

5. npm run dev fails in frontend/

Delete node_modules and package-lock.json, then re-run npm install. Confirm your Node.js version is compatible with Vite (Node 18+ recommended).

6. How do I reset the sample data?

Currently there's no reset script — consider adding a Flyway/Liquibase migration with seed data, or a simple SQL script under src/main/resources/data.sql, as a future improvement.

Have a question not answered here? Open an issue and it can be added to this FAQ.