Documentation

The Organisation App is a multi-tenant community platform. A single installation can host many organisations, each with its own members, events, offers, branding, and (optionally) custom domain. Two kinds of users share the app:

The app is installable as a Progressive Web App (PWA) on phones and desktop, works offline for previously visited pages, and can send push notifications when the user opts in.

Applying to join an organisation

1. Open the app at the organisation's link (custom domain, subdomain, or the main app URL).
2. Tap Apply. If the organisation was detected from the URL, its logo and member types are pre-loaded; otherwise pick an organisation from the dropdown.
3. Choose a member type. The form will show any additional questions the admin has configured for that type.
4. Fill in your details and submit. You will see a Pending approval screen on first sign-in.
5. Once an admin approves you, you can sign in and access the full app.

First sign-in

If a required profile field is missing, you will be sent to Edit profile with a banner explaining what to complete before reaching the dashboard. If an admin created your account with a temporary password, you will be prompted to change it.

Two methods are supported. You can use either on each visit.

Both methods sign you into the same account — pick whichever is convenient.

Once approved you have access to:

• Home: your photo & greeting, today's active daily activities, latest / pinned offers, upcoming events and a Scan shortcut.
• Members: directory of approved members with search, filters, share and print.
• Events: browse events and RSVP for yourself, family members and guests before the registration close date.
• Offers: browse organisation and member-posted offers; post your own if the admin enabled it.
• Announcements: pinned + upcoming announcements with date, image and details.
• My activities: your daily activity registrations and attendance history.
• Profile: edit basic info, photo, family (with photos), guests (with photos), businesses (with logo) and custom fields.
• Side menu: your personal QR code for admin scanning, plus quick access to Profile and settings.

Editing your profile

Profile → Edit covers basic info, contact details, family members (each with their own photo, editable inline), guests, businesses (with logo upload), and an Additional info card that shows custom fields the admin has marked as profile-editable. Address fields use cascading Country → State → City dropdowns.

Admins broadcast announcements with a name, description, image, event date/time, address and a publish date. Announcements go live automatically on the publish date and stay visible while their event date is still upcoming. Members open Announcementsfrom the footer to browse date-wise with search and pagination, and tap a card to open the detail page.

• Pinned announcements appear at the top with a "Pinned" badge.
• A push notification goes out on the publish date, and a daily reminder is sent every morning until the event date passes.
• The share image (OG card) uses the announcement's own image, so links look great on WhatsApp and social media.

Daily activities are recurring activities (morning walk, yoga, class, prayer) that members register for each day before a cutoff time. The Home screen highlights every active activity with its next open date and cutoff time (shown in 12-hour AM/PM).

• One-tap register / unregister for the current day (or tomorrow, once today's cutoff has passed).
• Skip dates configured by the admin show as "Holiday" and block registration for that date.
• Reminders auto-fire before the cutoff time (interval set by the admin).
• Members see their own history under My activities with a date-range filter.

Marking attendance with QR

Every member has a personal QR code at the top of the side menu. Every daily activity has its own QR code that admins can download as a PDF and post on-site.

Admins can enable a leaderboard per activity. Points are earned as 5 pts per registration + 8 pts per attendance, and members are ranked highest-first.

• Search by name, sort by Rank / Name / Points, and toggle ascending / descending.
• The list infinite-scrolls so large communities load smoothly.
• Tap any member to open a popup with their totals and a date-wise Attended / Absent breakdown.

When an admin enables Member offers for the organisation, approved members can post their own offers from the Offers tab. Every new member offer:

• Sends an in-app notification to every other member of the organisation.
• Fires a push notification to every subscribed device.
• Can be edited or removed by its author, and moderated by admins.

Every member has a public profile page at /m/<member-id> that they can share with anyone — no sign-in required. The page shows the member's photo, name, age, address, family members and businesses, and generates a rich share preview (OG card) with the member's photo and family count so WhatsApp, LinkedIn and X previews look polished.

A Share icon in the Members directory copies or opens the native share sheet with the same link.

Install as an app

Open Install for step-by-step instructions on iOS, Android, and desktop. Installed, the app launches full-screen, works offline for cached pages, and behaves like a native app.

Push notifications

From Profile you can opt in to push notifications. Permissions are per-device — opt in on each phone or browser where you want alerts. Admins broadcast notifications from the Admin tab.

Admins see an extra Admin tab in the bottom navigation. From there you can:

• Applications: review pending applications, approve or reject. Approval creates the member's account and copies any custom answers into their profile.
• Members: manage existing members, edit details, deactivate, reset passwords, print the directory.
• Events: create/edit events with an image, description, venue and a registration close date after which member RSVPs lock.
• Offers: create official offers, pin them to the Home screen, and toggle whether members can post their own offers.
• Announcements: create with image, on-date/time, address and publish date; pin the important ones; push + daily reminders fire automatically.
• Daily activities: create with name, description, cutoff time, reminder minutes-before, skip dates (holidays), leaderboard on/off and active/inactive status.
• Activity scan & reports: open the QR scanner, choose the activity and date, mark attendance; export attendance CSV or PDF filtered by date range; download the activity's own QR poster as PDF.
• Member types & Fields: define categories and custom fields; add/edit/delete fields directly from the Fields page.
• Notifications: compose and send a push to all members of the organisation.
• Sponsors: highlight partners with rotating splash and strip placements.
• Export: from the Members list, current filters can be downloaded as CSV.

Each organisation can add its own fields on top of the standard profile. Supported field types:

When creating a field, choose:

• Which member type it applies to (or all types).
• Whether it appears in the signup form, in the profile editor, or both.
• Whether it is required.
• Options (for select / multi-select fields).

In the Members directory, every select, multi-select and booleancustom field automatically becomes a filter, and CSV exports respect the active filters.

• Each organisation's data is isolated by row-level security; members and admins of one organisation cannot read another's data.
• User roles (member / admin / super admin) are stored in a dedicated table and checked server-side via a security-definer function — they cannot be elevated from the client.
• Phone OTP codes and password-reset tokens are stored server-side, single-use and time-limited.
• Uploaded files are stored in private buckets; signed URLs are generated on render.
• Push subscriptions are scoped per device and per organisation, and can be revoked from the profile screen at any time.