How to use OCIVO

Everything each person needs, from a patient's first screen to the research console. Find your role in the contents and start there.

Updated 24 September 2026 · build ocivo 2026-09-24h · Print or save as PDF

Getting started

OCIVO is a phone- and tablet-based vision screen that takes 8–10 minutes and tells each person what to do next. It is a DoktorConnect engine, sister to Otivo (hearing). It screens; it does not diagnose. All pass lines are provisional until the consultant ophthalmologists sign them off.

Where it lives

Old links that point at myocivo.com (sign-in emails, printed code slips, invites) are forwarded to the app automatically.

Who does what

Signing in. Every signed-in role uses the same email sign-in. Enter your email, open the link OCIVO sends, and open it in the same browser. A person screening themselves can skip sign-in, but their result is then not saved.

The app's tabs. Person's journey runs a screen. Journey map shows every step and the design notes. Clinic is for staff. Eye specialist is the referral inbox. My results appears when a patient is signed in. Design notes and Specialist mode sit at the top right.

Running a clinic screen

A clinic screen takes 8–10 minutes and follows the same steps every time; OCIVO skips any step a person does not need. The order is: register the patient, safety check, questions, set up the screen, distance test (right eye, then left), pinhole (only if an eye fails), near test, extra checks, blood pressure and sugar, result, next step and save. The clock starts at the first tap and stops at the result.

What you need: the phone or tablet at full brightness, a bank card for calibration, a tape measure or a 3 m mark on the floor, a pinhole card, and red-cyan 3D glasses for children.

1. Register the patient. In the Clinic tab, enter a clinic file number (not a name) and year of birth. OCIVO creates a 6-character patient code. Tap Continue.
2. Consent. Read the statement to the patient and tick I understand. The research box is optional; screening does not depend on it.
3. Safety check. Ask each question. Any yes (sudden vision change, a curtain or shadow, painful red eye, new double vision, eye injury, stroke signs, a white glow in the pupil) stops the screen and sends the person for same-day care.
4. Questions. Age, glasses, diabetes, blood pressure, family glaucoma and the rest. These build the Eye-Health Risk Profile. Under 12, the children's questions appear instead (see Screening children).
5. Set up the screen. Hold a bank card against the screen and slide until the outline matches. OCIVO remembers this on the device for 7 days. Choose the distance (3 m standard, 2 m in a small room) and who answers (a helper taps, or the patient speaks or taps).
6. Distance test. The patient covers the left eye with a palm, both eyes open, no pressing. One E appears; they say or show which way its bars point, and the helper taps the arrow. Can't tell is always allowed. Then the right eye is covered and the left tested. About a minute per eye.
7. Pinhole. Only if an eye is below the line: the patient looks through a pinhole card. If vision improves, glasses will likely help; if not, it is a doctor referral.
8. Near test. At reading distance (about 40 cm), both eyes. Skipped under age 8.
9. Extra checks. Whichever the clinic has switched on and the age allows: macular grid, contrast, colour, and the 3D check for children.
10. Blood pressure and sugar (adults). Type the readings, or tap Get latest readings if the patient is linked to DoktorConnect. Skip if not measured.
11. Result. The result, what it means and the AI-written report. See Results, the AI report and sharing.
12. Next step. Enter the patient's mobile number and tick reminders consent if they agree, then Finish and save. Follow-ups open automatically.

Extra checks at a glance

Camera checks. If the clinic has them on, a chip in the test bar warns Move closer or Is your right eye covered?. They are advice only, and the camera picture never leaves the phone.

Screening children

OCIVO screens from age 3. Enter the child's age on the questions screen and the children's pathway switches on by itself. Under age 3, OCIVO asks for a photoscreener or an eye professional instead.

Before you start: print the HOTV matching card (a link on the test screen opens it), have an eye patch or tape and tissue, and red-cyan paper 3D glasses. Ages 3 and 4 need two adults: a parent sits with the child and a second adult taps the answers.

1. Children's questions (under 12): glasses, last eye exam, an eye turn the parent has noticed, squinting or sitting close to screens, born very early or very small, lazy eye or eye turn in the family, diabetes, sickle cell.
2. Letters instead of the E (ages 3–7): one letter at a time, H, O, T or V. The child points to the same letter on the matching card; the helper taps it. The child does not need to read.
3. Distance: 1.5 m for ages 3–5, 3 m from age 6. OCIVO sets this for you.
4. Cover the eye properly: use a patch or tape and tissue, never a hand. Children peek.
5. The 3D check (ages 3–11): take the patch off, put the glasses on with the red lens over the left eye (over their own glasses if they wear them), and hold the screen 40 cm away. The first picture is practice. Then the child points to the hidden shape; the pictures get harder until they stop seeing it. Without the glasses nothing can be seen.

What changes by age

When a child is referred. Below the vision line for their age, a gap of two lines or more between the eyes, an eye turn the parent has noticed, or not passing the 3D check (400 seconds of arc under age 5, 200 from age 5, provisional) all send the child to an eye doctor. Born very early with no eye exam adds a full eye examination. The report is written to the parent.

Results, the AI report and sharing

Every screen ends with one clear next step, shown as a coloured banner, then a plain-language report written by AI and checked before it is shown.

All thresholds are provisional until the consultants sign them off.

Two scores, kept apart. The Vision Function Index says how well the eyes see today. The Eye-Health Risk Profile says how likely hidden eye disease is. A person can see well and still be at risk.

The AI report never names a diagnosis, never says the eyes are healthy, and always says it is a screen. If the AI is unavailable, standard wording is used instead. The clinician addendum (trial detail, calibration, camera readings) is for staff only.

Print. On the result screen, Print or save as PDF before you finish.

The private patient link. After Finish and save, the Screen saved page offers Create patient link. The same button is in the patient's history, the Eye specialist inbox and the patient's own My results.

1. Tap Create patient link.
2. Send it one of four ways: Copy it, Share… through the phone (WhatsApp and others), Send text to the number shown, or Send email (or open my email app).
3. The patient opens a page with their result, what it means, the next step, follow-up dates and the checks done.

The link lasts 30 days, can be withdrawn, and records how often it is opened. It never shows history answers, staff names, patient codes or clinic notes. Anyone holding the link can see the result, so send it only to the patient or, for a child, the parent. Texts need SMS keys on DoktorConnect Core; until then, copy or share it.

Follow-ups and reminders

Every screen that needs action opens a follow-up automatically when it is saved, with a due date set by the result (see the table in the previous section). Staff work them from the Follow-ups panel in the Clinic tab.

The five lists

Working a follow-up

1. When the patient books, tap Mark booked and enter the appointment date.
2. After the visit, tap Attended and choose the outcome (for example glasses prescribed, or a medical visit outcome).
3. If they did not go, tap Did not attend. Close ends it for another reason; Reopen brings it back.
4. Send reminder now texts the patient straight away. Every attempt is logged on the follow-up.

The call list shows overdue patients whose reminders have not been delivered. Phone these patients yourself.

Automatic reminders go out once a day at 08:00 UTC, only to patients who ticked reminders consent and gave a mobile number.

Messages carry no clinical detail beyond the next step. They are sent through DoktorConnect Core, so they start reaching phones once the Africa's Talking (Nigeria) and Twilio (US) keys are added there; until then each attempt is logged as not sent and the patient appears on the call list.

Patients at home

A patient screened at a clinic can keep checking their eyes at home, and those home screens join the same record, so the clinic sees one continuous history.

Getting started at home

1. The clinic gives the patient their 6-character patient code, on a printed slip or read from the screen.
2. At home, the patient opens myocivo.com and taps I have a patient code.
3. They sign in with their email and open the link OCIVO sends, in the same browser.
4. They enter the code. Their clinic screens now appear in My results.

From then on, each home screen runs the same steps as at the clinic, with the checks the clinic has chosen, and is marked Home on the record.

My results lists every screen with its result. When there are at least two screens 90 days or more apart, it shows the trend. A change of 0.15 logMAR or more (about one and a half lines) is flagged. My results also has the patient's DoktorConnect box and Share my latest result.

When a home screen needs action, it appears in the red Home alerts box on the clinic's Clinic tab. Staff open it, contact the patient, and tap Mark reviewed. Home screens are not counted in the staff consistency table.

Helping someone to act. After a result that needs follow-up, OCIVO can offer a short Ready Mindset profile. It finds what is most likely to stop the person from going (cost, fear, time and others), and the AI writes a plan and a first step around it.

Household testing

One account can screen the whole family, the same way Otivo does. Each family member gets their own record at the account holder's clinic, so their results, follow-ups and reminders stay separate.

Adding a family member

1. Sign in at home and link your own record with your clinic code first.
2. On the Who are you testing? screen, or in My results, tap Add a family member.
3. Enter a first name or a label such as Mum, how they are related (child, parent, partner, brother or sister, grandparent, other) and their year of birth. The clinic sees this label too.
4. Tap Add to my family. OCIVO shows their own patient code.

Testing them

• Tap Test them now on this phone, or choose them later under Who are you testing?.
• A banner reads Testing Tomi (child) throughout their screen, and their age is filled in from the year of birth.
• Children aged 3–11 get the children's pathway automatically. Sit with a young child; a second adult taps the answers for ages 3 and 4.
• After every home screen, Test your family too lists everyone else in the family.

Inviting an adult to test on their own phone

For adults and children aged 12 and over, the added screen offers an invite: Copy, Share…, WhatsApp, Send text or Send email. The invite link (myocivo.com/?invite=XXXXXX) carries only their code, never results. When they open it, OCIVO goes straight to sign-in with the code filled in, and their own account links to the same record.

Anyone with a code can see that person's results, so send an invite only to the person it is for.

Eye specialist inbox and reference exams

The Eye specialist tab lists every referral from the clinic, so the specialist can record what they found. Those findings also feed the validation study.

Specialist mode (top right) adds a box during a screen for the acuity measured on a standard chart, in 6/12, 20/40 or logMAR. OCIVO compares it with its own estimate.

For each referral in the inbox

1. Read the summary: result, acuity each eye, pinhole, extra checks and the reason for referral.
2. Record outcome: what was found and done.
3. Add reference exam (for the study): examiner, exam date, visual acuity each eye, whether it is presenting or best-corrected, whether the person needs eye care, and the main finding (normal, refractive error, cataract, diabetic retinopathy, glaucoma, macular degeneration, amblyopia, strabismus, other).
4. Create patient link, if the patient needs their result.

To add a reference exam for a screen that was not referred (the study needs passes too), open the patient from the Clinic tab. The reference exam form is under their latest screen.

Good practice for the study: do the reference exam without looking at the OCIVO result first, and within a short, fixed number of days of the screen. The research console records the gap.

Export pairs downloads OCIVO-against-chart pairs for quick checks. The research console holds the full analysis.

Clinic tab for staff and clinic admins

The Clinic tab is the clinic's workspace. Every screen saved here is signed with the staff member who ran it, and saved results cannot be changed.

Joining a clinic

1. Sign in with your email in the Clinic tab and enter your name as it should appear on reports.
2. Enter the clinic's join code (ask your clinic admin).
3. You see Waiting for approval. You have no access to any patient until an admin approves you.
4. Once approved, sign in again and the clinic opens.

A new clinic can also be set up from this screen, or by a platform admin in the admin console. Either way, the person who sets it up becomes its first admin.

What staff see

Clinic admins also see

The camera bench study takes about 15 minutes per phone. First calibrate at 40 cm. Then follow the 18 steps (6 distances, each with no cover, right eye covered and left eye covered). The results table shows the distance error and how often a covered eye was spotted. Save it to the clinic record, or download it as CSV. Camera checks stay advice-only until these results are good enough.

Admin console (/admin)

The admin console at myocivo.com/admin/ is where clinics are onboarded and staffed. Platform admins see counts only, never patients. Clinic admins see only their own clinics. Sign in with the same email as the app.

The clinic directory shows, for each clinic: status, active staff, pending staff requests, patients, screens (all time and last 30 days), open and overdue follow-ups, and the last screen date.

Adding a clinic (platform admins)

1. Ask the clinic's lead to sign in once at myocivo.com, so their account exists.
2. Open Add a clinic: clinic name, country, the lead's email and their name on reports.
3. Add clinic. The lead becomes the clinic's admin, and the join code is shown. You do not become a member, so you still cannot see its patients.
4. The clinic admin then adds their own staff, or shares the join code and approves the requests.

Managing a clinic (tap Manage)

• Waiting for approval: approve as staff, approve as admin, or decline.
• Staff: add by email (they must have signed in once), change role, remove access or restore it. Removal is immediate. The console refuses to remove the last admin.
• Switch off / Switch on (platform admins): a switched-off clinic keeps its records but accepts no new staff.

Research access (platform admins): enter a researcher's email and choose all clinics or one clinic. Remove access with one click.

Importing patients from a spreadsheet (clinic admins)

1. Download template, or save your spreadsheet from Excel as CSV with these columns:

2. Choose the file. OCIVO shows how many rows it read and how many have consent.
3. Import. Rows without consent, or with a missing or invalid year of birth, are skipped and listed.
4. Print code slips: one slip per patient, with only the file number, the code and how to use it at home. No results appear on a slip.
5. Download codes (clinic file) if you need the list. It identifies patients, so keep it with clinic records.

The first platform admin is added once, directly in Supabase. After that, everything is done in the console.

Research console (/research)

The research console at myocivo.com/research/ holds the validation study. It shows only screens where the patient ticked the research box, and only in de-identified form.

What a researcher sees: participant pseudonyms (P-XXXXXX), staff pseudonyms (S-XXXX), the site name, age bands, year and month of the screen, and days since the participant's first screen. Also every measurement and the reference exam. Never: names, patient codes, file numbers, phone numbers or years of birth.

Getting access: a platform admin grants it in the admin console, for all clinics or one. Sign in with that email. Use the Site menu to look at one clinic at a time.

The concept note's targets for agreement are a mean difference within ±0.10 logMAR and limits within ±0.20 logMAR. Inconclusive screens are left out of the accuracy tables and counted separately. Two eyes from one person are not independent, so report per-person results alongside.

Before enrolling study patients: confirm ethics approval at each site, and make sure the research consent wording is approved. Agree who does the reference exams and within how many days.

DoktorConnect connection

OCIVO is one of 14 engines on DoktorConnect Core. Linking a patient to their DoktorConnect ID (DC-ID) connects their vision record to the rest of their DoktorConnect care. Otivo, the hearing engine, links the same way.

Linking a patient. The DoktorConnect box is in the patient's history (Clinic tab) and in the patient's own My results.

• Create a new DoktorConnect ID: one tap. An ID like DC-XXXX-XXXX appears and is saved to the record.
• Already have one? Type the ID and tap Link. Core texts a code to the phone on that DoktorConnect account; enter it to confirm.

What linking does

Messaging status (24 September 2026): email is on. Text messages start once the Africa's Talking (Nigeria) and Twilio (US) keys are added to Core. Numbers can be typed in any format, including 0803…, and still reach the right network.

Privacy and safety rules

OCIVO is built so that each person sees only what their role needs. The rules below are enforced by the database, not left to good behaviour.

Safety first

• Any safety-check yes, and a white glow in a child's pupil, means same-day care. Do not finish the screen first.
• OCIVO screens; it does not diagnose. A pass does not mean the eyes are healthy, and every report says so.
• If a patient reports a sudden change in vision, flashes with new floaters, or a curtain or shadow at any time, send them for care that day.

Privacy

Before screening children at a school: collect written consent from a parent for each child, and agree in writing who keeps the forms and for how long.

Troubleshooting and quick reference

Most problems come from sign-in links, an unapproved account, or a missing setting on the server. The table below covers the common ones.

Check the system is up: open myocivo.com/.netlify/functions/health. It shows the build (currently ocivo 2026-09-24h), and every key should read true.

Quick reference

All clinical thresholds in this guide are provisional until the consultant ophthalmologists sign them off.

OCIVO is a screening tool, not an eye examination. If anyone notices a sudden change in vision, a curtain or shadow, flashes with new floaters, or a painful red eye, they should get eye care today.