Developer Resources

Troubleshooting

Common issues and how to resolve them.

1. • Make sure you ran npm install in the frontend/ directory
   • Check that port 5174 isn't already in use (netstat -ano | findstr :5174)
   • Delete node_modules and reinstall: rm -rf node_modules && npm install
2. • Make sure Docker is running (PostgreSQL needs it)
   • Check that the .NET 10 SDK is installed: dotnet --version
   • Check the backend terminal tab for error messages
   • If using Visual Studio, make sure DST.API is set as the startup project
3. • Verify Docker Desktop is running
   • Run docker ps to check if the dst-postgres container is running
   • Try restarting: ./scripts/end-db.bat && ./scripts/start-db.bat
   • Check that no other service is using port 5432
4. • Make sure you're in the backend/src/DST.API directory
   • Make sure the --project ../DST.Infrastructure flag is included
   • Check that the database is running
   • If the migration is out of sync, check for pending migrations: dotnet ef migrations list --project ../DST.Infrastructure
5. • Verify the route matches your controller attribute ([Route("api/...")])
   • Check that your service and repository are registered in dependency injection (DependencyInjection.cs in both Application and Infrastructure)
   • Check the backend terminal for error logs
   • Make sure the controller class has the [ApiController] attribute
6. • Verify the SYSTEM_RESPONSE_PATH in start-dev.bat points to the correct location
   • Make sure the System-Response repository is cloned and builds successfully
   • Check that port 5001 isn't already in use

7. Backend (.NET): The start-dev.bat script launches the backend with dotnet watch run. If hot reload stops working, restart the backend:

   ./scripts/end-backend.bat && ./scripts/start-backend.bat

   Frontend (Vite): Vite's HMR is usually reliable. If changes aren't reflecting, check the terminal for errors. A full page refresh (Ctrl+Shift+R) may help.

---

Additional Resources

Chart.js Documentation

Chart configuration and plugins

Explore →

Tailwind CSS v4 Docs

Utility class reference

Explore →

Entity Framework Core Docs

Migrations, configuration, and querying

Explore →

ASP.NET Core Quick Reference

Common patterns and templates

Explore →