{"id":29704664,"url":"https://github.com/devanshsingh2004/logistiq","last_synced_at":"2025-07-23T14:38:52.348Z","repository":{"id":304401150,"uuid":"1018687309","full_name":"devanshsingh2004/LogistiQ","owner":"devanshsingh2004","description":"Bidding \u0026 Transporter Management Platform","archived":false,"fork":false,"pushed_at":"2025-07-12T20:11:26.000Z","size":319,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-12T22:11:15.514Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/devanshsingh2004.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-07-12T20:07:29.000Z","updated_at":"2025-07-12T20:12:52.000Z","dependencies_parsed_at":"2025-07-12T22:22:45.661Z","dependency_job_id":null,"html_url":"https://github.com/devanshsingh2004/LogistiQ","commit_stats":null,"previous_names":["devanshsingh2004/logistiq"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/devanshsingh2004/LogistiQ","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devanshsingh2004%2FLogistiQ","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devanshsingh2004%2FLogistiQ/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devanshsingh2004%2FLogistiQ/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devanshsingh2004%2FLogistiQ/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devanshsingh2004","download_url":"https://codeload.github.com/devanshsingh2004/LogistiQ/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devanshsingh2004%2FLogistiQ/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266695497,"owners_count":23969947,"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","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2025-07-23T14:38:49.482Z","updated_at":"2025-07-23T14:38:52.340Z","avatar_url":"https://github.com/devanshsingh2004.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LogistiQ\nBidding \u0026 Transporter Management Platform\n\n## Table of Contents\n- [Project Overview](#project-overview)  \n- [Tech Stack](#tech-stack)  \n- [Prerequisites](#prerequisites)  \n- [Getting Started](#getting-started)  \n  - [1. Clone the Repository](#1-clone-the-repository)  \n  - [2. Install Backend Dependencies](#2-install-backend-dependencies)  \n  - [3. Install Frontend Dependencies](#3-install-frontend-dependencies)  \n- [Environment Variables](#environment-variables)  \n- [Running the Application](#running-the-application)  \n  - [Run Backend](#run-backend)  \n  - [Run Frontend](#run-frontend)  \n\n---\n\n## Project Overview\nLogistiQ is a full-stack logistics and bidding platform designed to connect shippers with transporters in real time. The backend (Node.js/Express) handles authentication, bid management, deal creation, and communicates with a PostgreSQL database. The frontend (React + Ant Design) provides a responsive dashboard where users can post bids, view offers, and finalize deals. Firebase is used for authentication and real-time notifications.\n\n---\n\n## Tech Stack\n- **Backend**  \n  - Node.js (v14+ recommended)  \n  - Express.js  \n  - PostgreSQL  \n  - Sequelize (ORM) \n  - Firebase Admin SDK (for notifications/service account)  \n\n- **Frontend**  \n  - React (v17+)  \n  - Ant Design (UI component library)  \n  - Axios (HTTP client)  \n  - React Router v6  \n  - Firebase Web SDK  \n  - Moment.js (date/time handling)  \n\n---\n\n## Prerequisites\nBefore you begin, ensure you have the following installed on your system:\n\n1. **Git**  \n2. **Node.js \u0026 npm**  \n   - [Download Node.js](https://nodejs.org/) (v14 or above)  \n   - Verify by running:\n     ```bash\n     node -v\n     npm -v\n     ```\n3. **PostgreSQL**  \n   - [Download \u0026 install PostgreSQL](https://www.postgresql.org/download/) (v12 or above)  \n   - Ensure you can connect to a local or remote PostgreSQL instance.  \n   - Note down your database credentials (user, password, host, port).  \n4. **Firebase Project** (for service account credentials)  \n   - Create a Firebase project in the [Firebase Console](https://console.firebase.google.com/).  \n   - Generate a Service Account JSON file and note its path (for backend).  \n\n---\n\n## Getting Started\n\n### 1. Clone the Repository\n```bash\ngit clone https://github.com/singh-deep-anshu/LogistiQ.git\ncd LogistiQ\n```\n\n### 2. Install Backend Dependencies\nNavigate to the backend folder\n\n```\ncd backend\nnpm install\n```\n\n### 3. Install Frontend Dependencies\n```\ncd ../frontend\nnpm install\n```\n\n## Environment Variables\nCreate a file named .env in the backend directory with the following keys. Replace each placeholder with your real values:\n\n```\nPORT=5000\nDATABASE_URL=postgres://\u003cpostgres_user\u003e:\u003cpostgres_password\u003e@localhost:5432/\u003cdatabase_name\u003e\nFIREBASE_SERVICE_ACCOUNT=/path/to/your/firebase-service-account.json\n```\n\n## Running the Application\n\n### Run Backend\n\n```\nnpm run dev\n```\n OR, if no dev script is defined:\n```\nnpx nodemon app.js\n```\nnpx nodemon app.js will watch for changes and restart automatically.\n\nBy default, the backend listens on http://localhost:5000. \n\n### Run Frontend\n\n```\nnpm start\n```\nThis launches the React Development Server on http://localhost:3000.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevanshsingh2004%2Flogistiq","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevanshsingh2004%2Flogistiq","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevanshsingh2004%2Flogistiq/lists"}