{"id":25477339,"url":"https://github.com/riazulljannat/parcel-logic-client","last_synced_at":"2026-04-09T17:03:01.550Z","repository":{"id":275924463,"uuid":"920995721","full_name":"RiazullJannat/Parcel-Logic-client","owner":"RiazullJannat","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-05T09:45:28.000Z","size":2768,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-05T10:33:45.368Z","etag":null,"topics":["daisyui","expressjs","firebase","github","github-config","jwt-authentication","mongodb","nodejs","reactjs","shadcn","stripe","tailwind"],"latest_commit_sha":null,"homepage":"https://parcel-logic.web.app/","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/RiazullJannat.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":"2025-01-23T06:23:12.000Z","updated_at":"2025-02-05T09:45:31.000Z","dependencies_parsed_at":"2025-02-05T10:43:52.375Z","dependency_job_id":null,"html_url":"https://github.com/RiazullJannat/Parcel-Logic-client","commit_stats":null,"previous_names":["riazulljannat/parcel-logic-client"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RiazullJannat%2FParcel-Logic-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RiazullJannat%2FParcel-Logic-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RiazullJannat%2FParcel-Logic-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RiazullJannat%2FParcel-Logic-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RiazullJannat","download_url":"https://codeload.github.com/RiazullJannat/Parcel-Logic-client/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239482145,"owners_count":19646176,"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":["daisyui","expressjs","firebase","github","github-config","jwt-authentication","mongodb","nodejs","reactjs","shadcn","stripe","tailwind"],"created_at":"2025-02-18T13:39:50.837Z","updated_at":"2025-11-06T03:30:32.765Z","avatar_url":"https://github.com/RiazullJannat.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Parcel Logic\n\n![Parcel Logic Application Screenshot](/src/assets/parcelLogic.png)\n\u003c!-- \u003cimage src=\"./src/assets/parcelLogic.png\" alt=\"Parcel Logic Application Screenshot\"/\u003e --\u003e\n\n**Delivering Your World, One Parcel at a Time.**\n\nParcel Logic is a web application that simplifies parcel deliveries by providing a seamless and efficient user experience. With real-time tracking, interactive dashboards, and secure payment integration, it’s the ultimate solution for modern parcel management.\n\n---\n\n## Table of Contents\n\n1. [Introduction](#introduction)\n2. [Features](#features)\n3. [Technologies Used](#technologies-used)\n4. [Installation](#installation)\n   - [Requirements](#requirements)\n   - [Steps to Install](#steps-to-install)\n5. [Configuration](#configuration)\n6. [Usage](#usage)\n7. [Environment Variables](#environment-variables)\n8. [Contributors](#contributors)\n\n---\n\n## Introduction\n\nParcel Logic is built to bridge the gap between delivery services and end-users by offering:\n\n- Real-time parcel tracking\n- Integration with secure payment gateways like Stripe\n- Geolocation services for delivery tracking\n- Notifications for status updates\n\nWhether you are a business managing multiple shipments or an individual sending a parcel, Parcel Logic ensures a hassle-free experience.\n\n---\n\n## Features\n\n- **Interactive Dashboard**: A user-friendly interface to manage parcels and view notifications.\n- **Stripe Payment Integration**: Secure and easy payment processing.\n- **Real-Time Tracking**: Monitor parcel status with live updates.\n- **Map Integration**: Visualize delivery routes using Leaflet.\n- **Custom Alerts**: Notifications for important updates using SweetAlert2.\n- **Data Insights**: Graphical representations powered by ApexCharts.\n- **Responsive Design**: Tailored for both desktop and mobile platforms.\n\n---\n\n## Technologies Used\n\n### Frontend\n- **React**: Core library for building the interface.\n- **React Router DOM**: Enables smooth navigation.\n- **TailwindCSS**: Ensures a responsive and modern design.\n- **React Hook Form**: Simplifies form validation and state management.\n\n### Backend \u0026 APIs\n- **Firebase**: Authentication, database, and cloud storage.\n- **Stripe**: Secure payment handling.\n- **Leaflet**: Map visualization for parcel tracking.\n\n### Libraries \u0026 Tools\n- **Axios**: Manages HTTP requests.\n- **ApexCharts**: Data visualization.\n- **Lottie React**: Adds animations for enhanced user interaction.\n- **SweetAlert2**: Modern alert and modal library.\n\n---\n\n## Installation\n\n### Requirements\n\nBefore you begin, ensure you have the following installed:\n\n- **Node.js** (v16 or higher): [Download Node.js](https://nodejs.org/)\n- **npm** or **yarn**: Comes with Node.js\n- **Git**: [Download Git](https://git-scm.com/)\n- A code editor like [VS Code](https://code.visualstudio.com/)\n\n### Steps to Install\n\nFollow these steps to install and run Parcel Logic locally:\n\n1. **Clone the Repository**  \n   Open your terminal and run:\n   ```bash\n   git clone https://github.com/yourusername/parcel-logic.git\n   ```\n   Navigate into the project directory:\n   ```bash\n   cd parcel-logic\n   ```\n\n2. **Install Dependencies**  \n   Run the following command to install all required packages:\n   ```bash\n   npm install\n   ```\n   \u003e _Alternatively, use `yarn install` if you prefer Yarn._\n\n3. **Configure Environment Variables**  \n   Create a `.env` file in the project root directory and add the necessary environment variables. See [Configuration](#configuration) for details.\n\n4. **Start the Development Server**  \n   Start the development server by running:\n   ```bash\n   npm run dev\n   ```\n   Once the server is running, open your browser and visit:\n   ```\n   http://localhost:3000\n   ```\n\n5. **Build for Production** (Optional)  \n   If you need to build the application for production, use:\n   ```bash\n   npm run build\n   ```\n\n---\n\n## Configuration\n\nBefore running the application, set up the `.env` file in the project root directory with your configuration:\n\n```env\nVITE_apiKey=your-firebase-api-key\nVITE_authDomain=your-firebase-auth-domain\nVITE_projectId=your-firebase-project-id\nVITE_storageBucket=your-firebase-storage-bucket\nVITE_messagingSenderId=your-firebase-messaging-sender-id\nVITE_appId=your-firebase-app-id\nVITE_image_bb_api=your-image-upload-api-key\nVITE_STRIPE_PK=your-stripe-public-key\n```\n\nReplace the placeholders with your actual API keys and credentials.\n\n---\n\n## Usage\n\n1. Open the home page to explore the dashboard and features.\n2. Use the search bar to find parcels by their tracking ID.\n3. Access the map to track parcel delivery routes in real time.\n4. Make payments securely using Stripe.\n5. Receive notifications about parcel status changes.\n\n---\n\n## Environment Variables\n\nThis application requires the following environment variables to function correctly:\n\n- `VITE_apiKey`: Firebase API Key\n- `VITE_authDomain`: Firebase Auth Domain\n- `VITE_projectId`: Firebase Project ID\n- `VITE_storageBucket`: Firebase Storage Bucket\n- `VITE_messagingSenderId`: Firebase Messaging Sender ID\n- `VITE_appId`: Firebase App ID\n- `VITE_image_bb_api`: API key for the image hosting service\n- `VITE_STRIPE_PK`: Stripe public key for payment processing\n\n---\n\n## Contributors\n\n- **[Riazull Jannat](https://github.com/RiazullJannat)** - Developer and maintainer of the project.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Friazulljannat%2Fparcel-logic-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Friazulljannat%2Fparcel-logic-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Friazulljannat%2Fparcel-logic-client/lists"}