abdouh071/ShippingDz

**ShippingDz** is the first comprehensive Node.js library dedicated to the Algerian e-commerce market. It allows Algerian developers and store owners to connect their websites directly to **26+ local shipping providers** (Yalidine, Ecotrack, ZR Express, and more) using a single, unified tool. # ShippingDz 🚚 — La solution ultime pour la livraison en Algérie **ShippingDz** is the first comprehensive Node.js library dedicated to the Algerian e-commerce market. It allows Algerian developers and store owners to connect their websites directly to **26+ local shipping providers** (Yalidine, Ecotrack, ZR Express, and more) using a single, unified tool. --- ### 🇩🇿 Pourquoi utiliser ShippingDz ? (Why use this?) Integrating shipping in Algeria used to be a headache. Every courier had a different API, and most didn't work well with modern JavaScript frameworks. **ShippingDz fixes this:** - **One Code for Everyone**: Stop writing custom code for every courier. Use one standard way to talk to Yalidine, Maystro, DHD, and 20+ others. - **Modern Tech Stack**: Built for Node.js, React, and Next.js. No more fighting with old PHP scripts if your site is modern. - **CORS Problem Solved**: By moving your shipping logic to the backend with this library, you never have to worry about browser CORS errors again. - **Save Months of Work**: We've already done the hard work of reading documentation and testing APIs. You just focus on selling. --- ### 🌟 Acknowledgement & Credits This project is a **JavaScript/Node.js port** of the excellent CourierDZ PHP package developed by **Piteur Studio**. We would like to thank **Nassim** and the **Piteur Studio** team for their hard work in mapping out the Algerian shipping ecosystem. This port aims to bring that same convenience to the modern JS ecosystem. --- ## Requirements - Node.js 18+ - ESM support (`"type": "module"` in your `package.json`) ## Installation ### Method 1: Official NPM Package you can install it simply with: ```bash npm install shippingdz ``` ### Method 2: Local / Manual (Pre-publication) If you are using the source code directly (unreleased): 1. **Download** the `ShippingDz` folder into your project's root. 2. **Install it locally** via npm: ```bash # Run this from your main project folder (where your …