FAQ & Troubleshooting

“1-Click Demo” or sign-in fails

• Make sure the backend is running on port 8000 and the frontend on 3000.
• The backend must run with the project virtual environment's Python, not the system Python.
• If a stale process is on the port, stop it and restart the correct server.

This is almost always a stale browser cache after a new build.

1. 1

   Hard refresh

   Press Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac) to drop cached chunks.
2. 2

   Still stuck?

   Clear site data for localhost in your browser dev tools, then reload.

Most often you're viewing a different organization than the one that holds the data.

• Check the organization name shown in the header — that's your active tenant.
• The fully reconciled data lives on the demo's default organization; log out and back in to reset to it.
• Confirm the report's date range — financial reports default to FY2024-25; widen it if your data is elsewhere.
• After a backend change, refresh the page so the latest API response is used.

• Backend code changes require restarting uvicorn.
• Changes to next.config require a manual frontend restart — they are not hot-reloaded.
• Clear the browser cache after a frontend rebuild.

• Verify the customer/vendor GSTIN and the invoice place of supply — these drive intrastate vs interstate tax.
• Intrastate splits into CGST + SGST; interstate uses IGST.
• Check item GST rates and HSN/SAC codes on the lines.

Re-read the Setup guide for environment requirements, and the How-To Guides for the exact steps of the task you're doing. For report-specific reconciliation, see the Reports Guide.