Foundation

Files & Attachments

Construction projects generate a constant stream of documents: site photos, subcontractor quotes, inspection reports, material specs, and signed change orders. Baulit gives you two places to store these files — the project-level Files tab and individual task attachments — so everything stays organized and accessible from the field or the office.

Supported File Formats

Supported Formats JPG PNG HEIC PDF DOC DOCX XLS XLSX Max File Size: 25 MB Storage by Tier Free 500 MB Pro 10 GB Enterprise 100 GB
Category Formats Notes
Images JPG, PNG, HEIC HEIC files from iPhones are supported with a fallback download link if the browser cannot render them natively.
Documents PDF Viewable inline. PDF invoices can be processed by AI Invoice Extraction.
Office Word (.doc, .docx), Excel (.xls, .xlsx) Download to view in their native applications.

The maximum file size per upload is 25 MB. If you need to attach a file larger than that, consider compressing it or splitting it into multiple uploads.

Automatic Image Compression

When you upload a JPG or PNG image, Baulit automatically compresses it on the client side before sending it to the server. Images are scaled down to a maximum dimension of 1600 pixels and saved at JPEG 0.8 quality. This keeps your storage usage manageable without sacrificing the detail you need for site documentation.

Compression happens entirely in your browser — the original file on your device is never modified. The compressed version is what gets stored in your project.

Tip: Even with automatic compression, a high-volume photo workflow can consume storage quickly. Keep an eye on your usage in Settings under the Billing tab.

Uploading Files

Project-Level Files Tab

The Files tab in your project view is the central file repository for the entire project. Use it for documents that apply to the project as a whole: permits, contracts, insurance certificates, architectural drawings, and general site photos.

Open your project and click the Files tab.
Click "Upload" or drag files directly into the upload area.
Select one or more files. You can upload multiple files at once.
Wait for the upload to complete. A progress indicator shows the status. Once finished, your files appear in the file list.

Task-Level Attachments

You can also attach files directly to individual tasks. This is ideal for documents tied to specific work items: a framing inspection report attached to the "Frame Second Floor" task, or a cabinet shop drawing attached to "Install Kitchen Cabinets."

Open a task by clicking it in the task list to enter edit mode.
Scroll to the Attachments section within the task edit panel.
Click "Attach File" and select the file from your device.

Task-level attachments appear both on the task itself and in the project-level Files tab, so you never lose track of where a file lives.

Approval Photos

When a contractor requests approval for a task, they can attach photos showing the completed work. These approval photos give Admins and Managers visual confirmation before signing off, reducing the need for in-person inspections on routine items.

Approval photos are uploaded through the contractor's task view when they change a task status to request approval. The photos are then visible to the Admin or Manager reviewing the approval request.

Viewing Files

Lightbox Viewer

Clicking an image file opens the lightbox viewer — a full-screen overlay that displays the image at full resolution. Use the left and right arrows to navigate between images in the same project without closing the viewer.

For HEIC files (common on iPhones), the lightbox attempts to render the image natively. If your browser does not support HEIC, Baulit shows a download link so you can open the file on your device instead.

Document Files

PDF files open in an inline viewer. Word and Excel files download directly to your device for viewing in their native applications.

Deleting Files

To delete a file, hover over it in the file list and click the delete icon. Baulit uses a two-step confirmation to prevent accidental deletion. Only Admins and Managers can delete files.

Important: Deleted files are permanently removed from storage. There is no trash or recycle bin. If you are unsure, download the file before deleting it.

Storage Limits

Your total file storage is determined by your subscription tier:

Tier Storage Limit
Free 500 MB
Pro 10 GB
Enterprise 100 GB

Storage usage is shared across all projects in your account. You can check your current usage in Settings under the Billing tab. If you approach your limit, consider removing files you no longer need or upgrading your plan.

AI Invoice Extraction

PDF attachments can be processed by Baulit's AI to automatically extract invoice line items and populate cost entries. Upload a subcontractor invoice or material receipt as a PDF, then use the Invoice Extraction feature to pull amounts, descriptions, and vendor information directly into your budget.

Requires AI: Invoice extraction is an AI feature available on Pro and Enterprise plans with an Anthropic API key configured. See BYOK Setup.

Security

All files are stored in Supabase Storage with row-level security. Only members of a project can upload to or delete from that project's storage bucket. Files are publicly readable via their URL, which allows easy sharing when needed, but the URLs are not guessable — they contain unique identifiers that prevent unauthorized browsing.