Crews

Create crews, colour them, add or remove members, mark them active or inactive, and expand one to reach everything else that is true about it.

What it is

The Crews tab lists every crew with headline stats, its current project, its leader and a colour used across the schedule. Expanding a crew reveals its labour source, pay model, working week, members with field links and pay tiers, acceptance history, assigned projects and a danger zone. Internal crews sort above subcontractors.

Also called: set up a crew · add crew members · crew list · framing crew · crew colours

See it, piece by piece
01

A crew is a colour on the schedule and a filter on the board

Every crew carries a colour used across the Build Schedule, so who is where reads without opening anything. Filter the board to one crew, and a crew with time off booked carries the marker on its own chip. The question a builder asks the schedule most often is which of my crews is free, and this is that question answered in one glance.

Build Schedule — zoom, crews & time off
Build Schedule
Ctrl+scroll to zoom • Drag to pan • Click project to expand • Click stage to quick-edit • Double-click for details
Today
Find a project…DayWeekMonthQuarter6 MoYearAllCrew ACrew BCrew CArchivedDeletedTime OffHide Labels
The crew chips — Crew B carries the calendar marker for booked time off. The real screen, drawn from the product’s own design system. Sample data — no customer information appears here.
02

Time off books once and then enforces itself

Give a crew a date range and a reason — vacation, between projects, holiday, sick leave — and the crew flips inactive on the day and back at the end, with a notification each way. Nobody remembers to toggle a crew inactive on the Friday before, which is exactly how a job gets assigned to a crew that is away.

03

A crew can keep its own working week

Each crew inherits the company's working days unless somebody says this crew is different, and the picker shows what it is inheriting rather than making you go and look. Stage durations are counted in those days and non-working columns are shaded on the schedule. A concrete sub who pours Saturdays should not be planned Monday to Friday, and a job can override the crew where one build genuinely differs.

Working days on this job
Working days on this job
MonTueWedThuFriSatSun
Same as Crew A

Stage durations on this job are counted in these days. Shaded columns on the schedule are days nobody works.

Saturday on, and Same as Crew A unticked — this job differs from its crew. The real screen, drawn from the product’s own design system. Sample data — no customer information appears here.
04

The crew leader stays the leader after a refresh

Leadership is stored on the crew as a durable pointer, not as a role flag that a background sync overwrites on the next page load, and every change is written to the audit log with the outgoing and incoming names. Signing the acceptance contract, closing out a stage from the field and seeing Today's Crew all hang off that answer being stable.

05

One card holds everything true about a crew

Expand a crew and you reach its type — internal employees or subcontractor — its pay model, its working week, its members with their field links and pay tiers, its acceptance history and its assigned projects. A crew lead or a field worker sees only their own crew, and only their own crew's jobs, wherever crews appear in the app.

How it works
  1. 1crewStore is Supabase-backed with an in-memory cache, a localStorage snapshot for instant first paint, and a subscriber list so any mutation re-renders every consumer.
  2. 2loadCrews merges crew_members with crew_members_sync (Clerk-invited users) so every consumer sees the combined membership.
  3. 3Crew-scope guards hide every crew except their own from a crew lead or worker, and filter the project lists the same way.
  4. 4Deleting a crew cascades its members via the FK; deleting a member is a single row delete.
  5. 5Clicking an assigned project jumps to the project modal through the shell so Back returns with the crew still expanded.
Why we built it

Crew membership was assembled correctly on the team page and nowhere else, so a crew showing one member there showed zero on the contacts screen and in the schedule — the same crew, different answers, depending on which page had been opened first. Membership is merged in one place now, so every screen that names a crew names the same people. Crews are created, named, staffed and given a lead here, and each one jumps straight to the projects it is working.

The problem
  • Different screens disagreeing about who is on a crew.
  • Crew facts scattered across unrelated settings pages.
  • Crew-scoped users seeing other crews' work.
Sound familiar?
What you get
One card holds everything true about a crew.
Membership is consistent everywhere in the app.
Restricted users only ever see their own crew.
What's inside
Crew leader that sticks
Leadership is stored on the crew as a durable pointer rather than as a role flag that a background sync overwrites on the next page load.
Which days this crew works
A crew can carry its own working week, inherited from the company default unless somebody says this crew is different, and stage durations are counted in those days.
Scheduled crew time off
Book a date range when a crew is unavailable with a reason, and the crew flips inactive and back automatically with a notification each way.
Internal crews and subcontractor crews
A crew is either internal employees tracked in-platform or an external subcontractor tracked through a magic-link portal, and the choice drives what gets captured.
Turn a contractor contact into a tracked crew
A Contractor contact can be given labour tracking in one step, which creates and links an external crew so they get the portal, a pay model and job costing.
Building Plans access per member
A per-member toggle on the crew card controlling who can link or unlink SmartBuild jobs on a project, which is what makes construction drawings downloadable.

See it on your own jobs

Twenty minutes, your numbers, no slide deck. We’ll build one of your real buildings in front of you and send you the estimate link at the end — yours to keep either way.

or keep browsing features →