Skip to main content

⚡️ Action Checker (Pro Feature)

This guide explains how HOA administrators use Action Checker to run a daily community checklist: overdue violations, seasonal patrol items, active ACC construction, and one-off manual tasks

Overview

Action Checker is a daily operations tool for board admins who need a single place to see “what needs attention today.” It is primarily setup for use in a drive-through situation but could be used in general as well. It automatically pulls items from elsewhere in Vlge (violations, ACC projects) and lets you configure recurring seasonal checks (e.g., landscaping in spring, holiday lights in December). You can also add one-time manual tasks for a specific date.

What Action Checker is for

  • Morning or weekly community patrol planning

  • Tracking overdue violation cure dates that need follow-up

  • Remembering seasonal inspection tasks on a calendar schedule

  • Monitoring active ACC/DRB construction during drive-throughs

  • Leaving an audit trail of what was checked, skipped, or noted

What Action Checker is not

  • It is not where you create violations or ACC requests - those live in their own modules. Action Checker surfaces them for follow-up.

  • It is not a full GPS drive-through patrol app on its own. The web checklist is the primary experience today. Inspection History (a separate admin tool) covers recorded drive-through sessions when that feature is enabled (beta as of July 2026).


Prerequisites & Access

Vlge Pro plan required

Action Checker is a Vlge Pro feature. Organizations without Pro will see an access message when opening the tool.

Required permission

Users need the Manage Action Checker capability

Role / setup

Typical access

Organization admin with full admin panel access

Yes

Staff user with Manage Action Checker assigned in Roles & Permissions

Yes

Board member without admin capabilities

No

Resident

No

To grant access to a non-admin staff member:

  1. Go to General Settings → Roles and Permissions

  2. Edit or create a role

  3. Enable Manage Action Checker

  4. Assign that role to the user in the active organization

Organization context

Action Checker always scopes to your currently selected organization. If you manage multiple communities, switch orgs before opening the tool.


Getting to Action Checker

  1. Sign in as a user with Action Checker access

  2. Open Admin → Admin Tools

  3. Click Action Checker (clipboard/checklist icon)

From the Action Checker header you can also reach:

Link

Purpose

Configure Rules

Set up seasonal (and stored) action rules

Add Manual Action

Create a one-time task

Mobile note: Configure Rules and Export PDF are hidden on small screens. You can still open rules directly in the web tool.


The Daily Checklist Screen

When you open Action Checker, you land on a date-scoped checklist with collapsible sections.

Date navigation

At the top of the page:

Control

What it does

◀ / ▶

Move to previous or next calendar day

Today

Jump back to the current date

Date picker

Jump to any specific date

Refresh (↻)

Reload the list from the server

The date label shows Today, Tomorrow, or a formatted date (e.g., “Fri, Jul 3”).

Summary counters

Below the date controls:

  • Total — all items on the list for that date

  • Done — items marked completed

  • Left — items still pending (not completed)

These update as you work through the list.

Collapsible sections

Each category is a section you can expand or collapse. Sections show a “X pending” badge when incomplete items remain.

Default expanded sections: Overdue Violations, Seasonal Checks, Manual Actions.


Action Categories (What Appears on the List)

1. Overdue Violations (automatic)

Source: Violations module
When they appear: Any unresolved violation whose cure-by date is on or before the date you are viewing.

Each item shows:

  • Violation type and board status (e.g., “Overgrown Grass - Open”)

  • Property address (with map pin)

  • Description (if recorded on the violation)

  • “Xd overdue” badge when past cure date

  • View Details link → opens the violation record

Priority logic (internal): More days past cure = higher urgency. Items overdue 14+ days are treated as highest priority.

Important: You do not configure these via Action Rules — they are always included automatically when cure dates pass.


2. Seasonal Checks (configured rules)

Source: Action Rules you create with type Seasonal
When they appear: On any date that falls within the rule’s start/end range (stored as month/day, e.g., March 1 – November 1, every year).

Each item shows:

  • Rule name as the title

  • Action description from the rule template

Example seasonal rules:

Rule name

Date range

Action description

Spring landscaping

03/01 – 06/30

Check for overgrown grass and weeds at curb

Pool season prep

04/15 – 05/15

Verify pool gates and signage

Holiday decorations

11/15 – 01/05

Check for prohibited lighting and displays

Seasonal rules are the primary configurable rule type that currently generates checklist items.


3. Manual Actions (admin-created)

Source: Created via Add Manual Action
When they appear: On the specific action date you chose when creating the item.

Each item can include:

  • Title and optional description

  • A specific address, or a community-wide task (“Apply to all addresses”)

Manual items persist their own completion status on the underlying record.


4. Active ACC Projects (automatic)

Source: ACC / submissions module
When they appear: Non-draft submissions whose construction window overlaps the selected date (project started and not yet ended).

Each item shows:

  • Project name

  • Status and “Check construction progress” guidance

  • Property address

  • View Project link → opens the ACC submission


5. Pending Notices (future)

The UI includes a Pending Notices section, but no notice items are generated yet in the current implementation. Notice-type Action Rules can be saved in Configure Rules, but they do not yet feed the daily list. Use the Violations module directly for notice follow-up today.


Working Through Actions

Each pending action card offers three paths:

Quick complete

  • Click the empty circle on the left, or

  • Click the green Complete button

This marks the item completed with no note.

Complete with a note (and optional voice note)

  1. Click Add Note

  2. Type a text note (optional but recommended for follow-ups)

  3. Optionally record a voice note:

    • Tap the microphone button

    • Record up to 2 minutes

    • Play back to review; delete and re-record if needed

    • Browser must allow microphone access

  4. Click Complete with Note

Voice notes are uploaded and attached to the session record.

👉 Skip

Click Skip when the item does not apply today (e.g., violation already cured in the field, project not visible from the street, seasonal check deferred due to weather).

Skipped items remain on the list but appear dimmed with a skip icon. They count toward “left” until you complete them or leave them skipped.

View source records

  • Violation items → View Details

  • ACC items → View Project

Use these links when you need photos, history, or to update the underlying record.

What happens when you complete or skip

Behind the scenes, Vlge records your work in an Action Session for the organization:

  • First completion of the day creates a checklist session for today

  • Each completion/skip creates or updates a session item tied to that violation, project, seasonal rule, or manual action

  • Manual actions also update the manual action record directly (status, completed-by, timestamp, notes)

This gives you a durable record of who checked what and when.

Designed for today’s work

Action Checker is intended as a same-day operational tool. You can browse other dates to preview seasonal items or see what the list would have looked like, but completions are recorded against today’s session. For day-to-day use, open Action Checker with Today selected and work through that list.


Adding Manual Actions

Use manual actions for one-off tasks that are not covered by violations, ACC, or seasonal rules.

Steps

  1. From Action Checker, click Add Manual Action (bottom of page)
    Or go to /admin/action-checker/new

  2. Fill in the form:

Field

Required

Notes

Action Title

Yes

Short label shown on the checklist

Description

No

Extra instructions for the inspector

Action Date

Yes

The calendar day this item should appear

Address

Yes*

Search and select a property

* Or check Apply to all addresses for a community-wide task (e.g., “Check clubhouse HVAC filter”).

3. Click Create Action

You return to Action Checker; the item appears under Manual Actions on the chosen date.

Good uses for manual actions

  • Follow-up from a board meeting (“Re-check Lot 14 fence repair by Friday”)

  • One-time event prep (“Verify parking signs before annual meeting”)

  • Contractor coordination (“Confirm pool resurfacing complete at 123 Oak”)


Configuring Seasonal Rules

Open Configure Rules from the Action Checker header.

Rule list

Each rule card shows:

  • Rule type icon and name

  • Action description template

  • Seasonal date range (for seasonal rules)

  • Active toggle - disable without deleting

  • Edit and Delete

Creating a seasonal rule

  1. Click Add Rule

  2. Select rule type Seasonal

  3. Enter:

    • Rule Name - internal label (e.g., “Summer landscaping check”)

    • Action Description — what the inspector should do (shown on the checklist)

    • Start Date / End Datemm/dd format (e.g., 03/01 to 11/01); repeats every year

    • Priority - 1 = highest, 10 = lowest (default 5)

  4. Click Create Rule

The rule appears on every date within that annual window while active.

Other rule types in the UI

The rules editor also supports Violation, Notice, and ACC Project rule types. These can be saved for future use, but only Seasonal rules currently generate checklist items. Overdue violations and active ACC projects are already included automatically by the system.

Managing rules over time

Action

When to use it

Disable (toggle off)

Season ended; pause without losing configuration

Edit

Change dates, description, or priority

Delete

Rule is obsolete and should not return next season


Exporting a PDF Report

On desktop/tablet (wider screens), use Export PDF in the date summary bar.

The export includes:

  • Organization name/branding

  • Selected date

  • All sections and items with status (pending / completed / skipped)

  • Addresses and descriptions where available

  • Summary counts

The PDF downloads as action-checker-YYYY-MM-DD.pdf. If PDF generation is unavailable, the system may open an HTML preview in a new browser tab instead.

Tip: Export at the end of a patrol day for board packets or internal records.


Related Tool: Inspection History (Beta: July 2026)

Inspection History is a separate Admin Tools entry (/admin/action-checker/history) for drive-through patrol sessions with GPS route data, session duration, and detailed per-item reports.

Aspect

Daily Action Checker

Inspection History

Primary use

Web daily checklist

Recorded patrol sessions

Session type

checklist

drive_through

Feature flag

Vlge Pro

Requires inspectionHistory org feature

GPS route

No

Yes (when recorded)

New notices during patrol

No

Tracked in session stats

If Inspection History is enabled for your org, use it to review past patrols, export session PDFs, and see voice transcripts. The daily Action Checker checklist is still the starting point for planning what to look for.


Troubleshooting

“I don’t see Action Checker in Admin Tools”

  • Confirm the organization is on Vlge Pro

  • Confirm your role includes Manage Action Checker or full admin panel access

  • Confirm you are in the correct organization

“My seasonal rule isn’t showing up”

Check:

  1. Rule is active (toggle on)

  2. Rule type is Seasonal

  3. Today’s date falls within the start/end mm/dd range

  4. Click Refresh after creating or editing a rule

  5. You are viewing the correct date (use Today)

“A violation I expect isn’t on the list”

The violation must be:

  • Unresolved (no resolved date)

  • Past cure-by date on or before the date you are viewing

  • In the same organization

  • Not soft-deleted

If cure date is still in the future, it will not appear until that date.

“ACC project missing”

The submission must be:

  • Not a draft

  • Not soft-deleted

  • Started on or before the viewed date

  • Not ended before the viewed date

“I completed items but they show pending again”

  • Ensure you were working on Today’s date when completing

  • Click Refresh — local UI updates immediately, but cross-device status comes from the server

  • If viewing a past or future date, completions may not attach to that date’s session

“Voice note failed”

  • Allow microphone permission in the browser

  • Stay under the 2-minute limit

  • Ensure a stable network connection for upload

  • You can complete with a text note only if upload fails

“Export PDF button missing”

  • Export is hidden on narrow/mobile viewports — use a tablet, desktop, or widen the browser window

“Pending Notices section never has items”

Expected today — notice-driven checklist items are not yet implemented. Track notices through the Violations / notices workflow directly.

“What’s the difference between Skip and Complete?”

TERM

Complete

Skip

Meaning

Item was assessed

Item was not assessed today

Audit

Counts as done for the session

Explicitly deferred

Use when

Checked and OK, or checked and noted

Could not access, weather, time

Neither skip nor complete resolves a violation automatically — update the violation record separately.

Did this answer your question?