Overview
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. Three kinds of users share the app:
Members
Apply, sign in, browse the directory, events, offers, update their profile.
Organisation admins
Approve members, manage events, offers, types, custom fields and notifications for one organisation.
Super admins
Manage all organisations, branding, domains, push keys and platform-wide settings.
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.
Getting started
Applying to join an organisation
- Open the app at the organisation's link (custom domain, subdomain, or the main app URL).
- 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.
- Choose a member type. The form will show any additional questions the admin has configured for that type.
- Fill in your details and submit. You will see a Pending approval screen on first sign-in.
- 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.
Signing in
Two methods are supported. You can use either on each visit.
Phone OTP
Enter your phone number, request a code, then type the 6-digit OTP. In the current build the code is shown on screen (mock SMS) for testing — swap in a real SMS provider for production.
Email + password
Use the email and password tied to your profile. Use Forgot password on the same screen to reset by email.
Both methods sign you into the same account — pick whichever is convenient.
For members
Once approved you have access to:
- Home: greeting, organisation stats, upcoming events and quick links.
- Members: directory of approved members. Search, filter by type or any custom field, and tap a row for full details and businesses.
- Events: browse upcoming events, RSVP, and view venue details.
- Offers: deals and promotions shared inside the organisation.
- Profile: view and edit your details, businesses, family information, profile photo and any additional fields enabled for your type.
Editing your profile
Profile → Edit covers basic info, contact details, family members, businesses, and an Additional info card that shows custom fields the admin has marked as profile-editable.
Events & offers
Events
Each event shows date, time, venue, description and an RSVP control. Past events stay accessible for reference. Admins can create, edit and cancel events.
Offers
Offers are simple promotions visible to all members of the organisation. Admins create them from the Admin tab; members browse them under Offers.
Notifications & PWA install
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.
For organisation admins
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.
- Events & Offers: create, edit, publish.
- Member types: define the categories used in the apply form and member directory.
- Fields: create custom member fields (see the next section).
- Notifications: compose and send a push to all members of the organisation.
- Export: from the Members list, current filters can be downloaded as CSV.
Custom member fields
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.
Data & security
- 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.
FAQ
I applied but cannot sign in.
Your application is pending until an admin approves it. You will see a Pending screen if you try to sign in early. Contact your organisation admin if it has been a while.
I did not receive my OTP.
The current build shows the code on screen for testing (mock SMS). In production, check your phone's SMS app and verify the phone number on your profile.
Can I belong to more than one organisation?
Yes — your account can have memberships in multiple organisations. The home screen will show the one you most recently used.
How do I uninstall the app?
On iOS/Android, long-press the icon and choose Remove. On desktop, use the browser's app management (Chrome → three-dot menu → Uninstall).
Where do I report a bug?
Tell your organisation admin, who can escalate to the super admin. Include the page URL, what you expected, and what happened.
Need more help?
Contact your organisation admin, or a super admin for platform-wide issues.