rodneydelacruz/barangayos

BarangayOS is a web application built for barangays, which are the smallest local government unit in the Philippines. It replaces paper records, spreadsheets, and expensive proprietary software with a free, digital system for running day-to-day barangay operations. A key design goal is that it keeps working even when internet access is unreliable, since many barangay offices deal with intermittent connectivity. The system covers several areas of local government work. It manages resident and household records, including tags for special categories like voters, senior citizens, and program beneficiaries. It handles the request and release of official documents, and tracks blotter records, which are formal logs of complaints and incidents, through hearings and resolution. It also covers governance tasks like scheduling meetings and tracking agenda items, plus a visitor check-in log and an audit trail of system activity. A separate finance module tracks government budgets, fund sources with their legal spending rules, revenue collection, and the disbursement of funds, each with its own audit trail for accountability. Different staff members get different access levels, ranging from full admin control down to read-only viewing, and permissions are enforced on the server rather than just hidden in the interface. Technically, the frontend is built with React, TypeScript, and Tailwind CSS, while the backend uses PocketBase, a lightweight system that bundles a database and an API server together. Offline support is handled by queuing changes locally and syncing them once a connection returns. It can be installed as an app on a desktop or phone, and it is deployed using Docker containers, with an option to expose it securely over the internet through Cloudflare Tunnel. It is released under the MIT license.