Help centre

Guides for every part of Groundwork: setting up a workspace, sending reports from WhatsApp, tracking issues, and generating weekly progress reports.

Create a workspace and onboard your team

Groundwork works through WhatsApp: field staff send voice notes and photos, and the system sends back a formatted PDF. The office dashboard shows every report, tracks open issues, and builds the weekly progress report.

Groundwork in 90 secondsAll videos

Create a company workspace

  1. 1Go to groundwork-reports.vercel.app/signup.
  2. 2Enter your company name, your name, and a password. Groundwork creates the workspace immediately.
  3. 3On the workspace overview you will see the Create a project form. Add your first project: name, location, and optional client name.
  4. 4The project page shows a join code (six letters) and a WhatsApp link. Send that link to field staff so they can join from their phones.
Create a company workspaceAll videos

Open the demo workspace

  1. 1Go to /demo. Groundwork signs you into Najd Contracting, a pre-seeded demo company with three projects and two weeks of reports.
  2. 2Explore freely: nothing you do in the demo affects real data.

Sending reports from WhatsApp

Field staff interact entirely through WhatsApp. No app to install, no login. They send voice notes, photos or typed messages; Groundwork assembles the report and sends back the PDF.

Send your first report from WhatsAppAll videos

Join a project

  1. 1Send join ABCDEF (your six-letter code) to the Groundwork WhatsApp number. The system asks for your name and role.
  2. 2Once you confirm your role, every report you send goes to that project automatically. Send project name to switch projects later.

Send a report

  1. 1Send a voice note describing today's work: headcount, progress, weather, and anything notable. You can also type, or send a mix of text, voice and photos in the same session.
  2. 2About five seconds after your last message, the bot sends a Generate report button. Tap it.
  3. 3A PDF arrives within about 25 seconds. The form type (Daily Site Report, Foreman log, HSE report, etc.) is chosen automatically based on your role.
  4. 4After the PDF, Groundwork may ask up to five clarifying questions: missing figures, an ambiguous area name, or an empty box in the form. Reply with the answers and tap Update to get a corrected version.
Try it in the browser. No WhatsApp number yet? Use /try to run the same pipeline in your browser and see a live report.

Fix a report

  1. 1Send any new message within two hours of a report. The bot offers Fix GW-0012 alongside Generate report.
  2. 2Tap Fix. Your new message is added to the previous session and a corrected revision is issued. Register items keep their original numbers.

Check open items

  1. 1Send open items to see the project register. The bot lists every open issue with its number and severity.
  2. 2Send close A-12 Repaired and signed off to close item A-0012 with a resolution note. The register updates immediately.

Switch language

  1. 1Send Arabic to get reports in Arabic. The form layout, field labels and AI output switch to Arabic, and your preference is saved.
  2. 2Send English to switch back.

Reading and editing reports

Every report is filed on the project it belongs to. You can view the original, issue a revision, and export to PDF.

Reading and editing reportsAll videos

Find a report

  1. 1In the workspace, go to Reports. Use the date filter and the search box to find the right report.
  2. 2Click the report reference (e.g. GW-0042) to open it. The report page shows the full PDF alongside the figures the AI extracted from the original voice note or text.

Issue a revision

  1. 1On the report page, scroll to Issue a revision. Type what changed (or paste a corrected note).
  2. 2Click Regenerate. A revised PDF is issued with the same reference and a version number (GW-0042 v2). Register items added in earlier versions keep their numbers.

Download a PDF

  1. 1On any report page, click Download PDF. The file opens in a new tab; use your browser to save it.
  2. 2The report page URL is permanent and sharable. Anyone with the link can view the report without signing in.

Open items register

Every snag, safety observation, failed inspection, delay, and incident raised in a report gets a register number (A-0001) and stays open until someone closes it. The register is the single source of truth for what still needs attention on each project.

Using the open items registerAll videos

View the register

  1. 1In the workspace, click Open items. You see every item across all your projects, filterable by status, severity, type, and project.
  2. 2Click a project name to go to that project's register, which is scoped to that project alone and links to the reports that raised each item.

Close an item

  1. 1On the register, click the row to expand it. Click Close.
  2. 2Enter a resolution note and confirm. The item moves to closed status with the date and note recorded.
  3. 3Closed items stay on the register. Use the status filter to show only open items in day-to-day use.

Set severity and owner

  1. 1Expand a register item and use the Severity and Owner dropdowns to update them. Changes save immediately.
  2. 2Severity levels: Low, Medium, High, Critical. High and Critical items appear highlighted on the project overview.

Export to CSV

  1. 1On the project page, click Export then Register CSV. The file opens in Excel or Google Sheets.
  2. 2The export includes item reference, type, description, status, severity, owner, date raised, and resolution note. Text is UTF-8 with BOM so Arabic columns display correctly in Excel.

Site diary and weather

The site diary shows the last 14 days on a project: each day's reports, peak headcount, weather, and items raised. It is the starting point for the weekly report.

Reading the diary

  1. 1On the project page, the Site diary section shows a 14-day timeline. Each day shows the headcount bar, a weather badge, and links to that day's reports.
  2. 2Days with no reports show a gap. Days with high or critical register items are highlighted.
Weather. If a report does not state the weather, Groundwork fetches the day's conditions from Open-Meteo using the project location. Fetched weather is marked "(Open-Meteo)" on the report.

Weekly progress report

The weekly report compiles the week's daily reports into a single progress summary: diary, figures, the full open register, and up to eight photos. Every figure in it is cross-checked against the daily reports it comes from.

Generating the weekly reportAll videos

Generate the weekly report

  1. 1On the project page, go to the Weekly report tab. Choose the week you want.
  2. 2Click Generate. The report takes 30 to 60 seconds: the AI reads every daily report from that week and consolidates them.
  3. 3The PDF arrives with a diary table, week totals, the open register as of that Friday, and photos selected from the week's reports.
  4. 4Download it, share the link, or generate a revised version after adding more daily reports to the week.

Team and workspace settings

Manage who can see and edit your workspace, move field contacts between projects, and add or remove dashboard logins.

Team and workspace settingsAll videos

Add a project

  1. 1On the workspace overview, click New project. Enter the name, location, and optional contract details.
  2. 2The project page immediately shows a join code and a WhatsApp link. Send the link to the team on that project.

Move a field contact

  1. 1In the workspace, go to Team. Find the contact under Field staff.
  2. 2Click Move to project and choose the destination project. The contact's next report will be filed under the new project.

Add a dashboard login

  1. 1In Team, scroll to Dashboard logins. Click Invite, enter the person's email and a temporary password.
  2. 2They sign in at /login and can see all reports and the register for the company they belong to. Owners can remove logins at any time.

Close a project

  1. 1On the project page, scroll to Project settings. Click Close project.
  2. 2Closed projects are read-only: reports, the register and the diary are all still accessible, but no new reports can be filed.

Frequently asked questions

  • Does field staff need to install anything?

    No. They interact entirely through WhatsApp. No app, no login, no browser required.

  • How many report forms does Groundwork support?

    Eleven: Daily Site Report, Foreman's Daily Log, Project Status Report, HSE Report, QA/QC Inspection Report, Site Visit Report, Quantity Progress Note, Incident Report, Snag List, Delay Notice, and Weekly Progress Report.

  • Can reports be in Arabic?

    Yes. Field staff can send in English or Arabic, mixed freely, and get reports back in either language. Send the WhatsApp command "Arabic" to switch a contact's default language.

  • How accurate are the extracted figures?

    Every figure the AI reads from a voice note or photo is checked against the original message before the report is issued. Figures that do not match clearly are flagged for review in a "Check before issuing" section.

  • Can I edit a report after it is sent?

    Yes. Send a new message within two hours of a report and tap Fix, or use the "Issue a revision" form in the dashboard. Revised PDFs carry a version number. Register items added in earlier versions keep their numbers.

  • What happens if the AI is unavailable?

    The pipeline falls back to Groq's free models automatically. Reports are still generated, usually within about 40 seconds instead of 25.

  • How do I get a WhatsApp number for my company?

    You need a Meta Business account with a registered WhatsApp Business phone number. Contact us to set this up for your workspace. During a trial, you can use the /try console in the browser.

  • How do I cancel or change plan?

    Contact us via the email address in your workspace settings. Plan changes take effect at the end of the current billing period.