KOODAL · கூடல்
One platform where any community reports, verifies and resolves its issues, in the open.
🌐 Live: ungakoodal.vercel.app · 💻 Source: github.com/triozcompany/koodal · 🎬 Videos, demo & MVPs
Built by TEAM TRIOZ for Build with AI: Code for Communities
💡 What is Koodal?
▶ Watch the 24-second product video · also in the repo: public/videos/koodal-product.mp4
One open loop for every community's issues. Koodal is a multi-tenant platform where any organization (a city corporation, an apartment community, a university or an institution) gets its own space to report, verify, fix and confirm local issues.
| |
|---|
| 🗣 Members report and support | Report in your own language by photo, text or voice note through the Koodal app. Neighbours support and verify, so the most important issues rise to the top. |
| 🛠 The team decides and fixes | Staff use the Koodal Console to accept or reject cases, assign the right team, track deadlines and post proof of the fix. |
| ✅ The community confirms | A case closes only when the people who reported it agree it's fixed. Otherwise it reopens. |
What makes it different
- Built-in AI (Gemini): turns voice notes in Tamil, Hindi and Tanglish into structured reports, merges duplicates into one case, and suggests category, severity and team. Staff always make the final decision.
- One product for every organization: wording, categories, teams and joining rules adapt to a government, an apartment, a campus or an institution. One account works across all of them, with instant switching.
- Trust built in: a public case timeline, community verification and closure only on members' confirmation.
- Built for India: 12 Indian languages, UPI AutoPay and GST invoicing.
Impact: people get a voice and see what happens to their reports. Organizations get fewer duplicates, clear priorities and data on which problems keep coming back.
Koodal started life as CivicPulse, a civic issue app for Tamil Nadu, and is growing into a platform for every kind of community. See Built vs roadmap for what is live today.
📖 View the pitch deck in the app, or download the PDF (also in the repo: public/docs/Koodal_Platform_Pitch_Deck.pdf).
📒 Koodal's report card
| At a glance | |
|---|
| 🗣 12 | Indian languages |
| 🎁 14 days | free trial, no card needed |
| 💸 from ₹999 | per month, members never pay |
| 🎯 80% | community support opens an official case |
| Subject | What Koodal does | Remark |
|---|
| 📸 Reporting | Photo, text or voice note, in your own language | Takes a minute. Excuses not accepted. |
| 👥 Verification | Neighbours support and add evidence; enough support opens an official case | Plays well with others. |
| 🛠 Fixing | Staff accept, assign the right team, track deadlines and post proof | Always shows their work. |
| ✅ Trust | A public timeline; a case closes only when members confirm, and reopens if not | Never marks its own homework. |
| 🧩 Duplicates | The same problem filed ten times becomes one case with ten voices | Hates repeating itself. |
| 🔁 One account | Switch between your city, apartment and campus in a tap | Gets around. |
| 🤝 Fair pricing | Organizations subscribe, members never pay | Everyone's favourite. |
🔁 The loop
The full flow diagram is in Architecture below.
- Report: a photo, in the member's own language (the deck targets 12 Indian languages).
- AI suggests: category, summary, severity and the department it goes to.
- AI detects: similar nearby issues are flagged so duplicates are merged, not re-filed.
- Community supports: neighbours upvote and add evidence. Crossing the verification threshold (80%) opens an official case.
- Team acts: pending approval → assigned → in progress, with SLA breaches shown on the public case timeline.
- Members confirm: before/after proof is posted and neighbours vote Fixed or Not yet. A rejected fix reopens the case.
🧰 What Koodal is built with
| |
|---|
| 🖥 Apps | Next.js and TypeScript on Vercel: the installable PWA for members and the web Console for teams |
| 🔥 Firebase | Auth, Firestore (org-scoped data), Storage for photos and proof, push notifications |
| ✨ Gemini | Multilingual voice-to-report and case triage (category, severity, team), with staff making every decision |
| 🗺 Google Maps | Location, pins and nearby issues |
🏗 Architecture
Diagrams from the pitch deck.
1 · Complete report-to-resolution flow
2 · Platform features by role
3 · Technical architecture
🔗 Live routes
🧩 Product model
- Members report, support and verify issues. Members never pay.
- Teams (staff, admins, owner) review cases, assign work and post proof of the fix, with role-based access.
- Organizations subscribe by type: Government, Apartment or community, University or campus, Institution.
- Platform admin sees every tenant, its plan and its health; every action is audit-logged.
Plans and pricing are in Business model & growth below.
📈 Business model & growth
Organizations subscribe. Members never pay. Priced by community size, at about ₹2–10 per member a month. Every plan starts with a 14-day free trial.
| Plan | Price | Limits | Who it's for |
|---|
| Starter | ₹999 / month | 100 members · 2 staff | Small apartments, clubs |
| Community | ₹2,499 / month | 500 members · 5 staff | Gated communities, schools |
| Institution | ₹6,999 / month | 3,000 members · 15 staff | Colleges, hospitals, offices |
| Civic | Custom / year | Unlimited · SSO · open data | Cities and large campuses |
3-year growth plan
| Year 1 | Year 2 | Year 3 |
|---|
| Annual recurring revenue | ₹30 L | ₹1 Cr | ₹2.7 Cr |
| Organizations | 73 | 271 | 735 |
| Footprint | 2 city pilots | 6 cities | 15 cities |
These are targets, not results.
How it grows
- Upgrades as communities grow: plans are sized by members, so revenue grows with each org.
- Members bring the next org: one account across communities keeps acquisition cheap.
- Add-ons: WhatsApp and IVR reporting, SMS alerts, open-data exports.
- Civic contracts anchor revenue: yearly city deals, averaging about ₹7.8 L each.
The platform-admin figures in the deck (8 paying organizations, ₹2.32 L MRR) come from demo/sample data, not real customers.
Built vs roadmap
| ✅ Built in this repo | 🗺 Roadmap (shown in the deck) |
|---|
| Citizen app: nearby map and list, feed, search, cases, report flow, duplicate handling, profile, settings | Team/government workflow screens on live data |
| Firestore persistence, email/password auth | Multi-tenant organizations, billing, platform admin |
| Voice / WhatsApp intake, 12-language UI, policymaker hotspot analytics |
Koodal is a multi-tenant platform where any organization (city corporation, apartment, university or institution) gets its own space to report, verify, fix and confirm local issues.
Members report problems by photo, text or voice in 12 Indian languages via the Koodal app. Neighbours support and verify reports so urgent issues rise. Staff use the Koodal Console to accept, assign and track cases against deadlines, then post proof of the fix. A case closes only when the community confirms it; otherwise it reopens.
Gemini AI turns Tamil/Hindi voice notes into structured reports, merges duplicates and suggests category, severity and team; staff always make the final decision. One account works across many organizations, and the app adapts its wording, categories and teams to each.
Organizations subscribe monthly (from ₹999) after a 14-day free trial; members never pay.
Built with Next.js, Firebase, Gemini and Google Maps by Team TRIOZ.
👥 Team TRIOZ
Student: Koodal · Class: Communities of India · Class teacher: everyone who reports an issue
Getting started
npm install
cp .env.example .env.local # then fill in real values, see below
You'll also need a Firebase Admin service account for local development — see Environment & secrets.
npm run dev
Open http://localhost:3000.
To (re)seed sample Firestore data:
npx tsx scripts/seed-koodal.ts
Environment & secrets
Nothing secret is committed to this repo. Copy .env.example to .env.local and fill in:
| Variable | Used for | Get it from |
|---|
GEMINI_API_KEY | AI report analysis (lib/domain/analyze.ts) | https://aistudio.google.com/apikey |
FIREBASE_SERVICE_ACCOUNT_JSON | Server-side Firestore writes (deploy-time alternative to a local key file) | Firebase Console → Project Settings → Service Accounts |
For local development, lib/firebase/admin.ts prefers a JSON key file over the env var:
secret/<project-id>-firebase-adminsdk-*.json
Download this from Firebase Console → Project Settings → Service Accounts → Generate new private key, and drop it in secret/. That whole folder is gitignored except secret/service-account.example.json, which documents the expected shape — copy the real file in beside it, don't overwrite it.
For deployment (Vercel or similar), you generally can't ship that file — set FIREBASE_SERVICE_ACCOUNT_JSON as a platform environment variable instead, pasting the entire service-account JSON as a single-line string. If neither the file nor the env var is present, admin.ts falls back to gcloud auth application-default login (ADC), which only works for local development.
The Firebase client (web) config in lib/firebase/client.ts is not secret — Firebase web API keys are safe to expose publicly; access is enforced by Firestore security rules, not by hiding that key. It's already committed as literal values; only change it if you're pointing this app at a different Firebase project.
Project structure
app/(marketing)/ — the public site: landing /, /get-started and the pitch deck viewer /pitch with PDF download (public/docs/).app/(citizen)/ — the citizen-facing app (Next.js App Router), one route folder per screen (feeds/, search/, cases/, issues/[issueId]/, profile/, settings/, etc.), each typically split into a mobile *Screen.tsx and a desktop Desktop*.tsx.lib/domain/ — pure domain logic and types shared across screens (stages, filters, scoring, dedup, etc.), no framework or I/O dependencies.lib/firebase/ — Firestore client SDK (client.ts) and Admin SDK (admin.ts) setup.server/actions/ — Next.js Server Actions that perform the actual Firestore writes.app/tokens.css — design tokens (colors, type, spacing) imported by app/globals.css.scripts/seed-koodal.ts — seeds sample issues/cases into Firestore for local development and demos.
Scripts
| Command | Does |
|---|
npm run dev | Start the dev server (Turbopack) |
npm run build | Production build |
npm run start | Run a production build |
npm run test | Run the test suite (Vitest) |
