Demo

Troubleshooting

Common Quark ERP local issues — plugin not loading, hot reload stuck, Tailwind missing, DI failures, and env/DB mistakes. Open a topic below before contacting Support.

Where to start

Most issues come from confusing source vs available vs installed, skipping Install, or metadata mismatches. Confirm the base stack is up, then the plugin build, then the installed module row.

  • Base stack running — quan-erp base:dev / Docker Compose healthy
  • Plugin built — artifacts under base/available-plugins/<name>/<version>/
  • Module installed — copy under base/backend/installed-plugins/<name>/
  • Metadata consistent — folder name === module.metadata.json name

Topics

  • Plugins installed but frontend module not loaded
  • Hot reload not updating the UI
  • Tailwind CSS not working in plugins
  • Watch / build path errors
  • Backend boot / DI failures
  • Frontend UI missing or 403
  • Database / env connection issues

Still stuck?

Collect platform version, plugin metadata, environment, logs, and reproduction steps, then contact Support.