Make the last details of a project easier to track, review and hand over. Closeframe keeps punch items, linked evidence and a manually curated document register together on one local computer, so one operator can work through open items, record completion, review and prepare a project handover without sending records to a hosted service.

WHAT IT DOES

Create multiple local project and site records for one business. Add and edit punch items with assignee text, trade, priority, due date and location; search the board and filter by status or priority. Move an item from open to ready for review with a completion note and, if enabled for that project, at least one attachment; close it with a review note. Reopen a closed item only with a reason. Closed records and their evidence are locked until reopened.

Attach PNG, JPEG or PDF files with extension and file-signature checks, a 5 MB per-file limit and a 50 MB total evidence limit. The manually maintained handover register can link existing attachments as manuals, warranties, as-builts or other documents. CSV import offers a preview and rejects the whole import if any row is invalid; CSV exports defensively prefix values that could be treated as spreadsheet formulas.

A project Handover ZIP contains a printable, escaped HTML record with relative attachment links, punch and document CSVs, actual included attachment bytes and a manifest. It is a portable project-level handover, not a restorable database backup. A separate full backup contains the SQLite database, actual evidence files and a size/SHA-256 manifest. Restore validates before replacement and makes a dated local safety copy; it replaces the current workspace rather than merging histories.

WHAT YOU RECEIVE

Editable Python application source and styles; 19 Python regression tests; setup, operations and API documentation; the commercial license; a sample punch-item CSV; a fictional handover ZIP and printable sample PDF; a four-page A4 buyer reference guide; and a read-only free tour. The normal first run starts empty. To explore working fictional records, start with a new, separate, empty data folder and explicitly run the documented --demo-data option; it refuses a non-empty folder. Sample records and sample files are fictional, not site evidence.

SETUP

Requires Python 3.10 or later and SQLite through Python. The app uses the Python standard library and has no external Python package, account, network service or installer requirement. Install Python yourself if needed, run the supplied Python source, then open the local address on that same computer. This is source code, not a native executable or installer. Tested on Ubuntu Linux with Python 3.12 and Chromium only; other operating systems, Python versions and browsers are unverified. App interface and supplied documentation are in English; listing translations do not localize the app.

LICENSE

The included perpetual commercial license is for one business and one designated operator running on one local computer at a time. Multiple local project/site records are allowed. Internal commercial use, private modification and reasonable private backup copies are permitted. You may share generated handover records, CSV exports and attachment copies when you have rights to those materials. You may not redistribute, resell, publish, sublicense, rent, lease or host the app, source or modified versions, or provide LAN, multiuser, cloud-sync or additional-business use.

IMPORTANT LIMITS

Closeframe is local-only: no accounts, teams, phone access, LAN/remote/cloud access, sync or automated messages. Responsive viewport checks do not make it a mobile app or provide mobile field capture. Assignee is text, not a real user account. There are no multi-party acceptance flows, legal signatures, certification or guarantee that a job is complete. Local history is not tamperproof audit evidence. Attachments are not malware-scanned; backups are not encrypted. Keep independent backups and protect files yourself. There is no support, maintenance, warranty or future-update commitment. Supplied as-is under the included license.

CHECKS

The recorded QA includes 19/19 Python regression tests, including real demo CLI startup and refusal on a non-empty demo folder; 54/54 Chromium buyer-workflow checks including backup, mutation and restore, and 1440/768/390-pixel viewport layout checks; 9/9 independent backend check groups; and 9/9 raw-body serialization checks. These are completed checks, not a guarantee that the software is bug-free.

Product screens are based on actual app captures; promotional framing is AI-assisted. Sample records are fictional.

Start with the included README and operations guide, and use the separate fictional tour or demo workspace before entering real records.