> For the complete documentation index, see [llms.txt](https://docs.shortcutco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shortcutco.com/readme/projects/crew-app-on-a-project.md).

# The crew's day on a project

What the crew sees on Today when they're on a project: the project day card, starting and stopping the phase, the checklist and materials, declaring progress, the end of the day, punch lists, and aski

When a team has a project day, it leads their **Today** screen in the [worker app](https://docs.shortcutco.com/readme/worker-app.md), above any route visits. Everything the office needs from the field happens on that card: the hours, the materials used, the photos, the progress, and the word that it's done.

The **team lead** (set per team under **Settings → Workspace → Teams**) does the declaring, the checklist, and the end of day. Other team members see the same card, with *Lena declares* and *Lena starts it when the team gets there* where the lead's buttons would be. Anyone on the team can take photos or ask for a change.

## The project day card

<figure><img src="https://2299783971-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOhi7KtJ4vY1pDKwWu5SV%2Fuploads%2Fgit-blob-2861e9a642f201bc8ced41746fca84f7df57e0e6%2Fprojects-today-card-phone.png?alt=media" alt="Today on a phone with a project day card: Install A · 2 on team, Day 5 of 5 · Patio &#x26; seat wall, the project name and address with Navigate, Today&#x27;s budget 7.3 h, Hours · measured 56 / 63.3 h used, Declared 0%, the Checklist and Photos tiles, and the Declare progress, Need a change, Start work and Rained out buttons, then the project manager and Tomorrow"><figcaption><p>The project day card: where to go, how much time there is today, and the buttons for the day.</p></figcaption></figure>

From the top:

* **The team chip** — *Install A · 2 on team* (or *Install A · lead Lena* for a member).
* **Day 5 of 5 · Patio & seat wall** — which day of the phase this is, and the phase. A punch-list visit reads **Punch-list visit · Steps & edging**; a change order's phase shows its number, *CO-1 · Patio drain*; a T\&M phase shows **T\&M**.
* **The project and address**, with **Navigate** for directions.
* **Today's budget** — the hours left on the phase spread over the days left, so *7.3 h* today. Once the team is on the clock it turns into **Back by hh:mm**: amber half an hour before, red when passed, *+1.5 h over* when the budget's gone. A T\&M phase has no budget; it reads **Billed by the hour**.
* **Hours · measured** — *56 / 63.3 h used* and what's left. Red with *+21.3 h over* once it's past the budget. If the office turned on **Show teams budgeted hours**, this is the reduced budget.
* **Declared** — the last declared progress and who declared it: *70% · Tue, by Pat*.
* **Checklist 0/5** and **Photos 0** tiles.
* The buttons: **Declare progress**, **Need a change**, **Start work** / **Stop work**, **Rained out**, and **End of day** once the team is on the clock.
* The **Project manager** with one tap to call, and the office's **Note for today** when there is one.
* **Tomorrow · Thu 29** — the next project day for this team, or **Next · Wed 4**.

Two project days on one team show as two cards. A route team with an install day in the afternoon sees its visits first and the project card after them.

## Start and stop the phase

Clocking in works the way it always does (see [Time Clock](https://docs.shortcutco.com/readme/time-clock-and-timesheets.md)). When the team's only work today is this one phase, the phase starts by itself at the first clock-in; the card says *Starts by itself when the team clocks in.* When the team has other work too, the lead taps **Start work** on arrival; the card says *Your team has other work today, so start it yourself when you get there.* Moving between two phases on one site is **Switch to \[phase]**.

The hours on the phase are the time the team is clocked in while the phase is running. **Stop work** pauses it (for a long break, or a run to the supply yard); clocking back in doesn't restart it, so tap **Start work** again. The first start moves the project to **In progress**.

## Checklist and materials

Tap **Checklist**. The sheet lists the phase's **Materials** (every price book item on the phase that's flagged for the checklist, in your price book order, with *Est. 42 tn* under each) and **Tasks** (the office's to-dos for the phase, with the note for the crew at the top). The lead types what was **Used so far** against each material and taps **Save used qty**; a quantity above the estimate turns red with *+n over*. **Add from price book** adds a material that wasn't on the estimate; the office sees it and it's billed at the price book price on a T\&M phase.

<figure><img src="https://2299783971-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOhi7KtJ4vY1pDKwWu5SV%2Fuploads%2Fgit-blob-a61f9775114caa51e7f9917cab254e1923de4a4c%2Fprojects-checklist-phone.png?alt=media" alt="The phase checklist on a phone: Backyard patio &#x26; seat wall · Day 5 of 5, Patio &#x26; seat wall, Materials with #53 base stone Est. 42 tn, Polymeric sand Est. 28 bag, Bedding sand, Retaining wall block and Holland paver 60 mm each with a Used so far box, Add from price book, Tasks, and Save used qty"><figcaption><p>The checklist: the materials on the phase with the estimated quantity, and what the crew has used so far.</p></figcaption></figure>

Quantities save on the phone without signal and sync when it's back; the banner reads **Saved on phone – will sync**, then **Synced**. Once the office has reviewed the phase, the checklist is read-only.

## Photos

Tap **Photos** to see today's photos or **Take a photo**. Photos go to the project's activity in the office, where the office can share them with the customer. Photos upload even on a day that's on hold.

## Declare progress

The lead taps **Declare progress**. The sheet shows the last declaration and the hours used, a bar to drag or **−** / **+** in 5 % steps, a **Note for \[the PM]**, and optional photos. Tap **Declare 60%**. Re-declaring the same day replaces the earlier number; the history stays on the project.

At **100%** the button reads **Declare done – send for review**: the phase moves to **Ready for review** and the project manager gets a push. Unsaved checklist quantities have to be saved first (**Save and declare**). A declaration lower than the last one is allowed; the PM gets a heads-up. On a T\&M phase there's no percentage: the lead taps **Mark done** instead, with a note of what was done, and the hours bill on the next invoice.

<figure><img src="https://2299783971-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOhi7KtJ4vY1pDKwWu5SV%2Fuploads%2Fgit-blob-005067a89ee2c135c33438c016958c052d04314a%2Fprojects-declare-phone.png?alt=media" alt="The Declare progress sheet on a phone: Patio &#x26; seat wall · Day 5 of 5, Not declared yet · 56 / 63.3 h used, a progress bar from 0 to 100 with 5% per tap, or drag, a Note for Pat box, optional Photos, and the Declare button"><figcaption><p>Declare progress in 5% steps, add a note or a photo, and at 100% send the phase for review.</p></figcaption></figure>

The office can declare for the team too, from the phase's **⋯ → Declare progress for team** on the project page; it's logged as *Pat for Install B* and the lead gets a push.

## End of day

When the team is on the clock, **End of day** opens the clock-out summary: **Team hours today** per person (live for anyone still on the clock), the **Total**, and the phase's hours against the budget (red when over). When it's over, pick a reason: **Site condition**, **Estimating miss**, **Team productivity**, **Weather**, or **Other**; the PM sees it in the review. Rows for **Declared**, **Photos**, and **Materials used** turn amber when something's missing and open the right sheet. A missing clock-in or clock-out shows **Fix times** first. **Clock out team** clocks everyone out and stops the phase.

A fixed-price phase left under 100 % at clock-out gets another day on the team's next working day with room, so tomorrow's card reads *Day 4 of 3*.

## Rained out

Tap **Rained out** and **Mark rained out**, with an optional **Note for the office**. Nothing on the schedule changes yet: the office sees the team pre-ticked in the **Rain day** window on Dispatch → Install and decides what moves. See [Holds, rain days, and moving days](https://docs.shortcutco.com/readme/projects/schedule-and-dispatch-install.md#holds-rain-days-and-moving-days).

## Need a change

Found roots across the trench, or the customer wants the bed a foot wider? Anyone on the team taps **Need a change**. Pick what kind (**Change**, **Materials**, or **Question**), describe it under **What did you find?** with photos, and answer **Can you keep working?** (**Keep working**, or **Stopped**, which puts the phase on hold and prompts a call to the PM). Add a **Rough extra** of team hours and any materials from the price book, quantities only. **Send** puts a draft change order on the project with your photos and pushes the project manager and the lead. The office prices it and sends it to the customer. See [Change orders](https://docs.shortcutco.com/readme/projects/change-orders.md#from-the-field).

<figure><img src="https://2299783971-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOhi7KtJ4vY1pDKwWu5SV%2Fuploads%2Fgit-blob-2b42a156e2abe16d8b806d71f60829c9c8b2ab6f%2Fprojects-need-change-phone.png?alt=media" alt="The Need a change sheet on a phone: Tell Pat what&#x27;s different on site. Pat prices it and sends it to Nate, the Change, Materials and Question choices, What did you find? with Add photo, Can you keep working? with Keep working and Stopped, Rough extra team hours, Add material from price book, and the note that it becomes a draft change order"><figcaption><p>Need a change: the crew describes what they found, and the office turns it into a change order.</p></figcaption></figure>

## Punch lists

When the office sends a phase back after the customer's walk-through, the card turns into a punch-list visit: an amber **Punch list · 2 open** banner with who sent it back and when the follow-up is, and the **Punch list** button in place of **Declare progress**. The sheet lists each item with the PM's before photo and note. For each one the lead taps **Add after photo** when it's fixed, or **Can't do it?** with a reason. **Mark punch list done** opens once every item has an after photo or a reason, and sends the phase back for review.

<figure><img src="https://2299783971-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOhi7KtJ4vY1pDKwWu5SV%2Fuploads%2Fgit-blob-8d0f0439a2cf27b9c7441c5071d720dd88ff71c1%2Fprojects-punch-list-phone.png?alt=media" alt="The punch list sheet on a phone: Front steps reset · Wed 28, Steps &#x26; edging, Punch list · 0 of 2 done, the PM&#x27;s note Two small things before we sign off, two items Re-set the rocking tread on the second step and Top up the edging gravel each with Add after photo and Can&#x27;t do it?, and Mark punch list done"><figcaption><p>A punch list from the office: each item needs an after photo, or a reason it can't be done.</p></figcaption></figure>

The office can add items while the team is out; the banner count updates and the lead gets a push. Hours on the follow-up visit count on the phase.

## Without signal

Starting and stopping the phase, declarations, checklist quantities, task ticks, photos, change requests, and **Rained out** all save on the phone and sync later. The card shows **Saved on phone – will sync**, then **Synced 2 changes**, or **No signal · 2 changes waiting**. A change that can't be applied when it syncs (the day was moved, someone else changed the same thing) shows in the app with **Retry** or **Discard**, and the office sees anything that needs a decision in the review as **Needs office review**.

<details>

<summary>Still stuck?</summary>

Email <hello@shortcutco.com> with the project name, the team, and a screenshot of the card.

</details>
