All of the guide

Tap “Print or save as PDF”. To make a PDF, choose “Save as PDF” as the printer. On a phone it is in the same menu.

Koina

How to use Koina

A step-by-step guide for a jumuiya's officers and members. Buttons are named as they appear on screen, in “quotes”.

  1. Your first evening · Every officer, on the day the jumuiya starts on Koina
  2. Treasurer · Whoever keeps the jumuiya's money
  3. Secretary · Whoever keeps the register, the minutes and the calendar
  4. Moderator · The Moderator (some jumuiyas say Chairperson)
  5. Members · Every member of the jumuiya

The latest version is always at www.koina.co.ke/guide

Your first evening

Every officer, on the day the jumuiya starts on Koina

Five jobs bring a jumuiya onto Koina. Your home page lists them on a card called “Getting started”, and ticks each one by itself once the records hold it. Take them in any order.

1. Find your way around

Where: Any screen

  1. On a phone, the bar along the bottom has four pages and a button called “More”. An officer's four are “Home”, “Members”, “Giving” and “Events”.
  2. Tap “More” to see every other page, grouped under “Community”, “Money”, “Faith”, “Records” and “Jumuiya”.
  3. On a computer the same pages are listed down the left side.
  4. At the top right, the bell opens the notices, and the circle with your initials opens a menu with “My account”, “Install Koina”, “View as a member” and “Sign out”.
The screen, drawn. The green ring is where to tap.

Good to know

  • “View as a member” shows you exactly what an ordinary member sees. A banner at the top takes you back.

2. Put Koina on your phone's home screen

Where: Your initials (top right) → “Install Koina”

  1. On Android, open Koina in Chrome, tap the ⋮ menu at the top right, and choose “Install app” or “Add to Home screen”.
  2. On an iPhone, open Koina in Safari, tap Share (the square with an arrow pointing up), scroll down and choose “Add to Home Screen”, then tap “Add”.
  3. On a computer, in Chrome or Edge, click the install icon at the right of the address bar.
The screen, drawn. The green ring is where to tap.

Good to know

  • There is no app store and nothing to pay. Your records are kept by Koina, not on the phone.
  • On a Samsung phone, use Chrome, not Samsung Internet. Koina shows an “Open in Chrome” button when it sees Samsung Internet.
  • If the link was opened inside WhatsApp, open it in Chrome or Safari first; WhatsApp's own browser cannot install it.

3. Add your households

Where: More → Settings → “People & access” → “Import members”

  1. If you keep the register in Excel, choose the file under “Register file” and tap “Add from file”. The first sheet needs a column headed Name, one household per row. A Phone column is used if it is there.
  2. Or type or paste the names under “Or paste a list”, one per line, as Name, Phone (the phone is optional), and tap “Import members”.
  3. Open a few households afterwards and check that couples were split correctly.
The screen, drawn. The green ring is where to tap.

Good to know

  • Households already on the register are skipped, so uploading the same file twice is safe.
  • To add one household at a time, open “Members” and tap “Add”.
  • Only the Moderator and Secretary can add or change households.

4. Give the other officers their logins

Where: Members → the officer's household → “App access”

  1. Make sure the officer is on the register as an adult in their household.
  2. On their household's page, under “App access”, tap “Send … a sign-in link” and send the message it writes. They open the link and choose their own password.
  3. The Moderator then opens Settings → “People & access” → “Team & access”, taps the person's row, picks their “Role” and taps “Set role”.

Good to know

  • Only the Moderator can make someone a Secretary, Treasurer or Moderator.
  • A sign-in link is for one person and works for 7 days.
  • Each officer signs in as themselves. Do not share one login: the activity log records who did what.

5. Record a first payment

Where: Giving → “Record a contribution”

  1. Start with this month's Kitty. The Treasurer's section below shows how to read it straight from the M-Pesa message.

6. Record a meeting

Where: More → Meetings → “New meeting”

  1. Enter the date, the host and who led. The Secretary's section below shows how to take attendance.

7. Bring the members in

Where: More → Settings → “People & access” → “Members set up their own logins”

  1. At a meeting, choose how long the code should work (“8 hours” suits a meeting day) and tap “Open sign-in”.
  2. Read the code out. Each member opens the joining page on their phone, enters their phone number and the code, and chooses a password.
  3. For those who were absent, use “Share” to send the group a link with the code already in it.
The screen, drawn. The green ring is where to tap.

Good to know

  • A member must already be on the register with a phone number, or the code will not find them.
  • Husband and wife each set up their own login.
  • New logins appear on your home page under “New on Koina” for a week. If one isn't who it says, remove it there.

8. Your own password, number and notices

Where: Your initials (top right) → “My account”

  1. To change your password, use the “Change password” card: “Current password”, “New password”, “Confirm”.
  2. To sign in with a different number, use “How you sign in”: enter the number and your password, then “Change number”.
  3. To get notices on your phone even when Koina is closed, use “Notices on this phone” and tap “Turn on for this phone”. Choose which kinds you want and tap “Save choices”.

Good to know

  • There is no “forgot password” link. A member asks the Secretary to reset it; an officer asks the Moderator.
  • Notices on the phone work best once Koina is installed on the home screen.

Treasurer

Whoever keeps the jumuiya's money

Your pages are under “Money”: Giving, Dues follow-up, Expenses, Welfare, Payments and Reports. Every amount is in whole shillings. Every correction is kept in the activity log, so the books can always be explained.

1. Record a contribution from an M-Pesa message

Where: Giving → “Record a contribution”

  1. On your phone, press and hold the M-Pesa message and copy it.
  2. In Koina, open “Giving” and tap “Record a contribution”.
  3. Tap “Paste M-Pesa SMS to pre-fill”, paste the whole message into the box, and tap “Scan SMS”.
  4. Koina fills in the amount, the M-Pesa code, the date and, when it recognises the name, the member. Check the line it shows under the box.
  5. If it says no member matched, pick the member yourself. Koina then offers “Remember this sender”, so the next message from that name is matched for you.
  6. Choose the “Category” (the fund). The message never says which fund, so this is always yours to choose.
  7. Tap “Record contribution”.
The screen, drawn. The green ring is where to tap.

Good to know

  • One message at a time. To check many messages at once, use “Reconcile with the phone” (below).
  • If the code is already on the books, Koina stops you and shows the earlier entry.
  • For a payment that covers two funds, tap “Split across categories” and place the amounts until it says “All placed”.
  • If the category is Welfare, you must also choose “Which cause?”.

2. Record a cash contribution

Where: Giving → “Record a contribution”

  1. Choose the “Member”, enter the “Amount (KES)” and set “Method” to “Cash”.
  2. Choose the “Category”.
  3. Set “Date given” to the day the money was actually given, so it lands in the right month.
  4. Tap “Record contribution”.

3. Correct or remove an entry

Where: Giving → tap the entry in the list

  1. Tap the entry to open it.
  2. Change what is wrong and tap “Save correction”.
  3. If it should not be there at all, tap “Void entry” and confirm.

Good to know

  • Voiding cannot be undone. Both corrections and voids are recorded in the activity log.

4. Follow up on dues

Where: More → Dues follow-up

  1. The page opens on “Behind”: households with a month or quarter that is over and not paid.
  2. Tap “Remind” beside a household. Choose what to ask for (“Overdue”, “Up to this month” or “Whole year”) and read the message; change anything you like.
  3. Tap “WhatsApp”, “SMS” or “Copy”. Your own WhatsApp or messages opens with the text written. Press send there.
  4. To go through everyone, tap “Remind these …, one by one”.
The screen, drawn. The green ring is where to tap.

Good to know

  • Koina sends nothing by itself. It opens your phone's WhatsApp or SMS, and notes that you did.
  • Households reminded in the last week are left out of the round.
  • Only funds marked as required appear here. Set that in Settings → “Money” → “Categories & campaigns”.

5. Record an expense

Where: More → Expenses → “Record an expense”

  1. Tap “Record an expense”.
  2. If it was paid by M-Pesa, tap “Paste M-Pesa SMS to pre-fill”, paste the message and tap “Scan SMS”. Koina fills in the amount, date, who was paid and the code.
  3. Fill in “What was it for?” and choose a “Category”.
  4. Under “Authorised by”, choose the approved request, the resolution, or “The approved budget”.
  5. If the message shows a transaction cost, leave the box ticked: Koina records the fee as its own expense.
  6. Tap “Record expense”.
The screen, drawn. The green ring is where to tap.

Good to know

  • Koina does not keep photos of receipts with an expense. Keep the paper receipts as you do now.
  • An expense with nothing behind it is flagged for the Committee until a resolution or budget covers it.

6. Pay an approved request

Where: More → Payments → “Approved — to pay”

  1. Any officer asks with “Ask for a payment”. The Moderator approves. You pay.
  2. Under “Approved — to pay”, read the request and any note for the Treasurer.
  3. Send the money by M-Pesa, or hand over the cash.
  4. Tap “Record payment”. The expense form opens already filled in from the request.
  5. Paste the M-Pesa message if there is one, and tap “Record expense”. The request moves to “Paid”.
The screen, drawn. The green ring is where to tap.

Good to know

  • Nobody approves their own request, the Moderator included.

7. Check the books against the phone

Where: More → Expenses → “Reconcile with the phone”

  1. Copy every M-Pesa message since the day the phone and Koina last agreed, and paste them all into the box. As many as you like.
  2. Tap “Check against Koina”.
  3. Read “Phone balance” and “Koina balance”, and what Koina reads between them.
  4. Work through each list: fees not recorded (tap “Add KES … fee”), money paid or received that is not in Koina (tap “Copy SMS”, then record it under Expenses or Giving).
The screen, drawn. The green ring is where to tap.

Good to know

  • Checking saves nothing. Only the fee button writes to the books.
  • Koina's balance includes cash, so a gap that remains may be cash held off the phone.

8. Keep a welfare case's money

Where: More → Welfare

  1. Tap “Open welfare case”, choose the “Beneficiary”, name the cause, and tap “Open case”.
  2. Record gifts as they come: either on the case with “Add pledge”, or from Giving by choosing the category Welfare and the cause.
  3. When the money goes to the family, open the case and tap “Send money to the family”. Enter the amount, the date and who received it, then “Record money sent”.
  4. When it is finished, tap “Close case”.

Good to know

  • An officer cannot open or handle a case for their own family; another officer does it.
  • Members see the causes and can pledge, but never who gave what.

9. Produce the monthly and annual reports

Where: More → Reports

  1. Choose “Monthly” or “Yearly”, then the month or year.
  2. Read the cash summary: brought forward, money in, money out, balance to date.
  3. Tap “Excel” or “PDF” to download it, “Print” to print, or “Copy summary” for a short text to paste in the WhatsApp group.
  4. Under “More reports” you will find “Dues & arrears”, “Budget vs actual”, “Participation”, “Audit & corrections” and the “Annual report”, each as PDF and Excel.
The screen, drawn. The green ring is where to tap.

10. Send a family its giving statement

Where: More → Reports → “View & send to members”

  1. Choose the period (“This year”, “Last year”, or your own dates).
  2. Beside the household, tap the WhatsApp or SMS icon. The message is written for you, with a link to their statement.
  3. Press send in your own WhatsApp or messages.

Good to know

  • Each member can also open their own statement at any time, under “Giving”.

11. Set up the funds and the dues

Where: More → Settings → “Money”

  1. Under “Categories & campaigns”, add a fund by typing its name and tapping “Add”.
  2. For each fund, choose under “Each household” whether it is voluntary or required every month, quarter or year, and enter the amount. Tap “Save”.
  3. Under “Budget”, enter what the Committee approved for the year.

Good to know

  • The fund named “Welfare” must keep that exact name; welfare cases depend on it.
  • The opening balance (cash brought forward) is on the “Jumuiya” tab, which the Moderator or Secretary sets.

12. Pay Koina's own subscription

Where: More → Billing

  1. Choose “Monthly”, “Quarterly” or “Annual” and tap “Get the invoice”.
  2. To pay from this phone, enter the M-Pesa number and tap “Send request”, then enter the PIN when the prompt appears.
  3. Or pay from any phone by Lipa na M-Pesa paybill, using the business number and the account number shown. Use that account number every time.
The screen, drawn. The green ring is where to tap.

Good to know

  • Record the subscription in the jumuiya's books as an expense, like any other. Koina does not add it for you.

Secretary

Whoever keeps the register, the minutes and the calendar

Your pages are Members, Meetings, Events, Minutes, Notices and Documents. You bring members in and reset their passwords. You see the money pages but cannot change them.

1. Add or change a household

Where: Members

  1. To add one, tap “Add”, enter the “Name” and phone, and tap “Save member”.
  2. To change one, tap it, open “Edit details”, and tap “Save changes”.
  3. To add a spouse or child, open the household and tap “+ Add someone to this household”. Enter the name, adult or child, birthday and, for an adult, their own phone. Tap “Add person”.
The screen, drawn. The green ring is where to tap.

Good to know

  • A household is never deleted; use “Mark inactive” in “Edit details”.
  • Removing a person from a household cannot be undone.
  • Birthdays entered here fill the Birthdays page.

3. Reset a member's password

Where: More → Settings → “People & access” → “Team & access”

  1. Tap the person's row.
  2. Under “Reset password”, type a temporary password of at least 8 characters and tap “Reset”.
  3. Tell them the temporary password. They are asked to choose their own the next time they sign in.

Good to know

  • Only the Moderator can reset an officer's password.

4. Record a meeting and take attendance

Where: More → Meetings

  1. Tap “New meeting”. Enter the “Date”, the “Host” and the “Leader”, and tap “Create meeting”.
  2. Open the meeting. Under “Attendance check-in”, tap each person who came, or a household's “All”.
  3. There is no save button: each tap is saved as you go.
The screen, drawn. The green ring is where to tap.

Good to know

  • What was agreed goes in the minutes, not here.
  • More → Attendance shows who has not been seen in three months.

5. Write, circulate and confirm minutes

Where: More → Minutes → “New minutes”

  1. Choose “Which meeting” and the date, leave “Start from the usual agenda” ticked, and tap “Start the minutes”.
  2. Tap “Take attendance” and mark who was present and who sent an apology.
  3. Under “Business”, give each item a “Heading” and “What was said”, and tap “Save”.
  4. For a decision, tap “Resolution” under the item, write “Resolved that…”, and tap “Record resolution”.
  5. Under “Actions”, add who will do what, by when.
  6. When the draft is ready, tap “Circulate”. Members are told the minutes are there to read.
  7. At the next meeting, tap “Confirm as a true record”.
The screen, drawn. The green ring is where to tap.

Good to know

  • Confirmed minutes can no longer be changed.
  • Management Committee minutes are seen by the Committee only. Members never see drafts.
  • The “Share” card gives a WhatsApp text and “Download PDF”.

6. Put a Mass or event on the calendar and find a host

Where: Events → “New event”

  1. Tap “New event”, enter the “Title”, “Type”, “Date” and “Time”, and tap “Create event”.
  2. For a House Mass, open the event. Under “Hosting”, choose the family and tap “Set host”. The list shows who is next in the rota.
  3. Or tap “Ask who can host”. Members then see it is looking for a host and can tap “We can host”.
  4. To send the rota to the group, tap “Share the rota” on the Events page.
The screen, drawn. The green ring is where to tap.

Good to know

  • Changing an event's date or venue posts a notice, so members see the change.

7. Plan readers and servers

Where: More → Readers & servers

  1. Set the duties every Mass needs, and tap “Save the list”.
  2. Tap a slot on a Mass to choose a person, or tap “Fill … gaps fairly” to let Koina share them out.
  3. Tap “Tell those on duty” to send each household its own readings and serving.

8. Post a notice to everyone

Where: More → Notices → “Post a notice”

  1. Type the notice as the title.
  2. Choose what it is “About”: a general notice, welfare, a meeting or event, or dues and giving.
  3. Add “Details” if needed and tap “Post notice”.
The screen, drawn. The green ring is where to tap.

Good to know

  • A notice goes to every member in the app. Keep announcing on the WhatsApp group as usual: Koina does not post there for you.

9. Keep documents and letters

Where: More → Documents, and More → Correspondence

  1. In Documents, tap “Add a file”, choose the file, give it a title, and choose “All members” or “Leaders only” under “Who sees it”.
  2. In Correspondence, tap “Write a letter”, “Record a letter received” or “Record one already sent”. Each letter gets its own number.
  3. After saving a letter, “PDF on the letterhead” gives a copy to print and sign.

10. Work with the parish office

Where: More → Our parish

  1. Under “Circulars”, open one and send the jumuiya's answer.
  2. Under “Pastoral requests”, ask for a sick call, a requiem Mass or a house blessing. Tick that the family agrees, and tap “Send to the parish office”.
  3. Under “Membership letters”, choose the person and the sacrament and tap “Issue the letter”.

Good to know

  • These need the jumuiya to be linked to its parish, which the Moderator does.
  • A membership letter says membership only, never dues.

Moderator

The Moderator (some jumuiyas say Chairperson)

You can do everything the Secretary and Treasurer can. Three things are yours alone: approving payments, deciding who holds which role in the app, and linking the jumuiya to its parish.

1. Read your home page

Where: Home

  1. At the top is the balance: all money in, less all money out, with M-Pesa and cash shown apart.
  2. Money held for a purpose (welfare cases, ring-fenced funds) is listed separately, so you can see what is the jumuiya's own to spend.
  3. Below are this month's figures, new logins, members not yet on Koina, and open welfare cases.
  4. Switch between “This month” and “This year” at the top.

2. Approve or decline a payment request

Where: More → Payments → “Waiting for approval”

  1. Read the request: the amount, what it is for, and who asked.
  2. Tap “Approve”. If a resolution already covers it, choose that resolution; otherwise approve now and the next meeting ratifies it.
  3. Add a note for the Treasurer if you wish, and confirm.
  4. To refuse, tap “Decline” and say why.
The screen, drawn. The green ring is where to tap.

Good to know

  • You cannot approve your own request; another officer with the Moderator role must.
  • The Treasurer is told as soon as you approve.

3. Decide who can do what

Where: More → Settings → “People & access” → “Team & access”

  1. Tap a person's row.
  2. Choose their “Role” (Moderator, Secretary, Treasurer or Member) and tap “Set role”.
  3. Use “Remove login” when someone leaves office or the jumuiya.
The screen, drawn. The green ring is where to tap.

Good to know

  • An office title on someone's household page gives them no access by itself. The role here does.
  • There must always be at least one Moderator, and you cannot change your own role.
  • After an election, change the roles here on the day of the handover.

5. Run an election and hand over

Where: More → Offices & elections

  1. Call the election: the day, the offices to fill, and why.
  2. After the ballot, record the results: who was elected and who conducted it.
  3. Open Settings → “People & access” and change the roles, so the new officers can work and the old ones no longer can.

Good to know

  • Nothing changes in the app by itself when results are recorded. Changing the roles is the handover.

6. Prepare the AGM pack

Where: More → AGM

  1. Choose which entry on the calendar is the AGM.
  2. Write “The Moderator's report”. The Treasurer writes “The Treasurer's note”; the figures come from the books.
  3. Tap “Circulate to members”. Every member gets a notice and can read the pack.
  4. After the meeting, tap “Mark as held”.

Good to know

  • Until it is circulated, only the Committee sees the pack.

7. Appoint the prayer-partner steward

Where: More → Settings → “Prayer”

  1. The steward is the one person who sees who prays for whom. By default it is the member who holds the Moderator title.
  2. To appoint someone else, choose them in “Prayer-partner steward” and tap “Appoint”.

8. See who did what, and who is using Koina

Where: More → Activity log, and More → App usage

  1. The Activity log lists every entry, correction and void, with who made it and when. Filter by kind, person or date.
  2. App usage shows who has a login, when they last used it, and who has never signed in.

Members

Every member of the jumuiya

A member sees their own family's giving, the jumuiya's notices, calendar and minutes, and the prayer book. A member never sees what another family gave.

1. Sign in for the first time

Where: The joining page, from the link your Secretary sent

  1. With a joining code: enter the phone number the jumuiya has for your family and the code, and tap “Continue”. Say who is signing in, choose a password, and tap “Create my login”.
  2. With your own link: open it, choose a password, and tap “Create my login”. No code is needed.
  3. Next time, sign in with your phone number and that password.
The screen, drawn. The green ring is where to tap.

Good to know

  • If Koina cannot find you, your family is not on the register yet or has no phone on it. Ask your Secretary.
  • Forgotten your password? Ask your Secretary to reset it.

2. See your giving and your statement

Where: Giving

  1. “Giving” shows what your household has given and where your dues stand.
  2. Tap “My giving statement” for any period, with a PDF to keep.
The screen, drawn. The green ring is where to tap.

3. Pray with the jumuiya

Where: Sala (Prayer book), and Home

  1. The prayer book has the prayers, the songs and the day's Mass readings, in English and Kiswahili. Once opened, a prayer works without signal.
  2. On Home, “Pray the Rosary” opens today's mysteries.
  3. Under More → Prayer partners you see who you are praying for, and can share an intention.

4. Take part

Where: Events, Welfare and Gallery

  1. On an event, say whether you are coming, or tap “We can host” when a Mass is looking for a host.
  2. In Welfare, open a cause and enter what your household pledges. Pay the Treasurer as usual.
  3. In the Gallery, open an album and add your photos. A leader looks at each one before the jumuiya sees it.
  4. Under My account → “My household”, add your spouse, your children and their birthdays.