https://github.com/smmariquit/illumina
Illumina — Sparkfest 2025 hackathon project. A Flutter + Firebase + Google Cloud Vision app that maps urban danger zones in real time, helping citizens stay safe and guiding city planners toward SDG 11 & 16 (safer, human-centered cities).
https://github.com/smmariquit/illumina
civic-tech computer-vision dart firebase flutter google-cloud-vision google-maps hackathon philippines sdg-11 sdg-16 sparkfest sustainable-development urban-planning
Last synced: 24 days ago
JSON representation
Illumina — Sparkfest 2025 hackathon project. A Flutter + Firebase + Google Cloud Vision app that maps urban danger zones in real time, helping citizens stay safe and guiding city planners toward SDG 11 & 16 (safer, human-centered cities).
- Host: GitHub
- URL: https://github.com/smmariquit/illumina
- Owner: smmariquit
- Created: 2025-06-02T17:45:57.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-06-05T19:59:38.000Z (about 1 month ago)
- Last Synced: 2026-06-05T21:23:04.091Z (about 1 month ago)
- Topics: civic-tech, computer-vision, dart, firebase, flutter, google-cloud-vision, google-maps, hackathon, philippines, sdg-11, sdg-16, sparkfest, sustainable-development, urban-planning
- Language: JavaScript
- Homepage: https://project-illumina.netlify.app
- Size: 26.7 MB
- Stars: 1
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Illumina: Designing Cities for People
## Sparkfest 2025
**A computer vision-powered platform to light up our cities.**
Empowering SDG 11 & 16 through real-time mapping, hazard reporting, and community-driven safety insights.
---
## Tech Stack
- **Flutter** (cross-platform: Android, iOS, Web)
- **Firebase** (Firestore, Storage, Auth)
- **Google Cloud Vision API**
- **Google Maps Platform**
---
### Architecture
```mermaid
flowchart TB
flutter[Flutter UI]
material[Material Design]
widgets[Custom Widgets]
provider[Provider]
api[API Layer]
firebase[Firebase]
auth[Authentication]
firestore[Firestore]
storage[Storage]
gcp[Google Cloud Platform]
maps[Google Maps API]
vision[Cloud Vision API]
subgraph Frontend["Frontend"]
flutter
material
widgets
end
subgraph State["State & API Layer"]
provider
api
end
subgraph Backend["Backend"]
firebase
auth
firestore
storage
end
subgraph Cloud["Google Cloud Platform"]
gcp --> maps
gcp --> vision
end
flutter --> material
flutter --> widgets
flutter --> provider --> api --> firebase
firebase --> auth & firestore & storage
firebase --> gcp
Frontend --> State
State --> Backend
```
---
## Deployment
### 🌐 **Try the Web App**
[project-illumina.netlify.app](https://project-illumina.netlify.app)
*Just click and use!*
### 🖥️ **Run Locally (Flutter)**
1. Clone the repo and run:
```bash
flutter pub get
flutter run -d chrome # or -d android, -d ios
```
---
## About
Illumina is Phase 1 of the Design Cities for People Initiative (DCPI)—a civic tech project using computer vision and real-time data to make urban spaces safer and more accountable.
---
*Bigyan nating liwanag ang ating mga siyudad tungo sa makataong disenyo.*
## 📊 Current State of the Code
- **Tech Stack:** Static / Basic Scripts
- **Repository Size:** 273 tracked files
- **Latest Update:** `c399f2d chore: add stale issue and PR validators`
---
*☕ If you found this project useful, you can support my work at [kape.stimmie.dev](https://kape.stimmie.dev)!*