A modern, open-source disaster relief coordination portal that empowers anyone to create, share, and contribute to disaster relief efforts, embodying the spirit of "The World is One Family." Built in 24 hours by Manan Goel as a B.Tech CSE project, Kutumbakam unites communities, volunteers, and resources for rapid, transparent, and effective humanitarian response.
Kutumbakam is a full-stack platform for disaster preparedness and response:
- Request and offer assistance after disasters
- Create and manage disaster-specific relief portals
- Access disaster preparedness resources and manuals
- Coordinate volunteers and resource allocation
- Dashboard for managing requests, offers, and updates
- Frontend: Next.js (App Router), TypeScript, Tailwind CSS
- Backend: Firebase (Auth, Firestore, Storage)
- UI: Shadcn UI components
- CI/CD & Hosting: Vercel
- User Authentication: Secure sign-up, login, and password recovery
- Request Assistance: Submit and track disaster-related help requests
- Create Portal: Launch custom portals for specific disaster events
- Dashboard: Manage and monitor all assistance requests and offers
- Volunteer Coordination: Register, manage, and match volunteers
- Resource Center: Access disaster preparedness guides and manuals
- Profile Management: Update user info and notification preferences
- Accessibility & Responsive Design: Optimized for all users and devices
- Node.js 18+ and npm
- Firebase account
-
Clone the repository
git clone https://github.com/manan0209/devkutumbakam.git cd devkutumbakam -
Install dependencies
npm install
-
Set up Firebase configuration
- Create a Firebase project at firebase.google.com
- Enable Authentication and Firestore
- Create a
.env.localfile in the root directory with your Firebase credentials:NEXT_PUBLIC_FIREBASE_API_KEY=your_api_key NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your_auth_domain NEXT_PUBLIC_FIREBASE_PROJECT_ID=your_project_id NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=your_storage_bucket NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=your_messaging_sender_id NEXT_PUBLIC_FIREBASE_APP_ID=your_app_id
-
Run the development server
npm run dev
Visit http://localhost:3000 to view the app.
-
Build for production
npm run build npm run start
devkutumbakam/
├── app/ # Next.js app directory (App Router)
│ ├── api/ # API routes (if any)
│ ├── ...routes # All main pages and feature routes
│ └── layout.tsx # Root layout and providers
├── components/ # Modular, reusable UI and feature components
├── lib/ # Firebase config, utilities, context
├── config/ # Site-wide configuration
├── public/ # Static assets and images
├── hooks/ # Custom React hooks
└── ... # Config, scripts, etc.
This application is deployed on Vercel. To deploy your own instance:
- Fork this repository
- Set up a Firebase project and obtain API credentials
- Deploy to Vercel and configure environment variables
We welcome contributions from everyone! Please read our CONTRIBUTING.md for guidelines.
- Fork the repository
- Create your feature branch (
git checkout -b feature/YourFeature) - Commit your changes (
git commit -m 'Add some feature') - Push to the branch (
git push origin feature/YourFeature) - Open a Pull Request
- Mobile app (PWA/native)
- Offline-first support for disaster zones
- Multi-language and localization
- Emergency services API integration
- AI-powered resource matching
- Advanced analytics for relief coordinators
This project is licensed under the MIT License.
Disaster Assistance Portal – Empowering communities in times of need.