Documentation
PurrView User’s Manual
A practical guide to Frontier Felines PurrView—the progressive web app for colony registries, daily roll-call visits, Make-A-Do plans, team collaboration, and field-friendly offline work. New organizations get the full app.
Version context: multi-user PurrView (full function for new signups, organizations, colonies, team) · Last updated: November 9, 2026
1. Welcome
PurrView helps colony caretakers keep track of community cats without drowning in sticky notes or shared spreadsheets that go stale by Tuesday.
With PurrView you can:
- Maintain a living registry of cats in each colony (photos, TNR, health notes, body score)
- Run trap-night TNR Ops (trapped / secured / notes / photos) and share prep/trap CSVs with coordinators
- Plan multi-day treatments and field chores with Do (Make-A-Do)—checklists, due dates, and a calm “what’s due soon” badge
- Run a daily “who did I see?” roll call and save visit notes
- Plan who is feeding with Coverage on the Team tab—a soft plan for the next two weeks. The visit log is still the record
- Review colony visit days or one cat’s attendance and body-score trail in History
- Keep inactive cats out of the way without losing history
- Export cat lists and visit history as CSV for reports or backups
- Work with teammates under one organization—with clear owner vs member roles. Teammates see your username, not your email
- Keep going when signal is weak; sync when you reconnect
Open the app at /purrview/ (or install it as a progressive web app from your browser when that option is available).
2. System requirements
PurrView is a progressive web app (PWA)—it runs in your browser, not as a separate App Store / Play Store install. That keeps requirements simple: a capable browser, enough free storage, and a network when you need to sign in or sync.
Devices & hardware
- Phones and tablets are first-class. Field use is the design target. Older hardware is usually fine if the browser still runs well—we are not limited by minimum OS versions from an app-store binary.
- iPad or Android tablet (recommended when you can). A larger screen gives more room for cat lists, History, and export controls. Toolbars and forms that stack into tall columns on a small phone often sit side-by-side on a tablet, so you scroll less and see more of the colony at once. Handy at the kitchen table, in the truck, or when training a new teammate.
- Laptops and desktops work for office review, exports, and multi-device testing (same signed-in account).
- Phone screen: any modern phone is enough for day-to-day field use. You can zoom in the browser if text feels small outdoors.
Storage (the real limit)
Most “this phone is too old” problems in the field are really full storage, not weak CPUs. Leave room for:
- Cat photos and notes stored for offline use
- Visit history cached on the device
- Browser updates and phone OS updates when they become available
Practical rule of thumb: keep at least 3 GB free—not a nearly full device. If storage is always on the thin edge, free space or upgrade; photos, offline data, and OS updates will struggle long before PurrView’s code does.
Browsers (recommended)
Early development and field testing focused on Brave and Firefox. We recommend those for caretakers when possible.
| Browser | Notes |
|---|---|
| Brave (recommended) | Primary development browser; solid PWA behavior on phone and desktop. |
| Firefox (recommended) | Second primary browser for multi-user and cross-check testing. |
| Chrome / Edge / Safari | Generally work for modern Chromium and WebKit builds. If something looks off, try Brave or Firefox before assuming the account is broken. |
Keep the browser itself updated when you can. JavaScript and site data (for sign-in and the local offline cache) must be allowed for PurrView’s site.
Network
- Cellular is fine. You do not need Wi‑Fi for normal use. Solid LTE/5G is enough for Sync Now, live team updates, and exports.
- Offline work is intentional. Cat edits and today’s visit can save locally when signal drops, then catch up with Sync Now when you are connected again.
- First open of the app, sign-in, CSV export, invites, and adding/renaming colonies need a working connection.
Optional: install to home screen
Where the browser offers Add to Home Screen / Install, you can open PurrView more like a standalone app. That is optional—the same /purrview/ URL in the browser is fully supported.
3. Core ideas
A few words used throughout the app:
| Term | Meaning |
|---|---|
| Organization | Your program or group account (for example a rescue or caretaker network). One person is the owner. Others can join as members. |
| Subscription | New organizations get the full app. The first two months are included. After that, $8 per month. See Subscription. |
| Colony | A named group of cats you manage under that organization (for example “8 Mile” or “Barn West”). Each organization includes 5 active colonies. Frontier Felines can raise that number for one organization. |
| Active context | The organization + colony you are working in right now. Cat lists, visits, and saves always apply to the active colony. |
| Active / inactive cat | Active cats appear in the main list and in today’s roll call. Inactive cats are archived but can be reactivated. |
| Seat | A slot for a person on the team. Active members and open invites both count toward the seat limit (default 3 unless Frontier Felines raises it). |
| Sync | Sending local changes to the cloud and pulling the latest team data so everyone’s view stays aligned. |
| Do | Committed work the team decides to finish—treatments, supply runs, landlord follow-ups—with a due date and optional checklist. Created with Make-A-Do. Not a visit, not Needs Pull, not a Team broadcast. |
4. Subscription
As of the November 1, 2026 launch, a new organization gets the full app. The limited Free tier is not offered. Cats, colonies, team invites, broadcasts, Do, TNR Ops, Coverage, photos, export, and offline work are included. There is no cat cap and no one-colony cap.
- The first two months after the organization is created are included.
- Starting at the two-month mark, the subscription is $8 per month.
- The organization owner, or a purchaser they name, is responsible for the fee.
- Email [email protected] to arrange payment, or to cancel before the two months end. Canceling ends further use of that organization. Missed payment after billing starts can suspend access. Details are in the Terms.
- The team starts with 3 seats. Active members and pending invites both count. Email us if you need more seats.
- Creating an organization still needs a registration code from Frontier Felines. A second organization for the same owner is not automatic—email us if you need one.
5. Getting access
There are two common ways in:
A. Create an organization (owner)
- Request a registration code Email [email protected]. Owner registration always needs a code from Frontier Felines—there is no public open signup. See Subscription and the Terms.
- Receive an access code or registration link Links may look like /purrview/?code=….
- Register Email, password (at least 8 characters), a username (3–20 letters, numbers, or underscores), organization name, and optional first colony name. Tap Register to create the account. By continuing you agree to the Terms and Privacy Policy. See Usernames.
- You become the owner PurrView creates your organization and a default colony with the full app: cats, colonies, team invites, broadcasts, Do, and TNR Ops. The first two months are included. At the two-month mark the subscription is $8 per month.
B. Join a team (member)
This path is for people an organization owner invites. You do not need your own registration code.
- Get an invite link Only the organization owner can create invites. They copy a link and send it to you (text, email, etc.).
- Open the link It opens PurrView with the invite attached (for example ?invite=…).
- Sign in with the invited email The email must match the invite. Members do not need an owner registration code.
- Accept and work You join the shared organization and can care for cats and visits according to member permissions.
6. Sign in & sign out
- Tap Sign In in the top navigation (when you are signed out).
- Enter the email and password for your account. Day-to-day sign-in does not ask for a username again.
- Toggle Need an account? Register only when creating an organization with a registration code, or when a new teammate is creating an account from an invite (not for normal day-to-day login). The button on the form is Register (not “Sign up”), so it’s easier to tell from Sign In. Registration asks for a username.
- Sign out from the footer with Sign Out when you are done—especially on shared devices.
Usernames
Teammates see your username on the Team roster, on Coverage, and as the sender of team broadcasts. Your email stays off those screens. Pending invites still show the email the owner typed, because that person has not joined yet.
- Choose one when you register. Use 3–20 characters: letters, numbers, and underscores. The app stores it in lowercase (CatLady and catlady are the same name).
- The name must be unique. A few words are reserved (admin, support, purrview, and similar). The form tells you if a name is taken or not allowed.
- If you already had an account before usernames, the next online sign-in opens Choose a username. Pick one and tap Save username before the rest of the app continues. This step needs a connection.
- You set the name once. To change it later, email [email protected].
- Until a name is saved, the roster shows Name not set. That label is not an email address.
After sign-in, PurrView restores your last organization and colony context when it can. If the colony name shows oddly or data looks empty, try Sync Now or a hard refresh (see Troubleshooting).
7. Screen layout
Top bar
- Title — Frontier Felines PurrView (shortens to “PurrView” on small screens)
- Sync Now — pushes pending changes and refreshes; may show a badge count when work is waiting
- Connection status — Online, Connecting…, or Offline
Main navigation
| Tab | What it’s for |
|---|---|
| Active Cats | Registry of cats currently in the colony; add and edit |
| Inactive Cats | Archived cats; reactivate when needed |
| Today’s Visit | Daily roll call, visit time, general notes |
| History | Colony visit days or per-cat attendance / body score trail |
| Do | Make-A-Do plans, checklists, archive; badge/glow when work is overdue or due soon |
| Team | Coverage (who is feeding, next 14 days), members shown by username, invites (owners), and team broadcasts |
| Sign In | Shown when you are not authenticated |
Footer — Organization & Colony
- Shows the active organization and colony context
- My Organization switcher — if you belong to more than one organization
- Role badge (owner / member)
- Rename organization, add organization, or leave an organization (with safeguards). A second organization you own needs a note to Frontier Felines—it is not created automatically
- Add New Colony (requires a connection; there is no colony count cap)
- Sign Out
8. Organizations & colonies
Switch organization
If you are a member of more than one organization, use the My Organization dropdown in the footer. Switching reloads the context for that program’s colonies and cats. Creating a second organization you own is not automatic. Email Frontier Felines if the same person needs another organization. Membership in someone else’s organization does not by itself create one you own.
Colonies
- Use the Colony dropdown on the Active Cats screen to switch colonies.
- Tap the pencil (✎) next to the colony name to rename the current colony (online).
- Tap Add New Colony in the footer to create another colony under the active organization (online). Each organization includes 5 active colonies. Email [email protected] if that organization needs more. A second organization you own has its own maximum of 5. Archiving a colony frees a slot.
Spots (where cats hang out)
A spot is a small landmark inside a colony—not a big “zone” of the property. Think “behind the broken wall,” “blue dumpster,” or “porch feeder,” not “north half of the lot.”
- On Active Cats, the Spot dropdown sits beside Colony. Choose + Spot to add one; pick a spot then ✎ to rename or archive (requires connection).
- On a cat’s edit form, set an optional Usual spot so the team knows where that cat usually hangs out.
- Usual spot shows on the cat card as Spot. Moving a cat to another colony clears usual spot (spots belong to one colony).
Cats, visits, and roll call always belong to the colony you have selected. Team membership is at the organization level—invited members share the whole account’s colonies they can access through normal use of the app.
Leave an organization
Use Leave in the footer when you should no longer participate in that program. You may be prevented from leaving if it would leave the organization without a workable owner situation—ask the owner or Frontier Felines if you are stuck.
Legacy data (older single-colony installs)
If you see a banner about previous colony data ready to claim, tap Claim Colony Data while signed in so older records attach to your organization. Most new beta users will never see this.
9. Active cats
This is your working roster for the selected colony. Under the colony switcher, one line counts active cats only: how many are active, how many are TNR’d, how many are not yet, and the percent TNR’d. Inactive cats are left out. The line uses cats already on this device, so it still shows when you are offline.
Add a cat
- Open Active Cats Confirm the correct colony is selected.
- Tap Add New Cat Fill in the form and save. There is no cap on how many cats an organization may keep, including TNR and inactive cats.
Cat fields
| Field | Notes |
|---|---|
| Name | Required. Use a name your team will recognize in the field. |
| TNR Done | Checkbox when trap-neuter-return is complete for that cat. |
| Sex | Male, Female, or Unknown. |
| Age | Kitten, Young Adult, Adult, Senior, or Unknown. |
| Body score | Optional 1–9 scale (1 emaciated through 9 extremely obese), for quick condition tracking. |
| Needs pull | Flag cats that need to be trapped/pulled for TNR, relocation, or medical reasons (injury, illness, vet care). Use notes to say why. |
| Notes | Free-text health, behavior, or identification notes. |
| Chip # | Optional microchip ID. Shown on the cat card under Notes. Digits, letters, spaces, and hyphens; max 32 characters. |
| Usual spot | Optional landmark in this colony (from the Spots list). Shown on the card as Spot. |
| Face photo | Optional primary ID photo (compressed on save). Shown first on the cat card. |
| Body / markings photo | Optional second photo for coat patterns. On the card, tap the image to switch Face ↔ Body when both exist. |
| Last visit | Shown when editing a cat that has visit history (read-only helper). |
Edit a cat
Open the cat from the list, change fields, and save. Teammates who are online may see updates in near real time after sync.
Move to another colony
If a cat relocates to a different colony under the same organization, use Move colony on the cat card (requires a connection). That keeps one record—photos, Chip #, notes—so you do not create a duplicate. Past visit days under the old colony stay in that colony’s History; the cat leaves the old active list and appears under the destination colony. Each move appends a short line to Notes (e.g. move to Paradise Point, then move back to 8 Mile → two lines of history).
Record an outcome
Record outcome is on every cat card, active or inactive. Choose Returned, Owned, Transferred, or Deceased, plus a date and an optional note.
- Returned marks the cat TNR’d and leaves them on the active list.
- Owned, Transferred, and Deceased clear TNR’d and move the cat to Inactive.
- The outcome screen does not change colonies. Use Move colony for that.
- A brand-new cat still waiting for its first sync cannot take an outcome until that sync finishes.
Remove from colony (deactivate)
Removing a cat from the colony archives them—they move to Inactive Cats and drop out of today’s roll call. History is not thrown away; you can reactivate later.
Export and import (CSV)
On Active Cats, tap Export to download a spreadsheet file (CSV) for the current colony. The dialog has two downloads:
- Cat list — active only, inactive only, or both (both is the default).
- Colony summary — one small file: colony name, today’s date, active count, TNR’d, not yet TNR’d, percent, Needs Pull count, and the last saved visit date. Inactive cats are not counted.
Cat-list columns include colony, name, active flag, TNR, sex, age, body score, needs pull, notes, Chip #, usual spot, and timestamps. Photos are not included. Export requires an internet connection. The file name looks like Organization_Colony_cats_YYYY-MM-DD.csv or Organization_Colony_colony_summary_YYYY-MM-DD.csv.
Import reads a CSV that uses those same column names. It is online only, and it adds cats to the current colony. A preview lists who will be added and who will be skipped: a blank name, or a name already in this colony (active or inactive, or repeated later in the file). A usual-spot name is kept only when that spot already exists here; an unknown spot is dropped and the cat is still added. Photos are not imported. Anyone who can add a cat can import.
10. Inactive cats
Use this list for cats that left, are missing long-term, transferred, or should not appear on daily visits—without deleting their story.
- Open Inactive Cats in the main navigation.
- Review archived cats for the active colony.
- Reactivate when a cat returns to regular care; they reappear on Active Cats and roll call.
- Owned, Transferred, and Deceased outcomes land here and show on the card with the date and note. Returned stays on Active Cats.
11. Today’s Visit
Today’s Visit is the daily roll call for the active colony—who you saw, when you visited, and what you want the team to know.
- Select the right colony Switch colonies on Active Cats first if needed. The heading should read Today’s Visit — {colony name} — {date}.
- Open Today’s Visit You will see active cats only (inactive cats are excluded).
- Set visit time Optional time field for when the visit happened.
- Check cats you observed Use the roll call list to mark who was present or accounted for.
- Add general notes Colony-level notes for the day (weather, food status, concerns, etc.).
- Save Today’s Visit If you are offline, the visit is stored locally and syncs when you reconnect (you may see a toast confirming offline save).
If this colony has a Coverage plan for today, a short cue appears above the roll call (“Coverage today: …”, “Uncovered”, or “no plan for today”). That cue is optional. Saving the visit is never blocked by it.
Visits keep a snapshot of cat details at save time so history stays meaningful even if a cat’s profile changes later.
12. Visit history
Open History to review past visits for the active colony—dates, who was marked present, and notes. Use it to answer “when did we last see Patches?” or to brief a teammate covering your route. The title shows Visit History — {colony name}.
Two modes
At the top of History, switch between:
- Colony — the classic list of visit days (general notes + cats present with snapshot fields).
- By cat — pick one cat and see that cat’s attendance trail (Present / Not seen), body score, and notes on the dates they were recorded.
Body score and cat notes on History rows are snapshots from when the visit was saved, not a separate medical chart. Editing a cat’s profile does not rewrite past History until the next visit where they are marked present.
On-screen History shows about the last 100 colony visits. Use export Range for a longer cloud trail. Offline, you may see pending local visits plus whatever was already loaded this session—not a full offline archive of every past day.
In By cat mode, leave Show days not seen checked to see attendance gaps; uncheck it to focus on days the cat was present.
Export history (CSV)
At the top of History, use the export controls. Exports need an internet connection and use cloud history (sync pending visits first if you just saved offline).
| Control | Options |
|---|---|
| Range | Last 30 days · Last 90 days (default) · All visits — applies to CSV exports, not the on-screen list |
| Format — Summary | Colony export only: one row per visit (colony, date, visit time, cat count, general notes). Label in the app is simply Summary. |
| Format — Detail | Colony export only: one row per cat per visit (snapshot fields + general notes). Label in the app is simply Detail. |
| Export CSV / Export colony CSV | Whole-colony download (label changes in By-cat mode). Not limited to the selected cat. |
| Export cat CSV | By-cat mode only, when a cat is selected. One row per visit day: attendance, body score, notes. |
File names look like Organization_Colony_visits_summary_YYYY-MM-DD.csv or …_visits_detail_…. Very large histories may be capped (thousands of visits) so the download stays practical.
13. TNR Ops (trap night)
TNR Ops is for the trap portion of trap–neuter–return: a focused roster of cats not yet marked TNR complete, field checkboxes for trapped / secured for transport, notes, optional trap photos, and exports for clinic handoff. It is not a vet chart or foster/adoption system.
Before you start
- Pick the colony where you are trapping On Active Cats, set the Colony dropdown. If you work 4–5 sites in one night, switch the colony before each site. Wrong colony = wrong cats and wrong exports for the coordinator at home.
- Confirm the name in the title Open TNR Ops. The heading and green banner show Working colony: …. If it is wrong, go back to Active Cats and switch.
- Optional: Plan tonight Expand the prep panel for ceiling, traps, cages, kit checklist, mission crew (people on the ground—not app Team seats), clinic drop-off, and safety notes. Use Export prep plan CSV to share with someone preparing clinic paperwork while the field team is still out.
During the trap night
- The list shows active cats that are not TNR complete for this colony only.
- For each cat: Trapped, Secured for transport, optional notes and camera (photo of cat in trap when there is time).
- Add New Cat for unexpected arrivals; they appear on the list immediately (TNR not complete by default).
- Tap Trapping Complete to save the night’s log (you can re-open and edit the same night).
- Export trap CSV for the Team / clinic handoff (English column headers).
Advice & warnings
- Multiple colonies: Always verify colony name before trapping or exporting. The footer alone is easy to miss in the dark—use the page title / TNR banner.
- Feeding visits stay separate: Today’s Visit (roll call) is not overwritten by TNR Ops. You can feed and trap on the same calendar day.
- Do not mark TNR complete just because a cat was trapped or secured. That stamp is for finished return.
- Shared live data: Teammates online can use exports and shared org data so a coordinator can prep clinic paperwork without waiting for midnight text dumps.
- Offline / sleep: Prefer Sync Now when signal returns; after device sleep the app should refresh lists when you return—if a list looks empty, Sync Now or reopen the screen.
- Photos optional: Never block the night waiting for perfect photos; add when safe.
14. Do (Make-A-Do)
Do is committed work—multi-day treatments, supply runs, landlord notes, transport plans—that is neither a feeding visit, a Needs Pull flag, nor a Team broadcast. You create a plan with a due date, optional cat and custom checklists, and notes. The create action is called Make-A-Do.
Open Do
- Tap Do on the main PurrView screen (near Team).
- When work is overdue or due within the next 8 local days, the Do control shows a count badge and the same orange glow style as Team.
- Completed Dos do not keep the badge lit.
Master list
- Filter: This colony · All · General (General = not tied to one colony).
- Default filter is All so organization-wide and General work stay visible.
- Rows sort by soonest due date first.
- Each row shows title, due date, and a light status cue when due soon or overdue.
- Make-A-Do creates a new plan. Archive browses finished work that has left the main list.
Make-A-Do
- Do name Short title for the plan (required).
- Colony The owner picks a colony or General (work that is not tied to one colony). An assistant picks a colony they can open. Only the owner can create a General Do.
- Due date Defaults to today on your device; change as needed.
- Cats (optional) When a real colony is selected, check the active cats to include. Labels are snapshotted at create time so the checklist still makes sense if a name changes later.
- Custom checklist (optional) Turn on Make this a checklist and put one item per line (up to 30). Leave the toggle off to use the multi-line field as plain notes only.
- Notes Always available. Use them for “who’s handling this,” clinic details, or field observations.
- Save This Do Returns you to the master list with the new row visible.
Working a Do
- Open a row to see title, colony or General, due date, checklist, and notes.
- Check items as you go (item checks can save immediately for field speed).
- Title, due date, notes, and add/remove items need an explicit Save.
- A Do finishes only when someone taps Mark Do done—checking every item never silently closes the plan. You can mark done with some items still open when the work is “good enough.”
- When the last open item is checked, PurrView may offer to mark the Do done.
- The owner or an assistant can reopen a completed Do if the work was closed early. Reopening an archived Do stays with the owner.
Done and archive
- Completed Dos stay on Do Home until the owner removes them. Nothing leaves the list on its own.
- The owner uses Remove from list on the detail screen. That moves the Do to Archive.
- Archive keeps a reviewable history. The owner can reopen from Archive. There is no hard-delete path.
Who can do what
- Owners create, edit, mark done, archive, and reopen Dos. Only an owner can create a General Do or remove a finished Do from Do Home.
- Assistants can Make-A-Do, mark a Do done, and reopen a completed Do in the colonies they can open. They cannot archive, and they cannot reopen an archived Do.
- Members can view Dos and check off items. They cannot create or close a plan.
- The owner chooses which colonies a member or assistant can open. Until that is limited, they can open every colony. General Dos stay visible to the team.
Offline
After you have loaded Dos while online, you can open the list and work from the device cache. Create and edit queue like other field work; use Sync Now when signal returns so teammates see the same plans.
15. Team & invites
Open the Team tab to see who is on the organization and, if you are the owner, to invite or remove people. The roster shows each person’s username and role (owner, assistant, or member), not their email. Coverage (who is feeding) lives here too.
Coverage (who’s on)
Coverage is a soft plan for the active colony: who is expected to feed, which days are open to anyone, and which days are uncovered. It does not create a visit, and it does not stop you from saving Today’s Visit. The visit log remains what actually happened.
- The list shows today and the next 13 days (14 days). The heading is Coverage · {colony name}. Switch colony on Active Cats before planning another site.
- Tap Plan on an empty day, or Edit on a day that already has a plan. Choose Assigned person (a teammate’s username, or Other and type a name for someone who is not on the app), Anyone / open, or Uncovered (gap). A note is optional (gate code, timing).
- Save plan stores that one day. Clear removes the plan after you confirm.
- Each day also shows whether a visit with cats or notes is saved: ✓ visit, no visit yet on today, or a quiet mark on days still ahead.
- Owners, assistants, and members can plan. A solo caretaker can still use Coverage as a two-week reminder.
- Planning and clearing need a connection. Offline, Team shows the last cached plan and the edit buttons stay disabled.
Seats
The team panel shows seats used versus the seat limit (for example 2 / 3). The default limit is 3. Active members and pending invites both count. If the limit is reached, invite creation is blocked until someone is removed, an invite is revoked, or Frontier Felines raises the limit. Email [email protected] if the team needs more than 3 seats.
Owner: invite a teammate
- Enter their email Must be the address they will use to sign in.
- Create Invite Link Copy the link and send it yourself. Email delivery from the app is planned later.
- Manage pending invites Copy again if needed, or Revoke if the link should no longer work.
Owner: remove a member
From the members list, remove people who should no longer have access (you cannot remove the owner role through ordinary member removal).
Members
Members see the roster but cannot create invites. They can still use cats, visits, and broadcasts according to normal app permissions.
16. Team broadcasts
On the Team screen, Team Broadcast is for short account-wide messages— “Feeding late tonight,” “Vet clinic Thursday,” “Watch for injured tortie near the dumpster.” Each message shows the sender’s username, not their email. If they have not chosen a name yet, the line says Name not set.
- Messages are limited to 500 characters.
- You can send up to 10 broadcasts per minute (rate limit to prevent spam).
- Online: messages deliver live to teammates.
- Offline: messages queue and send when you reconnect.
- The Team nav control may glow when you have unread broadcasts; opening Team marks them viewed.
17. Online, offline & Sync Now
PurrView is built for dirt roads and weak signal. Not every action needs a perfect connection— but colony management (add/rename colony) does require being online. Cellular data is fully supported—you do not need Wi‑Fi for Sync Now or day-to-day team use.
| Status | What it means |
|---|---|
| Online | Connected for live updates and normal sync (Wi‑Fi or cellular). |
| Connecting… | Network may be up while the live session is still establishing. |
| Offline · local data | No network, but this browser already has a prior successful sync for your org/colony. You can open Active Cats, edit cats, and save Today’s Visit from the device cache. A banner shows Working offline · last synced … |
| Sign-in needed to sync | Local colony data is still on this device, but you are signed out (or the session is gone). You can view local work; Sign In again to upload pending changes. |
| Offline | No network and no usable colony cache on this browser yet—connect and sign in once to download. |
What “offline-first” means here
- Per browser / device. Offline work uses data last synced on this phone or laptop, not a shared offline cloud.
- Before the field: Online, open the colonies you need, wait for cat lists (and photos if you care about them offline), then tap Sync Now.
- While offline: View and edit cached cats, save Today’s Visit, switch among colonies already cached on this device. Pending work shows a badge and uploads when you reconnect and Sync Now.
- Sign out clears sign-in tokens only—local colony cache stays for faster return (useful if you signed out by mistake). Use the browser’s Clear site data only on shared phones when you truly want a wipe.
Sync Now
- Available when you are signed in and the device reports online (Wi‑Fi or cellular).
- Offline: the control stays disabled; a toast explains you are working from this device until you reconnect.
- Refreshes your sign-in session when needed, flushes pending cats/visits/broadcasts, and pulls the latest server state—including today’s visit.
- A badge may show how many pending items need attention.
- After reconnecting, the app may wait briefly for a stable connection before auto-flushing.
- Success may say Everything is up to date or report how many items were sent. The Sync button remembers last synced time on this device.
Phone + laptop (or two browsers)
When both devices are online and signed into the same organization and colony, saving Today’s Visit on one device can update the other in near real time. If a second device opened Today with an empty roll call, it will not wipe a real visit that already has cats checked—attendance content wins over a blank placeholder.
If one device still looks empty after the other saved, confirm the same Organization & Colony, tap Sync Now on the device that has the correct visit, then Sync Now on the other. History can also confirm what the cloud has for that day.
Conflicts
If two people change the same record close together, PurrView uses a last-write-wins approach with conflict notices. You may see an amber toast and the server’s copy loaded—re-apply your change if it still matters.
What needs a connection
- Adding or renaming colonies
- Creating invites and most team administration
- Planning or clearing Coverage
- Choosing a username the first time
- CSV export of cats or visit history
- Reliable real-time updates from teammates
- Completing Sync Now
Visits and many field edits are designed to survive offline periods and catch up later. When in doubt, save your visit, restore connection, then tap Sync Now.
18. Roles & permissions
| Action | Owner | Assistant | Member |
|---|---|---|---|
| View & edit cats in colonies they can open | Yes | Yes | Yes |
| Today’s Visit & history | Yes | Yes | Yes |
| View Dos & check off items | Yes | Yes | Yes |
| Make-A-Do and mark done | Yes | Yes | No |
| Archive a Do / create a General Do | Yes | No | No |
| Choose which colonies someone can open | Yes | No | No |
| Send team broadcasts | Yes | Yes | Yes |
| Plan or clear Coverage | Yes | Yes | Yes |
| Invite / revoke / remove teammates | Yes | No | No |
| Manage membership & seats (with Frontier Felines for limits) | Yes | No | No |
| Organization-level owner controls | Yes | No | No |
Cats, visits, and Dos follow the colony list. A person who cannot open a colony does not see it in the switcher. General Dos stay visible to the team, and only the owner can create one.
19. Field tips
- Start with the colony switcher (Active Cats) before adding cats, saving a visit, or opening TNR Ops.
- Read the colony name in the page title on Visit, History, Inactive, and TNR Ops—not only the footer.
- Multi-site nights: switch colony when you change locations; export trap/prep CSV so a coordinator can prep clinic while you stay in the field.
- Use Do for multi-day plans—antibiotics, recheck visits, supply runs—not for “who did I feed today?” (that’s Today’s Visit).
- Set Coverage for the next two weeks so the next feeder is not guessing. Uncovered is an honest gap, not a scolding.
- Pick a username people will recognize in the field. The roster and broadcasts never show your email.
- Write who’s handling it in Do notes so the next caretaker does not have to guess.
- Check Organization & Colony in the footer so you are not writing into the wrong program.
- Name cats for recognition—markings, “ear tip + white blaze,” or stable nicknames beat vague labels.
- Use Needs Pull as a shared triage flag when a cat should be trapped or removed from the colony route—for TNR, relocation, or medical reasons (injury, illness, scheduled vet care). Put the reason in notes so the next person knows whether it’s a trap plan or a health pull. Pair Needs Pull with a Do when the work needs a date and checklist.
- Body score + notes give the next caretaker a head start without a phone call.
- Save the visit before you drive off; sync when signal returns (cellular is fine).
- Use History → By cat when you need one cat’s attendance or body-score trail instead of scanning every visit day.
- Two-browser practice is useful for training: the owner invites a second email and watches live visit updates.
- Keep seats tidy—revoke unused invites so they do not consume the default 3 seats.
- Leave at least 3 GB free on field devices so photos and OS updates still fit (see System requirements). A tablet helps when you want less stacking and more on screen.
20. Troubleshooting
| Symptom | What to try |
|---|---|
| No cats / wrong colony name | Confirm colony on Active Cats and in the page title (Visit / History / TNR). Footer org · colony should match. Sign out/in if needed. Tap Sync Now. Hard refresh (Ctrl+Shift+R or equivalent). |
| Trap data on the wrong site | TNR Ops always uses the active colony. Switch colony on Active Cats before trapping the next location. Check the TNR heading “Working colony: …”. |
| “No colonies loaded yet” | Sign in with the same account used on your other device, then Retry Setup or Sync Now. Data is not stuck on one laptop only—it lives with your cloud account once synced. |
| Could not load organization / Sync failed on cellular | Confirm you are Online (not Offline). Tap Sync Now again—cellular is supported. If it keeps failing, sign out and sign back in once to refresh the session, then Sync Now. Check free storage if the browser is unstable. |
| Today’s Visit empty on laptop but phone has cats | Same organization and colony on both. On the phone (correct data): Save Today’s Visit if needed, then Sync Now. On the laptop: Sync Now and reopen Today’s Visit. Check History → Colony for that day. |
| Invite form missing | Only the owner sees invite controls. Check the role badge in the footer. If the seat count is full (default 3), remove someone, revoke a pending invite, or email Frontier Felines to raise the limit. |
| Invite fails | Use the exact invited email; request a new link if expired or revoked; check the seat limit. |
| Cannot add a colony | Adding or renaming a colony needs a connection. Each organization includes 5 active colonies. If you are already at that number, email [email protected]. Archiving a colony frees a slot. |
| Cannot create / add organization | Owner registration needs a registration code from Frontier Felines. Members should use an invite link instead. A second organization you own is not automatic—email us if you need another. |
| Password rejected | Use at least 8 characters. |
| Stuck on “Choose a username” / name already taken | You are online and this account has no username yet. Use 3–20 letters, numbers, or underscores. If the name is taken or reserved, try another. This step needs a connection. To change a name after it is saved, email [email protected]. |
| Coverage Plan / Edit is disabled | Planning needs a connection. Offline, Team still shows the last cached plan. Restore network, confirm the colony, then Plan or Edit again. |
| Sync badge stuck | Go online (Wi‑Fi or cellular), tap Sync Now, hard refresh if needed. Conflict toasts may ask you to re-check a record. |
| Do list empty / cannot Make-A-Do | Confirm you are signed in and online once so Dos can download. Members can open and check items. Make-A-Do is for the owner and assistants, and only in colonies they can open. Try filter All if This colony looks empty. Sync Now after creating plans offline. |
| App looks old after an update | Hard refresh or clear site data so the service worker picks up new files. Confirm the footer build id changed. |
| Add / rename colony disabled | Those actions require a connection. Restore network and try again. |
| Export says it needs a connection / fails | Go online and try again. Confirm you are on the right colony. Very large history ranges may take a moment. Sync pending visits first if you just saved offline. |
| Phone full / photos fail / app flaky | Free at least 3 GB (photos, OS updates, browser). Upgrade if the device stays full. See System requirements. |
21. Legal & contact
- Terms of Service (includes software license)
- Privacy Policy
- PurrView product overview
- Questions, access codes, or the $8 monthly subscription: [email protected]
This manual describes product behavior for caretakers. It is not a legal document; Terms and Privacy control rights and obligations. Features evolve—if the app and this page disagree after an update, trust the live app and ask us to refresh the manual.
Ready for the field?
Open PurrView, pick your colony, and start with today’s cats. The manual will be here when you need a refresher.