{"id":24989075,"url":"https://github.com/engineervix/zed-shipping","last_synced_at":"2025-10-14T07:03:06.897Z","repository":{"id":174240301,"uuid":"651940990","full_name":"engineervix/zed-shipping","owner":"engineervix","description":"A shipping cost calculator for online purchases destined for Zambia","archived":false,"fork":false,"pushed_at":"2023-12-15T05:43:15.000Z","size":1021,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-04T12:14:26.708Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://zedshipping.pages.dev","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/engineervix.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2023-06-10T15:07:34.000Z","updated_at":"2023-06-11T05:45:22.000Z","dependencies_parsed_at":null,"dependency_job_id":"8ce3c6f8-3996-472b-b10f-49180d114d06","html_url":"https://github.com/engineervix/zed-shipping","commit_stats":null,"previous_names":["engineervix/zed-shipping"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engineervix%2Fzed-shipping","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engineervix%2Fzed-shipping/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engineervix%2Fzed-shipping/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engineervix%2Fzed-shipping/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/engineervix","download_url":"https://codeload.github.com/engineervix/zed-shipping/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246180898,"owners_count":20736459,"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":[],"created_at":"2025-02-04T12:14:36.112Z","updated_at":"2025-10-14T07:03:06.892Z","avatar_url":"https://github.com/engineervix.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Zed Shipping Calculator\n\n[![CI/CD](https://github.com/engineervix/zed-shipping/actions/workflows/main.yml/badge.svg)](https://github.com/engineervix/zed-shipping/actions/workflows/main.yml)\n\n[![Node v22](https://img.shields.io/badge/Node-v22-teal.svg)](https://nodejs.org/en/blog/release/v22.0.0)\n[![code style: prettier](https://img.shields.io/badge/code%20style-prettier-ff69b4.svg)](https://prettier.io/)\n\n[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)\n[![Conventional Changelog](https://img.shields.io/badge/changelog-conventional-brightgreen.svg)](http://conventional-changelog.github.io)\n[![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg)](https://conventionalcommits.org)\n\nThis is a small tool that provides instant quotes for both domestic deliveries within Zambia and international shipments originating from the UK.\n\nBuilt with Vue 3 and Vite, UI powered by PrimeVue and Tailwind CSS.\n\n\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e\n\u003c!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e\n\n- [Features](#features)\n- [Tech Stack](#tech-stack)\n- [Data Source \u0026 Disclaimer](#data-source--disclaimer)\n- [Getting Started](#getting-started)\n  - [Prerequisites](#prerequisites)\n  - [Installation](#installation)\n- [Available Scripts](#available-scripts)\n\n\u003c!-- END doctoc generated TOC please keep comment here to allow auto update --\u003e\n\n## Features\n\n- **Dual Service Modes**: Easily switch between calculating costs for domestic deliveries and international (UK to Zambia) shipments.\n- **Volumetric Weight Calculation**: Automatically determines the billable weight by comparing the package's actual weight against its dimensional weight (`L x W x H / 6000`), ensuring accurate pricing.\n- **Zone-Based Domestic Pricing**: Implements One World's official pricing structure based on four distinct delivery zones (Lusaka, Line of Rail, Not Line of Rail, and Remote Areas).\n- **Detailed Cost Breakdowns**: For heavier packages (over 30kg for domestic, over 10kg for international), the app shows the base rate and additional costs.\n- **Dark \u0026 Light Mode**: Includes a user-friendly theme toggle that respects system preferences and saves the user's choice.\n- **Responsive Interface**: The UI is fully responsive, providing a seamless experience on both desktop and mobile devices.\n\n---\n\n## Tech Stack\n\n- **Framework**: Vue 3 (using Composition API and `\u003cscript setup\u003e`)\n- **Build Tool**: Vite\n- **UI Components**: PrimeVue 4 with the Aura theme\n- **Styling**: Tailwind CSS\n- **Utilities**: VueUse\n- **Code Quality**: ESLint and Prettier\n\n---\n\n## Data Source \u0026 Disclaimer\n\nPlease note that this is an **unofficial** calculator. The rates and zone data used in this application are based on the official One World Logistics Service Guide, effective **February 2024**.\n\nThis tool is intended for estimation and reference purposes only and is not affiliated with, or endorsed by, One World Logistics. For official quotes and services, please contact One World Logistics directly.\n\n---\n\n## Getting Started\n\nFollow these instructions to get a local copy of the project up and running.\n\n### Prerequisites\n\nYou need to have Node.js installed on your machine. The required version is specified in `package.json`.\n\n- **Node.js**: v20 or v22\n\n### Installation\n\n1.  Clone the repository to your local machine:\n    ```sh\n    git clone https://github.com/engineervix/zed-shipping.git\n    ```\n2.  Navigate into the project directory:\n    ```sh\n    cd zed-shipping\n    ```\n3.  Install the required NPM packages:\n    ```sh\n    npm install\n    ```\n\n---\n\n## Available Scripts\n\nThis project includes several scripts to help with development and production workflows:\n\n- **`npm run dev`**\n  - Starts the Vite development server with Hot-Module Replacement (HMR).\n\n- **`npm run build`**\n  - Compiles and minifies the application for production into the `dist` directory.\n\n- **`npm run preview`**\n  - Starts a local server to preview the production build from the `dist` directory.\n\n- **`npm run lint`**\n  - Lints the project files using ESLint to find and fix problems in your code.\n\n- **`npm run format`**\n  - Formats all source files in the `src/` directory using Prettier.\n\n## Credits\n\n- **og image**: https://unsplash.com/photos/brown-cardboard-boxes-on-gray-metal-rack-fCyfgmnTj4o\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fengineervix%2Fzed-shipping","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fengineervix%2Fzed-shipping","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fengineervix%2Fzed-shipping/lists"}