How-to

Assign the caregiver, clock in and out on My shift, then an administrator approves so payroll and billing stay honest.

1. Office staff add the client, authorization, and assigned caregiver. Put the visit on Schedule when you know the day, or the caregiver can start a same-day visit from My shift.
2. The caregiver opens My shift, finds the client, and taps Start visit. GPS is stored at clock-in.
3. At the end of the shift they add a visit note if needed, then tap End visit. Hours and units lock from the clock times. A note is not required.
4. An administrator opens Today's work, checks arrival and the visit note, then approves. If the note is blank, the home pin is not saved, clock-in has no GPS, clock-in was off site, the visit would be $0, or authorization is over, the app asks them to confirm first. Caregivers cannot approve their own visits. Approval creates payroll and billing lines.
5. Remaining authorization units this week come from those completed visits. On Payroll and Billing, Mark paid and Mark submitted only change a status. They do not send money or a claim.

Home, Care, How it works, About, questions, and Contact are the public site. Families use anscare.care. Aides use caregiver.anscare.care. Office staff use office.anscare.care or Staff sign-in. anscare.vercel.app is a backup copy of the same site.

1. Open Home first. Care, How it works, About, questions, and Contact are the family site. Staff is a small link, then Office login or Caregiver login. Clients do not get a password.
2. The old Wix site had Welcome, Bringing care to you, Home health experts, and Who we are. This site covers those ideas in original words, plus real phone and addresses. It does not copy Wix text, the leftover ??? block, or the Wix Facebook link.
3. The family website is https://www.anscare.care. Aides sign in at https://caregiver.anscare.care. Office staff sign in at https://office.anscare.care or Staff sign-in on the family site. Clients still do not get a password.
4. Do not wait on anscareservicesllcohio.com if the old developer still owns it. Recover it later if Charles wants that name. anscare.vercel.app remains a backup address.
5. The live database is the same Supabase project the office already uses. A new domain does not create a new database. After a big update, run any new STEP1 files in Supabase → SQL Editor if a screen says a table is missing.

A prompt opens after you sign in and walks leftover work one step at a time. Close it whenever you want. Open it again from the bar.

1. After you sign in, Today's check opens as a prompt. Read the current leftover, tap I'll do this, or tap Close. Closing does not finish the work.
2. Office: if a visit is 10 minutes past start and not clocked in, the prompt says who to call and shows Call when a phone is on file. Do not invent a number.
3. Office: if someone is still clocked in 10 minutes past the scheduled end, that is a leftover to call. You can also End visit on Today's work. Same-day visits with no end time stay off that leftover.
4. Office: Today's check also lists authorizations that already expired or end within 30 days. Blank and TBD dates stay on Missing fields.
5. Office: approve finished visits on Today's work, notice who is clocked in, follow not-started visits, fill home pins and caregiver emails on Missing fields, and send new staff to Staff exams.
6. Caregiver: if you are New staff, pass Staff exams first. Then open My shift at the house, Start visit, and End visit when you leave. Active workers are not blocked by exams. If you are still clocked in, End visit first — Start visit will not open a second visit.
7. On the last prompt, tap I looked if you have reviewed today's work. That check-in stays on this device for today only. It does not invent rates or change a visit.
8. Someone on a visit is informational. It is not a leftover task unless they are still clocked in past the scheduled end, or they clock out and the visit is waiting for the office.
9. Point at a button or tab. A short note floats under it so you do not have to remember what it does.

If a visit is still in progress 10 minutes after the scheduled end (Columbus), Today's check asks the office to call. Office can End visit on Today's work. Caregivers see End visit now on My shift.

1. Office: a red leftover means they started the visit and did not clock out by the scheduled end plus 10 minutes.
2. Tap Call if a number is saved. On Today's work, the row shows Still clocked in and End visit.
3. Prefer they End visit on My shift at the house. If they forgot, office can Clock out now (hours run until this moment; office GPS is often Off site) or Clock out at scheduled end (hours lock to the time already on the schedule; clock-out GPS is not taken at the house). Do not invent a different time.
4. Same-day visits with no scheduled end are not nagged. Do not invent an end time. Clock out now is the only office option then.
5. The visit log also shows Missing Clock Out or Past scheduled end until they clock out.
6. Start visit will not open a second visit. End the open one first. Hours would overlap if two visits ran at once.

Point at a button, tab, or field. A short note floats under it and tells you what it does, so you do not have to remember.

1. Move the mouse onto a tab, button, or box. Wait a moment. The note appears under that thing.
2. Nav tabs say what the page is for. Start visit, Approve, and Sign out say the next right step.
3. Today's check leftovers also have a hover note with the same detail as the expanded list.
4. On a phone, hover is not available. Tap the little ? next to a heading, or open How-to.

The app only accepts users that already exist in Supabase Authentication.

1. Caregivers open caregiver.anscare.care or Caregiver sign-in. Do not use Office login or an administrator email. Clients do not have a login.
2. Use the same email and password stored in Supabase: Authentication → Users.
3. If this person has never been added there, an administrator adds them (Email log, or Add user in Supabase), then try again. Caregivers should not create an office account.
4. After the Auth user exists, an administrator opens Settings → People. Office logins run the office. Caregiver logins use My shift and must be linked to a roster row. Changing a role asks you to confirm.
5. Caregiver passwords: the office sets a new one on Email log and tells them. Office administrator passwords: reset in Supabase Authentication. This app does not email a new password.

Caregivers ask the office. The office sets a new password on Email log and tells them. The app does not email a new password.

1. Caregiver: do not use Office login. Call or text the office. They set a new password and tell you. Then sign in on Caregiver sign-in or caregiver.anscare.care.
2. Office: open Email log. Under Set a new caregiver password, pick the person, type a temporary password of 8 or more characters, and tap Set new password.
3. Give them that password in person or by a separate message. It is not stored on Email log and is not emailed by this app.
4. Office administrator passwords are not reset here. Open supabase.com → Authentication → Users and reset that login there.
5. If they still cannot sign in, confirm the email on Email log, and make sure they are using Caregiver sign-in, not Office login.

Caregivers use Caregiver sign-in only. Do not use the administrator login.

1. Open Caregiver sign-in, or go to caregiver.anscare.care.
2. Use the email and password the office created for you.
3. Do not use Office login, Create an office account, or the office administrator email.
4. If it still fails, ask the office. They create caregiver logins on Email log. You cannot make an office login for yourself.

Supabase can block sign-in until the Auth user is confirmed.

1. In supabase.com open the project → Authentication → Users, then click the user’s email (not a three-dot menu).
2. On that user page click Confirm user. If you do not see it, open SQL Editor and run: update auth.users set email_confirmed_at = now() where email = 'their@email.com' and email_confirmed_at is null;
3. For the next login, use Add user → Create new user and leave Auto Confirm User checked. You can also turn off Confirm email under Authentication → Sign In / Providers → Email.
4. Sign in again at the Office or Caregiver door (http://localhost:3000/login or your https address).

The browser could not talk to this app or to the Supabase project.

1. Open the app in Chrome or Edge at http://localhost:3000. In-app previews and some embedded browsers block login.
2. On supabase.com, open this project. If it is paused, click Restore and wait until it is active.
3. Confirm .env.local has NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY for that same project, then restart npm run dev.
4. If the project URL looks right but login still fails, check that the device has internet and is not blocking supabase.com.

The session cookie expired, or “Keep me signed in” was turned off.

1. On the sign-in screen, leave “Keep me signed in” checked unless this is a shared computer.
2. If you unchecked it, the session ends when the browser is idle. Sign in again.
3. Use http://localhost:3000 or https. Mixed or blocked cookies can drop the session.
4. Sign out, sign back in once, then stay on the same browser profile. Do not switch users in the same window without signing out.

Caregiver logins only see their assigned clients, schedule, and My shift. That is expected.

1. Payroll, Billing, Reports, Caregivers, and Settings are Office pages.
2. A caregiver uses Caregiver sign-in, then clocks in and out on My shift. They cannot approve their own visits.
3. An administrator opens Settings → People. Office sees the office tools. Caregiver sees My shift only. Changing a role asks you to confirm first. Do not change your own login to Caregiver.
4. A Caregiver login must be linked to a roster row. Create that login on Email log when you can. Settings → People is for status and repair. Until they are linked, My shift cannot tell which clients belong to them.
5. After a role change, they must sign out and sign in again so the saved profile on this device updates.

Scheduled visits appear for today. Assigned clients also appear under same-day visit if they are not already on the schedule.

1. Open Schedule and confirm there is a visit for this caregiver, this client, and today's date, or use My shift → same-day visit if the caregiver is already assigned.
2. The visit status must not be cancelled. Office staff cancel a visit on Schedule if it is not happening. Delete only if nobody has clocked in.
3. Caregivers only see their own assignments. If the wrong caregiver is on the visit, an admin should fix it on Schedule.
4. Then open My shift and use Start visit. Allow Location when the browser asks.
5. If Start visit is blocked, the person is still New staff. They must pass Staff exams first, or an administrator marks them a worker.
6. If they are already clocked in, End visit first. The app will not start a second visit on top of an open one.

The app has three built-in tests. New aides cannot clock in until they pass, unless the office marks them a worker.

1. Office: add the person on Caregiver Roster as New staff (not Active).
2. Create their Caregiver login in Email log and give them the password.
3. They sign in at caregiver.anscare.care (or Caregiver login) and open Staff exams.
4. They pass all three: How a visit works, GPS and the home, and Being a worker. Pass is 5 of 6 on each.
5. When the last exam passes they become a worker and can Start visit on My shift. The office can also tap Make worker to skip. That asks you to confirm, especially if exams are not finished. Use it only when you trust the hire.
6. Send back to exams puts them on New staff again. Clock-in stays off until they pass, or you make them a worker. That also asks you to confirm.

Clock-in GPS is saved either way, but arrival cannot be confirmed until the client's home is pinned.

1. The billing worksheet did not include street addresses. Someone in the office must set each home.
2. Open Clients, open the client, and use the home location form. Paste the address and look it up, or drop a pin / use “I'm at this house.” On Missing fields, Save pins from addresses looks up streets already on file. It does not invent an address.
3. Save. EVV then compares clock-in GPS to that pin. A street lookup on Today's work is not a saved pin.
4. On site is about 800 feet or closer. Nearby is within half a mile. Off site is farther than that.
5. Approve stops you if the pin is not saved, clock-in has no GPS, or clock-in was off site. Confirm they were at the house, or cancel.

This is the agency arrival check from clock-in GPS versus the client home pin. It is not a Sandata or Ohio aggregator send.

1. Start visit and End visit open a map. Allow Location so your pin appears next to the client home, then clock in or out from that screen.
2. On site: within about 0.15 miles (about 800 feet) of the pin.
3. Nearby: within 0.5 miles.
4. Off site: farther than half a mile. The visit can still be completed. The office must confirm Off site clock-in, a missing home pin, or missing GPS before Approve, same as a $0 visit.
5. Allow Location, and use a phone or laptop with GPS. A desktop in the office will often show Off site if you clock in from there.

Location only works on a secure origin, and the site must be allowed in browser settings.

1. Open the app at http://localhost:3000 or an https address. GPS is blocked on plain http to another computer's IP.
2. When the browser asks for Location, choose Allow. If you clicked Block, open the padlock or site settings and set Location to Allow, then reload.
3. Try Start visit again from the caregiver's phone at the house when possible.

Lists are saved on this device. The first open still talks to the database; the next opens should be immediate.

1. Sign out and sign in once after a big update so this browser stores your profile. Then click around again.
2. The first visit to Clients, EVV, Payroll, and the other lists still loads from the database and saves a copy here.
3. After that, the page should show the saved copy right away, with “Updating from the database…” only if it is refreshing.
4. Hover a sidebar item to warm that page. Restart npm run dev if a developer just changed the app config.
5. Client and caregiver profile pages (the ones with an id in the URL) still load live from the database.

You can read the last saved lists. Starting a visit, adding a client, or approving still needs a connection.

1. If the connection drops, keep using Dashboard, Clients, Schedule, EVV lists, Payroll, Billing, and Reports. You will see the last saved copy.
2. Clock-in, clock-out, new clients, schedule edits, and approvals need the internet. Try again when the status says Up to date or when the connection returns.
3. Signing out clears the saved copy on this device so the next person does not see your lists.