Troubleshooting & FAQ
If the app reaches the database but reports missing tables (or columns), the schema scripts haven't been fully run for the features in use.
What should you check if the app connects to the database but reports missing tables?
If the app reaches the database but reports missing tables (or columns), the schema scripts haven't been fully run for the features in use.
Why might emails be logged instead of sent, and how do you enable real sending?
If emails appear in logs but don't actually send, the deployment is likely using a log/test send provider rather than a real one — useful in development to avoid sending live mail.
What SMTP settings are needed (e.g. Gmail App Password) and why must From match the sender?
For SMTP sending you typically need the host, port, username, password, and TLS setting of your mail service.
Why can only one website template be active, and how do you change the active one?
Only one template is active at a time because the storefront must present a single coherent experience — two live themes would be ambiguous.
What happens to admin edits when the app restarts and re-seeds (idempotency)?
Seeding is idempotent — on restart, the app ensures required baseline data exists (like the protected Super Admin role and default configuration) without overwriting your edits.
How do you reset a deployment to a clean state safely?
To reset safely, use the "delete everything & start fresh" reset (in the setup Welcome step) or the standalone Data Erase tool.
How do you resume an interrupted setup or catalogue import?
Setup is resumable — its progress is persisted per step, so an interrupted or skipped setup picks up where it left off, showing what's done and what remains.
What are the open decisions still required before technical design (stack, data model, timeline)?
At the original requirements stage these were open: backend stack, the detailed data model, the architecture (monolith vs microservices), the timeline/MVP scope, specific regional providers, and…