Frequently Asked Questions

ChantSync is a free Progressive Web App (PWA) that synchronises chant text across multiple devices in real time. It is designed for live worship, meditation, group prayer, and any communal chanting session where everyone needs to follow the same text at the same time.

Yes — ChantSync is completely free. There are no subscriptions, ads, or hidden costs. You can create sessions, add unlimited chants, and invite any number of participants at no charge.

No. Participants can join a session instantly by entering a session code or scanning a QR code. Session admins only need a PIN — no email or account registration is required.

Visit the ChantSync homepage and tap "Create New Session". Enter a session name and a PIN. You will receive a unique session code, a join link, and a QR code that you can share with participants.

Participants can join by visiting chantsync.app/join and entering the session code, scanning the QR code displayed in the admin panel, or opening the direct join link. No download or sign-up is needed.

ChantSync supports English, Farsi (Persian), and Dutch. Each chant can have text in all three languages. Participants choose their preferred language, and the app automatically falls back to English or any available language if a translation is missing.

Yes. When Farsi is selected as the display language, the entire interface switches to a right-to-left layout automatically.

ChantSync caches the application shell via a service worker so it loads even without an internet connection. The last known chant text and your preferences are saved locally. Once connectivity is restored, the app reconnects and resumes realtime updates automatically.

The app continues to display the last synced chant text. A status indicator shows "RECONNECTING" or "OFFLINE". When the connection returns, ChantSync automatically re-subscribes and catches up to the latest chant — no manual refresh needed.

After joining a session, you can enable push notifications. When the admin broadcasts a new chant or sends an attention ping, you receive a notification — even if the app is in the background. Notifications use your preferred language when available.

Absolutely. Push notifications are optional. The app still provides realtime in-app updates, vibration alerts, and visual flash animations when a new chant is broadcast.

Yes. All write operations go through authenticated server APIs. Admin PINs are stored only as bcrypt hashes. Session management uses JWT tokens in HttpOnly cookies to prevent cross-site scripting. Firestore security rules deny all direct client writes.

Yes. ChantSync is a Progressive Web App. On Android, tap "Add to Home Screen" in your browser menu. On iOS, tap the Share button in Safari and select "Add to Home Screen". The app then behaves like a native application with offline support.

No. ChantSync runs entirely in your browser and can be installed directly from the website — no app store download required.

An admin can create and manage chants (add, edit, delete, reorder), broadcast a chant to all participants, navigate between chants, set countdown and duration timers, lock changes temporarily, and send attention pings.

Currently, each session has a single admin who authenticates with the session PIN. Multi-admin support may be added in a future release.

ChantSync is built with Next.js 14, TypeScript, TailwindCSS, and Firebase Firestore for realtime data. Push notifications use the Web Push API with VAPID keys. The app is deployed on Vercel for fast global delivery.