Schedule & Calendar

Schedule & Calendar

The Schedule page is your central hub for viewing all upcoming jobs across every connected company. Access it at /fl/{nodeId}/schedule from the sidebar navigation. It aggregates bookings from all Core Tenants into a single, unified timeline so you never double-book yourself.

View toggle

At the top of the page, a toggle lets you switch between two display modes:

• Calendar view — A traditional monthly grid showing jobs as colour-coded blocks. Best for getting a visual overview of how busy your month looks.
• List view — A chronological feed of individual jobs with full details. Best for reviewing specifics and taking action on pending bookings.

Filters

Both views share the same filter bar:

• Company dropdown — Filter bookings by a specific connected company, or select “All Companies” to see everything.
• Status dropdown — Show All, Confirmed, Pending, Completed, or Cancelled jobs. Maps directly to the status field on the FreelancerBooking model.
• Date range picker — Narrow results to a specific window. Useful when reviewing past work or planning weeks ahead.

Calendar view

The calendar displays a monthly grid with the following features:

• Each job appears as a colour-coded event block. Colours are assigned per company so you can instantly recognise which company a booking belongs to.
• Up to two events are shown per day cell. If there are more, a “+X more” indicator appears — click it to expand and see all jobs for that day.
• A legend beneath the calendar shows each company’s assigned colour.
• Use the Previous/Next month navigation arrows to move between months. You can also click the month heading to jump to a specific month.
• Multi-day bookings span across cells, giving a clear visual of longer engagements.

List view

The list view opens with a stats row at the top:

• Upcoming — Total number of future bookings.
• Confirmed — Jobs where status is confirmed and confirmed_at has been set.
• Pending — Jobs awaiting your response (status is pending).
• Estimated Earnings — Sum of total_amount across upcoming confirmed and pending bookings.

Below the stats, each job is displayed as a card with:

• Date badge — Month abbreviation and day number on the left side.
• Project name and role — The job_title and, where applicable, the linked project name.
• Company chip — Colour-coded chip showing which company sent the booking.
• Location — The location field, displayed with a map pin icon.
• Rate/day — The agreed_rate and rate_type (hourly or day rate).
• Start/end times — From start_time and end_time, shown in your local timezone.
• Status chip — Colour-coded: green for confirmed, amber for pending, grey for completed, red for cancelled.
• Confirm button — Appears on pending jobs, allowing you to accept directly from the list.

Job details drawer

Clicking any job opens a side drawer with full details:

• Job information — Company name, job_title, start_date to end_date, location with map coordinates (latitude, longitude), and the agreed_rate with rate_type.
• Special requirements — Any notes from the company stored in special_requirements and company_notes.
• Required skills — The required_skills array, shown as tag chips.
• Your notes — Editable freelancer_notes field for personal reminders.
• Action buttons — Depending on the booking status:
  • Pending: Confirm and Decline buttons.
  • Confirmed: Log Time button (opens the Time Clock with the project pre-selected).
  • Any cancellable status: Decline button.

Job statuses

Each booking moves through a defined workflow tracked by the status field on the FreelancerBooking model:

1. pending — The company has sent the booking request. Awaiting your response.
2. accepted — You have acknowledged the booking. The accepted_at timestamp is recorded.
3. confirmed — Final confirmation before work begins. The confirmed_at timestamp is recorded.
4. in_progress — Work has commenced (set automatically when you clock in).
5. completed — The job is finished. The completed_at timestamp is recorded.
6. cancelled — The booking was cancelled. The cancelled_at timestamp, cancelled_by, and optional cancellation_reason are recorded.
7. declined — You declined the booking. An optional reason is stored in freelancer_notes.

Confirming a job

When you tap Confirm on a pending booking, the system calls the confirm() method, which sets the status to confirmed and records the confirmed_at timestamp. The company is notified immediately. You cannot undo a confirmation — contact the company directly if you need to withdraw.

Declining a job

Tapping Decline opens a prompt where you can optionally provide a reason. The decline() method sets the status to declined and stores your reason in freelancer_notes. Declined bookings remain visible in your schedule history but are filtered out of the default view.

Booking reference

Every booking is assigned a unique reference in the format FLB-XXXXXXXX (eight uppercase alphanumeric characters), stored in the booking_reference field. This reference is generated automatically at creation and appears on all correspondence, invoices, and time entries linked to the job.

Calendar sync

Confirmed jobs can be synchronised to your personal calendar. Calendar sync is available on all tiers (FREE, LITE, and PRO) and supports:

• Google Calendar — Two-way sync via Google Calendar API.
• Microsoft Outlook — Sync via Microsoft Graph API.
• Apple iCloud — Sync via CalDAV protocol.

Only confirmed bookings are pushed to your external calendar. Pending and declined bookings are excluded to keep your personal schedule clean. Each synced event includes the job title, company name, location, and times.

Tips

• Check your schedule regularly — companies expect prompt responses to booking requests.
• Confirm jobs as soon as possible. The reminder_sent_count tracks how many reminders the company has sent, and too many unanswered reminders may affect your standing.
• Sync your schedule with your personal calendar to avoid conflicts with non-NexusRMS commitments.
• Use the Company filter to review workload for a specific client when planning your availability.