{"id":28101439,"url":"https://github.com/badhon495/nirapod","last_synced_at":"2026-05-18T14:37:35.856Z","repository":{"id":287661783,"uuid":"942185328","full_name":"badhon495/Nirapod","owner":"badhon495","description":"This is a full-stack web application built with Spring Boot for the backend and React for the frontend. The application includes features such as user authentication, file uploads, live location sharing and a live chat system. User can complain to the privileged person and the privileged person takes action on the complaint.","archived":false,"fork":false,"pushed_at":"2025-05-12T12:40:36.000Z","size":1078,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-12T13:44:49.948Z","etag":null,"topics":["cse471bracu","full","spring"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/badhon495.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-03T17:57:12.000Z","updated_at":"2025-05-09T14:55:31.000Z","dependencies_parsed_at":"2025-05-03T11:22:28.508Z","dependency_job_id":"3c9d21eb-750b-4e52-937b-8faadf847826","html_url":"https://github.com/badhon495/Nirapod","commit_stats":null,"previous_names":["badhon495/nirapod"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/badhon495%2FNirapod","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/badhon495%2FNirapod/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/badhon495%2FNirapod/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/badhon495%2FNirapod/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/badhon495","download_url":"https://codeload.github.com/badhon495/Nirapod/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254010705,"owners_count":21998991,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cse471bracu","full","spring"],"created_at":"2025-05-13T18:55:53.861Z","updated_at":"2025-10-28T19:06:42.556Z","avatar_url":"https://github.com/badhon495.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Nirapod\n\n![React](https://img.shields.io/badge/React-18+-61DAFB?style=flat-square\u0026logo=react)\n![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.2.5-6DB33F?style=flat-square\u0026logo=spring-boot)\n![PostgreSQL](https://img.shields.io/badge/PostgreSQL-13+-316192?style=flat-square\u0026logo=postgresql)\n![Maven](https://img.shields.io/badge/Maven-C71A36?style=flat-square\u0026logo=apache-maven)\n\nThis is a full-stack social media-inspired web application built to make communities safer and more connected. It empowers users to raise their voices by reporting local issues with descriptions, images, and live locations, while trusted authorities like police or fire services can respond and take action in real time. Complaints are shared in a familiar social feed where others can engage, support, and contribute. With live chat and location sharing, the platform fosters quick, transparent, and meaningful communication. Built with Spring Boot and React, it combines functionality with purpose—bridging the gap between citizens and responders when it matters most.\n\n\u003c/div\u003e\n\n## Project Structure\n\n- backend/  (Spring Boot backend)\n- frontend/ (React frontend)\n- db_creation.sh (Postgres DB setup)\n\n\n## Installation and Setup\n\nFirst, you need to clone the repository:\n\n```bash\ngit clone https://github.com/badhon495/Nirapod.git\ncd Nirapod\n```\n\n Install the required dependencies for both backend and frontend:\n```bash\nnpm install\n```   \n\n### Backend Setup (Spring Boot)\n\n1. Navigate to backend directory:\n   ```bash\n   cd backend\n   ```\n2. Copy the example environment file:\n   ```bash\n   cp src/main/resources/application.properties.example src/main/resources/application.properties\n   ```\n3. Edit `application.properties` to set your database, email, and Google credentials.\n4. Build the project (requires Java 17+ and Maven):\n   ```bash\n   mvn clean install\n   ```\n5. Run the backend:\n   ```bash\n   mvn spring-boot:run\n   ```\n6. The backend will run on `http://localhost:8080` by default.\n\n\n### Frontend Setup (React)\n\n1. Navigate to frontend directory:\n   ```bash\n   cd frontend\n   ```\n2. Copy the example environment file:\n   ```bash\n   cp .env.example .env\n   ```\n3. Edit the `.env` file to set your environment variables.\n4. Start the frontend (dependencies are already installed from root):\n   ```bash\n   npm start\n   ```\n5. The frontend will run on `http://localhost:3000` by default.\n\n\n### Live Chat Setup\n\n1. Navigate to backend directory:\n   ```bash\n   cd backend\n   ```\n2. Start the live chat server (ws package is already installed from root):\n   ```bash\n   node livechat-server.js\n   ```\n\n\n## Database Setup\n\n1. Ensure PostgreSQL is running and accessible with the credentials in `db_creation.sh`.\n2. Run the script:\n   ```bash\n   ./db_creation.sh\n   ```\n\n\n## Environment Configuration\n\nTo set up your environment variables and configuration files:\n\n1. **Backend application.properties**\n   - Copy the example file to create your actual config:\n     ```bash\n     cp backend/src/main/resources/application.properties.example backend/src/main/resources/application.properties\n     ```\n   - Edit `application.properties` and fill in your real database, email, and Google credentials.\n\n2. **Frontend .env file**\n   - Copy the example file to create your actual .env:\n     ```bash\n     cp frontend/.env.example frontend/.env\n     ```\n   - Edit `.env` and fill in your real secrets and environment variables.\n\n\n## Notes\n- Update backend `application.properties` for DB credentials if needed.\n- File uploads will be stored in the backend (see backend config for details).\n- For production, configure environment variables and secure credentials.\n- Get the Google APP ID and APP SECRET from the Google Developer Console and set them in the frontend `.env` file and backend `application.properties`.\n- For mail service, you can use any SMTP server. The example uses Gmail, but you can replace it with your own SMTP server details in the `application.properties` file.\n- Ensure you have the required permissions for file uploads and location sharing in your browser settings.\n\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003e⭐ Star this repo if you found it helpful!\u003c/p\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbadhon495%2Fnirapod","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbadhon495%2Fnirapod","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbadhon495%2Fnirapod/lists"}