{"id":23193993,"url":"https://github.com/techysphinx/bharatkonnect","last_synced_at":"2026-05-09T15:10:41.077Z","repository":{"id":267076566,"uuid":"888476303","full_name":"techySPHINX/BharatKonnect","owner":"techySPHINX","description":"BharatKonnect is an innovative driver application designed specifically for the transportation and logistics industry. This app empowers drivers with real-time updates and a user-friendly interface, ensuring they stay informed throughout the entire delivery process.","archived":false,"fork":false,"pushed_at":"2024-12-24T08:01:00.000Z","size":5287,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-10T15:23:33.408Z","etag":null,"topics":["google-maps-api","postgressql","react-native-app","stripe","tailwindcss","twilio-api","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/techySPHINX.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}},"created_at":"2024-11-14T13:17:32.000Z","updated_at":"2024-12-24T08:01:04.000Z","dependencies_parsed_at":null,"dependency_job_id":"a9ddebf5-06dd-43af-93a4-b8a55bba9d1b","html_url":"https://github.com/techySPHINX/BharatKonnect","commit_stats":null,"previous_names":["techysphinx/drivelogix","techysphinx/bharatkonnect"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techySPHINX%2FBharatKonnect","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techySPHINX%2FBharatKonnect/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techySPHINX%2FBharatKonnect/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techySPHINX%2FBharatKonnect/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/techySPHINX","download_url":"https://codeload.github.com/techySPHINX/BharatKonnect/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247305897,"owners_count":20917202,"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":["google-maps-api","postgressql","react-native-app","stripe","tailwindcss","twilio-api","typescript"],"created_at":"2024-12-18T13:12:59.829Z","updated_at":"2026-05-09T15:10:41.013Z","avatar_url":"https://github.com/techySPHINX.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 **End-to-End Logistics Solution**\n\n***\"Driving Innovation, Delivering Excellence\"***\n\nAn advanced **transportation and logistics platform** developed to optimize fleet management, dynamic routing, geofencing, labor allocation, and more for the **Department of Posts**. Built with cutting-edge technologies like **React Native**, **FastAPI**, **PostgreSQL**, and **Google Maps**, this solution revolutionizes the logistics landscape.\n\n---\n\n## 🌟 **Features**\n\n### 1⃣ **Fleet Management**\n\n- Real-time vehicle tracking and utilization.\n- Live status updates of fleet movement and driver activity.\n\n### 2⃣ **Dynamic Routing**\n\n- AI-powered route optimization for efficient delivery.\n- Adaptive scheduling based on traffic and delays.\n\n### 3⃣ **Space \u0026 Labor Optimization**\n\n- Intelligent packing and resource allocation for cost reduction.\n- Real-time monitoring of available capacity.\n\n### 4⃣ **Geofencing Integration**\n\n- Location-based alerts for better shipment control.\n- Ensures compliance with safety protocols.\n\n### 5⃣ **Portal Management**\n\n- A central dashboard for logistics operations.\n- Visualizes data with charts, metrics, and real-time alerts.\n\n### 6⃣ **Multi-Role Authentication**\n\n- Secure authentication for drivers, admins, and stakeholders using **JWT** and **Clerk**.\n- OTP-based login via **Twilio**.\n\n### 7⃣ **Payment Integration**\n\n- Seamless payment processing using **Stripe API** for logistics services.\n\n---\n\n## 🛠️ **Tech Stack**\n\n### **Frontend**:\n\n- **React Native (Expo)**: For building a robust and responsive driver app.\n- **Typescript**: Strongly typed language for maintainable code.\n- **Google Maps API**: For location visualization and geofencing.\n\n### **Backend**:\n\n- **FastAPI**: High-performance backend API development.\n- **PostgreSQL**: Reliable and scalable database for logistics data.\n\n### **Additional Integrations**:\n\n- **Twilio**: OTP-based secure login and communication.\n- **Stripe**: Payment gateway for secure transactions.\n\n---\n\n## 🗂️ **Project Structure**\n\n### **Backend** (`FastAPI`):\n\n```\napp/\n├── routes/        # API routes\n├── db.py          # Database configuration\n├── models.py      # ORM models\n├── schemas.py     # Data validation schemas\n├── utils.py       # Helper utilities\n└── main.py        # Application entry point\n```\n\n### **Frontend** (`React Native with Expo`):\n\n```\nclient/\n├── src/\n│   ├── app/\n│   │   ├── tabs/        \n│   │   ├── +not-found.tsx\n│   │   └── _layout.tsx\n│   ├── components/       # Reusable UI components\n│   ├── constants/        # Configurations and constants\n│   ├── context/          # Context API definitions\n│   ├── hooks/            # Custom React hooks\n│   ├── lib/              # Library-specific logic\n│   ├── navigation/       # Navigation setup\n│   ├── services/         # API services\n│   └── utils/            # Helper utilities\n├── app.tsx               # App entry point\n├── app.json              # Expo configuration\n├── index.tsx             # Main index file\n├── tsconfig.json         # Typescript configuration\n└── package.json          # Dependency management\n```\n\n---\n\n## 🚀 **How to Run**\n\n### 1⃣ **Clone the Repository**\n\n```bash\ngit clone https://github.com/your-repo-link.git\ncd your-repo-link\n```\n\n### 2⃣ **Setup Backend**\n\n- Navigate to the `FastAPI` backend folder.\n- Create a `.env` file with your environment variables (e.g., database URL, Twilio keys).\n- Install dependencies:\n  ```bash\n  pip install -r requirements.txt\n  ```\n- Run the server:\n  ```bash\n  uvicorn main:app --reload\n  ```\n\n### 3⃣ **Setup Frontend**\n\n- Navigate to the `React Native` frontend folder.\n- Install dependencies:\n  ```bash\n  npm install\n  ```\n- Start the development server:\n  ```bash\n  npm start\n  ```\n\n---\n\n## 🔙 **Key Screens in BharatKonnect**\n\n---\n\n### 🛃️ **GeoFence Management Page**  \n📍 **GeoFence Screen**  \n- Manage and update geofence areas for warehouses.  \n- Ensure drivers pass through required geofences for better routing from source to destination.  \n\n---\n\n### 📊 **Admin Dashboard Page**  \n📋 **Dashboard Screen**  \n- Get real-time notifications for fleet management.  \n- Generate **MIS Reports** and monitor **Driver Performance** efficiently.  \n\n---\n\n### 🏠 **Home/Explore Page**  \n🗺️ **Live Geofencing Map**  \n- Visualize fleet movement and coverage areas.  \n- Optimize routes based on space utilization and time constraints.  \n\n📦 **Shipping Dashboard**  \n- Monitor **Total Tonnage**, **Remaining Capacity**, and **Expected Loads** for ongoing shipments.  \n\n---\n\n### 🚛 **Trips Page**  \n📜 **Current and Past Trips**  \n- View details of current trips, next halts, and previous trips.  \n\n🛑 **Status Screen**  \n- Update trip statuses such as:  \n  - **✅ Delivered**, **⏳ Delayed**, **📍 In-Route**, or **🚫 Unavailable**.\n\n---\n\n### 🔔 **Monitoring \u0026 Alerts**  \n⚠️ **Real-Time Notifications**  \n- Get alerts for unexpected stops or delays.  \n- Understand the reasons for delays via **Flash Notifications** and detailed insights.  \n\n\n## 🏆 **Achievements**\n\n- **Smart India Hackathon 2024** – **Runners-Up** under **PS 1753** by the Ministry of Communications.\n- **Highly praised by industry experts** for innovation and execution.\n\n---\n\n***\"This project isn’t just code—it’s a testament to our passion for innovation and problem-solving.\"***\n\n**#ReactNative #FastAPI #PostgreSQL #LogisticsSolutions #Innovation #Stripe #Twilio #GoogleMaps #Typescript #HackathonProject**\n\n\u003cdiv align=\"center\"\u003e\n### 𝚂𝚑𝚘𝚠 𝚜𝚘𝚖𝚎 ❤️ 𝚋𝚢 𝚜𝚝𝚊𝚛𝚛𝚒𝚗𝚐 this 𝚛𝚎𝚙𝚘𝚜𝚒𝚝𝚘𝚛y!\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechysphinx%2Fbharatkonnect","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftechysphinx%2Fbharatkonnect","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechysphinx%2Fbharatkonnect/lists"}