Colony-Care is a cross-platform mobile app that modernizes how residential communities โ housing societies, gated colonies, and apartments โ communicate and operate.
No more chaotic WhatsApp groups or missed paper notices. One app. One community. Zero friction.
Built with React Native + Expo, fully typed in TypeScript, and navigated via Expo Router's file-based routing.
| Module | Description |
|---|---|
| ๐ Login | Google OAuth + Email/Password login |
| ๐ Dashboard | Colony Health Score, weekly trends, quick actions |
| ๐ Complaints | Raise, filter & track complaints with Map View |
| ๐ค AI Categorization | Auto-categorize complaints by type & priority |
| ๐จ Emergency SOS | One-tap SOS for Fire, Medical, Security, Flood |
| ๐ฌ Community Feed | Trending posts, announcements & discussions |
| ๐ค Profile & Badges | Resident stats, earned badges, settings |
| ๐ท Staff Management | Register & manage colony workers (Admin only) |
| ๐ Admin Dashboard | Analytics, staff control & colony-wide insights |
๐ฑ Framework โ React Native + Expo (Managed Workflow)
๐งญ Routing โ Expo Router (File-based, like Next.js)
๐ท Language โ TypeScript (Strict mode)
๐จ Styling โ React Native StyleSheets
๐ฃ Icons โ @expo/vector-icons
Colony-Care/
โโโ app/
โ โโโ (tabs)/
โ โ โโโ index.tsx # ๐ Dashboard
โ โ โโโ complaints.tsx # ๐ Complaints
โ โ โโโ feed.tsx # ๐ฌ Community Feed
โ โ โโโ profile.tsx # ๐ค Profile
โ โโโ _layout.tsx # Root layout
โโโ components/ # Reusable UI components
โโโ constants/ # Colors, sizes
โโโ hooks/ # Custom hooks
โโโ types/ # TypeScript definitions
โโโ assets/
โโโ screenshots/ # ๐ธ App screenshots
Prerequisites: Node.js v18+, Expo CLI, Expo Go app on your phone.
# Clone & install git clone https://github.com/kshitijRM/Colony-Care.git cd Colony-Care npm install # Start dev server npx expo start
๐ฑ Scan the QR code with Expo Go โ you're live!
npx expo start --android # Android emulator npx expo start --ios # iOS simulator (macOS only) npx expo start --clear # Clear cache & restart
git checkout -b feat/your-feature # make changes git commit -m "feat: your message" git push origin feat/your-feature # Open a Pull Request ๐
Commit convention: feat: ยท fix: ยท docs: ยท style: ยท refactor: ยท chore:
๐ข New? Look for
good first issuelabels!
- Project scaffold + Expo Router
- Tab navigation + core screens
- Complaint system with AI categorization
- Emergency SOS screen
- Community Feed
- Admin & Staff Management
- Backend API integration
- Push notifications
- Visitor QR code generation
- Dark mode support
| Name | GitHub | |
|---|---|---|
| ๐ | Kshitij | @kshitijRM |
| ๐ | Vijay Purandare | @vijju9019 |
| ๐ค | Amith H P | @amith-hp |
The Debugger's ยท Cambridge Institute of Technology, Bangalore ๐ฎ๐ณ
Licensed under the MIT License โ see LICENSE for details.