Answers to common questions about using PWASK and running a SaaS product
How do I install and run it locally?
Clone the repo, copy the .env template, set your Supabase keys, then start the dev server. See the Getting Started guide for step-by-step instructions.
Can I install it as a PWA?
Yes. Use Add to Home Screen on mobile or Install App on desktop. The service worker caches the shell and content is cached on demand. You'll see a reload prompt when a new version is available.
Does it work offline?
Yes — it's offline-first. Writes are queued in IndexedDB and sync when you're back online. Large uploads are retried with exponential backoff.
Which browsers and devices are supported?
Modern browsers (Chrome, Safari, Firefox, Edge) and current iOS/Android are supported by default. Legacy browsers are not supported out of the box.
How are users authenticated?
Supabase Auth supports email/password, magic links, and OAuth providers like Google and GitHub. Use anon keys in the client only; keep service_role keys server-side.
How do roles and permissions work?
Enable RLS on all user/tenant tables and use role-based policies (viewer/editor/admin). Test policies with multiple accounts and avoid broad rules.
What security measures are recommended?
Enforce TLS, use secure cookies, validate inputs server-side, and prefer signed URLs for private assets. See the Security guide for details.
How do I back up and restore data?
Enable automated Postgres backups, periodically export critical storage, and rehearse restores in staging. Hosted plans include regular backups and export tools.
How should I handle updates with offline clients?
Version your service worker/assets, provide IndexedDB migrations when schemas change, and surface a "New version available" in-app prompt to reload gracefully.
What about privacy and GDPR?
We minimize personal data and provide export/deletion options. See our Privacy Policy for legal bases, cookies, and international transfers.
What pricing plans do you offer?
We offer a developer-friendly plan with everything included and commercial licensing. See the Pricing page for current rates and the Licencing page for usage rights.
Can I self-host?
Yes. The starter is designed to deploy on your infrastructure. We provide environment and production configuration guidance in the docs.
Which integrations are available?
Supabase, Stripe, common OAuth providers, and optional email providers are included. It's straightforward to add more integrations.
How can I get support?
Join our Discord for community support. Paid plans include priority support and optional SLAs. Enterprise support is available on request.
Do you support multiple languages?
Yes — next-intl powers i18n. Add locales by providing message files and enabling them in configuration. The language switcher preserves the current route.
How do payments and billing work?
Stripe examples are provided. For subscriptions or marketplaces, add server-side webhooks and background workers, and always verify signatures.
How do I delete or export my data?
Provide in-app account deletion and a contact for manual requests. For portability, offer CSV/JSON exports and include related assets when applicable.
Troubleshooting tips?
401/403: check session freshness, anon vs service_role usage, and RLS rules. SW not updating: unregister or bump the version. Image 404s: verify next/image domains and storage policies.