Transport Work Sheet (TWS) Management: Complete Operations Guide
The TWS module helps your teams organize and execute daily transport-related tasks with precision. It centralizes logistics, manpower, goods, and scheduling data into a single, actionable sheet.
Whether you are on a desktop workstation or a mobile device in the field, every feature is optimized for speed, clarity, and one-tap execution.
TWS Creation
The creation form is structured into collapsible cards for focused editing.
Form Sections
- Document Info — TWS number (unique), date of creation, reference numbers
- Customer Details — Name, phone, email, full address
- Location Info — Pickup ("From") and delivery ("To") addresses, floor numbers, landmarks
- Shipment Details — Goods list, quantity, type, declared value, packaging needs
- Manpower Assignment — Packers, helpers, loaders, supervisors
- Vehicle Info — Vehicle type, registration number, driver name, contact
- Additional Notes — Special instructions, reminders, required tools
Your company branding — letterhead, logo, and standard terms — is automatically applied upon TWS generation.
Manpower Assignment
Assign and track team members directly within the TWS for clear role distribution and accountability.
Assignable Roles
- Supervisor — Oversees the entire operation and signs off on completion
- Packers — Responsible for wrapping and boxing items safely
- Loaders — Handle heavy lifting and loading into the vehicle
- Helpers — Assist packers and loaders with miscellaneous tasks
- Driver — Operates the vehicle and confirms route details
Tip: Assign multiple people to the same role (e.g., 3 packers, 2 loaders). Each assignment records a timestamp for payroll and audit tracking.
Dashboard Statistics
Four stat cards sit above the list, updating automatically as you add, delete, or modify TWS forms.
Total TWS
All-time count
Assigned
Manpower assigned
Pending
Awaiting assignment
Completed
Finished jobs
Each card features a distinct color accent and an icon for at-a-glance recognition.
Search & Filtering
Use the search bar above the list to filter TWS forms in real time.
- Searchable Fields: Customer name, phone, date, location, vehicle number, assigned team members, and custom metadata.
- Real-Time Results: Client-side filtering with zero server delay. Result count updates instantly.
- Clear Search: Click the × button or press Escape to reset.
- Status Filter: Refine by assigned/unassigned tasks or completed/in-progress jobs.
Note: Search operates on the already-fetched dataset. Scroll to the bottom to trigger infinite scroll and load older records before searching.
TWS List View
TWS forms are displayed in a high-density table on desktop and collapsible cards on mobile.
Desktop Table Columns
- # — Serial number
- TWS Details — TWS number + creation date (green Latest badge on newest)
- Customer Details — Name, avatar initial, clickable phone link
- Route — Pickup city (green) → Delivery city (red)
- Vehicle — Vehicle type and registration number
- Manpower — Count of assigned team members
- Actions — Three-dot dropdown menu
Records sort by TWS number descending (newest first). Infinite scroll loads 10 records initially, then auto-fetches the next batch as you scroll.
View TWS PDF
Opens the generated PDF in a new browser tab for quick verification.
- Click the three-dot menu on any TWS row.
- Select View TWS.
- The PDF opens in a new tab with your company branding and full work sheet details.
Note: The PDF is generated server-side on demand. It is cached locally for 3 minutes. A duplicate-guard ref prevents double-clicks from opening multiple tabs.
Download / Save PDF
Saves the TWS PDF to your device with a standardized filename.
- Click the three-dot menu on any TWS row.
- Select Save PDF.
- The file downloads as
tws-{number}.pdf.
Tip:On mobile, if the download does not start automatically, check your browser's download manager or notification shade.
Edit TWS
Opens the TWS form pre-filled with existing data for quick corrections.
- Click the three-dot menu on any TWS row.
- Select Edit.
- The form opens with all data restored: customer info, shipment details, manpower, vehicle, and notes.
- Make changes and save. The PDF reflects updates immediately.
Note: The TWS number remains unchanged during an edit, maintaining link consistency for any PDFs already shared.
Delete TWS
Permanently removes a TWS from your records.
- Click the three-dot menu on any TWS row.
- Select Delete.
- A confirmation dialog appears with the specific TWS number. Click Delete to confirm.
Warning: Deletion is irreversible. The record and its PDF are removed immediately. Export a backup first if needed.
Create New TWS
Initiate a new Transport Work Sheet from two locations on the list page.
Entry Points
- Hero Button — At the top of the page next to Refresh.
- Floating Action Button (FAB) — Large teal circle with a plus icon, fixed to the bottom-right corner. Stays visible while scrolling.
Both buttons route to the creation form. A toast "Opening new TWS form..." confirms the action.
Refresh Data
Re-fetches the entire dataset from the server. Useful for multi-user synchronization.
- Full Reload: Clears local cache, shows skeleton loading state, and pulls the latest records.
- Search Preserved: Your active search query is not cleared.
- Toast Confirmation: "Refreshing data..." followed by "Loaded N TWS forms".
Mobile & Desktop Views
The TWS List adapts its layout based on screen width.
Desktop (md and above)
- Seven-column table with hover row highlighting.
- Dropdown menus with viewport-aware positioning.
- Fixed action columns for easy scanning.
Mobile (below md)
- Card layout with stacked information.
- Thumb-sized tap targets (minimum 44×44 pt).
- Tapping a phone number initiates a native call.
- Floating scroll-to-top arrow after 300px scroll.
Notifications & Feedback
BSTD uses non-blocking toast notifications in the bottom-right corner. Auto-dismiss after 3.5 seconds.
Success (Emerald)
TWS deleted
Error (Red)
Download failed
Info (Blue)
Opening PDF...
Multiple toasts stack vertically so rapid actions produce a readable queue rather than overlapping noise.
UX Tips & Shortcuts
Maximize efficiency with these built-in interaction patterns.
- Dropdown Auto-Close: Click outside, scroll, or resize to close orphaned menus.
- PDF Preloading: Hover over View for 200ms to trigger a silent fetch.
- Search Clear: Press Escape while focused to clear instantly.
- Phone Links: Tapping a number opens the dialer pre-filled on telephony-enabled devices.
- Color Language: Emerald = assigned/completed, Amber = pending, Cyan = finished, Blue = info.
Troubleshooting
Common issues and their resolutions.
PDF fails to open or download
Ensure popups are allowed from bstd.digital.thugo.in. Verify your company ID is saved in localStorage and your auth token has not expired. Retry after 30 seconds or contact support.
Search returns no results
The search covers only loaded records. Scroll to the bottom to trigger infinite scroll and load older data, then search again.
Share sheet does not appear on mobile
Native sharing requires HTTPS and a modern browser (Chrome 89+, Safari 13+). BSTD falls back to clipboard copy or direct download if unavailable.
Dashboard stats seem incorrect
Click Refresh to synchronize all records. Stats are computed from the currently loaded dataset.
Duplicate PDF tabs open
The duplicate-guard ref should block double-clicks. If multiple tabs still open, wait 2 seconds between clicks, or use Download instead of View.