Skip to content

MRdulaenterprise/Barangay

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Barangay

An offline-first iOS application designed for Philippine barangays (communities) to facilitate local commerce, community communication, and emergency response.

Features

🏪 Microbusiness Marketplace

  • Create and manage local businesses
  • List products with photos, descriptions, and pricing
  • Set availability schedules (days, times, date ranges)
  • Map view to locate businesses
  • Search and filter products

💬 Community Chat

  • Peer-to-peer messaging within the same barangay
  • Real-time chat via Bluetooth/WiFi
  • Local network discovery
  • Message history stored locally

🚨 Emergency Alert System

  • Quick emergency capture (Fire, Typhoon, Crime, Other)
  • GPS location auto-capture
  • Photo attachments
  • Multi-channel sharing:
    • Export via SMS/Email/Messaging apps
    • Peer-to-peer sharing to nearby devices
    • Local network broadcast

Requirements

  • iOS 17.0+
  • Xcode 15.0+
  • Swift 5.9+

Installation

  1. Clone the repository:
git clone https://github.com/MRdulaenterprise/Barangay.git
cd Barangay/Barangay
  1. Open Barangay.xcodeproj in Xcode

  2. Build and run on a simulator or device

Permissions

The app requires the following permissions:

  • Location - To assign users to their barangay and for emergency alerts
  • Camera - To capture photos for products and emergencies
  • Photo Library - To select images
  • Local Network - For peer-to-peer chat and emergency sharing
  • Bluetooth - For device-to-device communication

Architecture

  • UI Framework: SwiftUI
  • Data Persistence: SwiftData (local storage)
  • Location Services: CoreLocation
  • Networking: MultipeerConnectivity, Network framework
  • Maps: MapKit

Project Structure

Barangay/
├── Models/          # SwiftData models
├── Views/           # SwiftUI views
│   ├── Authentication/
│   ├── Marketplace/
│   ├── Chat/
│   ├── Emergency/
│   └── Main/
├── Services/        # Business logic services
└── Utilities/
└── Utilities/         # Helper extensions and constants

Contributing

See developer.md for development guidelines.

License

Copyright © 2025 MRdulaenterprise. All rights reserved.

Support

For issues and feature requests, please open an issue on GitHub.

About

Local Barangay app

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages